Skip to content

Latest commit

 

History

History
59 lines (56 loc) · 4.99 KB

todo.md

File metadata and controls

59 lines (56 loc) · 4.99 KB

TODO

pre-version 0.10.0 todo list

  • create the "docs/improve-4" branch for fixing the remaining docs and tests in collections.ts.
  • add your "AWS Signature Version 4" computation algorithm to cryptoman.ts. for that, you will also have to create aliases for Crypto.subtle. but the tradeoff it has is that Crypto.subtle is only available in "https" (secure) website contexts, and standalone js runtimes (deno, cloudflare workers, node, bun, etc...)
  • add promiseman submodule that specializes in promise based utility functions.
  • migrate the following functions and objects to the timeman, alias, and promiseman submodules, as you see fit:
    • promiseTimeout, debounce, debounceAndShare, throttle, throttleAndTrail, THROTTLE_REJECT, TIMEOUT, ChainedPromiseQueue.
  • migrate data uri manipilation/parsing features in the image submodule to the pathman submodule.
  • consider migrating Map related data-structures inside of collections.ts to a new submodule map.ts (though I don't like the fact there already exists mapper.ts).
  • consider migrating memorize functions from lambda.ts to its own submodule memorize.ts.
  • add the on-the-fly typescript-serving local server task to /deno.json, once you have it implemented in @oazmi/build-tools.

pre-version 0.9.0 todo list

  • create the "docs/improve-1" branch for changes related to documentation and minification repair of builtin_aliases_deps.ts.
  • create the "docs/improve-2" branch for major improvements related to documentation repair/upgrade.
  • create the "docs/improve-3" branch for all changes related to documentation repair/upgrade.
  • rename the following submodules (and also take care of potential doc link breakdown when using !module_name):
    • builtin_aliases -> aliases
      • ended up deleting this submodule
    • builtin_aliases_deps -> alias
    • crypto -> cryptoman ? unsure about this one
    • path -> pathman
  • fix the doc examples so that they do not error when deno test --doc "./src/" is ran.
  • populate the doc examples with legitimate test cases using "jsr:@std/assert" for assertion.
  • fix the slice and splice (and maybe there are other methods as well) method issue with your custom subclasses of Array, Map, and Set, which result in the creation of a new subclass when these methods are called, instead of creating a classic Array, Map, or Set.
    • potential solution involves the creation of a utility function that does slice and splice on Array subclasses without invoking their slice or splice methods.
    • the correct solution involves setting the subclass's Symbol.species property to the base built-in type (Array, Map, etc...), so that the methods that create clones of the subclass create the equivalent base built-in type, instead of a new instance of our subclass.
  • put your DIY deno mascot somewhere in the repo's readme, and make sure that the svg is uploaded to jsr and npm
  • DUMB IDEA: make "megaman robot master" like ascii-art mascots for each of your submodule ending with a "man" (i.e. "cryptoman", "pathman", "stringman", etc...), and put them in your module-level comment.
  • in "pathman.ts", rename references to "unix" and "unix-style" with "posix". can't believe you swapped posix for unix facepalm.
  • in "pathman.ts", make all doc tests more readable by using single letter directory names.
  • in "binder.ts", give a doc comment to each exported binding function, just so that it'll raise your jsr score.
    • my doc comments were not parsed, unfortunately. I may have to try a different format to ensure that they get parsed. possible contenders are:
      • use the following style for each declaration:
      /** binding function for `class_proto.fnName1`. */
export const binderFnName1 = /*@__PURE__*/ bindMethodFactoryByName(class_proto, "fnName1")
/** binding function for `class_proto.fnName2`. */
export const binderFnName2 = /*@__PURE__*/ bindMethodFactoryByName(class_proto, "fnName2")
      • the removal of the /*@__PURE__*/ declaration may also be a solution (albeit non-negotiable)
      export const
	/** binding function for `class_proto.fnName1`. */
	binderFnName1 = bindMethodFactoryByName(class_proto, "fnName1"),
	/** binding function for `class_proto.fnName2`. */
	binderFnName2 = bindMethodFactoryByName(class_proto, "fnName2")
  • in "alias.ts" and "builtin_alias.ts", give a doc comment to each exported alias function, just so that it'll raise your jsr score.
  • port over your detectReadableStreamType function from @oazmi/build-tools/deps to this library.
  • erase the todo list from /src/deps.ts
  • in pathman, make uri_protocol_and_scheme_mapping exportable, so that the end user may add additional uri schemes of their liking.
  • add a description to each task in /deno.json.