Customize output directory

[connorjs]

Overview

As a user, I want to choose where to css-typed generates the files, so that it can fit my repository’s directory structure/conventions.

Notes

• [ ] Current location: alongside the source, required *.d.css.ts in the .gitignore (maybe call this colocatedFile?
• [ ] Alternative: generated/*.d.css.ts - still alongside, but grouped within a generated. Simplifies .gitignore with generated/ convention
  • This option would take an optional string name (defaults to generated)
  • Name TBD, but maybe colocatedDirectory or colocatedGeneratedDirectory
• [ ] Alternative 2: generated/**/*.d.css.ts - parallel structure in a root generated directory
  • Same optional string name as above
  • Name TBD, but maybe parallelStructure or parallelDirectory or rootGeneratedDirectory

[connorjs]

The plan is to release an --out-dir option (-o for short) that will change the root output directory. With the initial release, the directory structure will mirror the same file path (relative to cwd).

This means that it may include src in its structure. In the future, the tool could detect the root or take a root argument. Simply putting it under generated or artifacts/css-typed solves my primary .gitignore use case.

Using the option may require tweaking your tsconfig.json to properly find the generated files.