@animus-ui/cli 0.1.18 → 0.1.20

package/README.md

@@ -36,8 +36,10 @@ animus print-config --root . --system ./src/ds.ts
 Configuration lives in `animus.config.{json,mjs,js,ts}` (probed in that
 order; `.ts` needs Node >= 23.6 native type stripping — older runtimes get
 a guided error naming the `.mjs`/`.json` remedy). Flags override file
-values; `--exclude` merges, and an explicit `exclude: []` in the config file
-means no user exclusions (the replaceable defaults are not restored).
+values. `--exclude` patterns join the config file's `exclude`, and together
+they replace the defaults (`dist`, `.test.`, `.spec.`); an explicit
+`exclude: []` in the config file means no user exclusions (the defaults are
+not restored). `node_modules`, `.next` and `.animus` are always excluded.
 `animus print-config` prints the fully resolved configuration as JSON on
 stdout with per-key provenance, including `extensions` and `staticCss`.
 

package/dist/config.d.ts

@@ -10,7 +10,7 @@ export interface CliFlags {
     config?: string;
     outDir?: string;
     strict?: boolean;
-    verbose?: boolean;
+    verbose?: boolean | 'trace';
     mode?: string;
     targets?: string;
     exclude?: string[];
@@ -45,6 +45,7 @@ export declare function projectResolvedConfig(config: ResolvedCliConfig): {
     targets: string | string[] | null;
     minify: boolean | null;
     prefix: string | null;
+    prefixContextualVars: boolean;
     layers: string[] | null;
     extensions: string[] | null;
     staticCss: StaticCssConfig | null;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAEhB,eAAe,EAChB,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,gBAAgB,YAC3B,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,CACV,CAAC;AAEX,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,aAAa,GAAG,YAAY,GAAG,KAAK,CAAC;AAE1E,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,KAAK,CAAC;IACd,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,aAAa,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC9C;AAgOD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,iBAAiB,CAAC,CAkI5B;AAED;kEACkE;AAClE,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EACzB,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB;IAE3D,MAAM;IACN,IAAI;IACJ,UAAU;IACV,MAAM;IACN,IAAI;IACJ,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,UAAU;IACV,SAAS;IACT,OAAO;IACP,UAAU;EAEb"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAEhB,eAAe,EAChB,MAAM,6BAA6B,CAAC;AAErC,eAAO,MAAM,gBAAgB,YAC3B,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,CACV,CAAC;AAEX,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,aAAa,GAAG,YAAY,GAAG,KAAK,CAAC;AAE1E,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,KAAK,CAAC;IACd,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,aAAa,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC9C;AAmOD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,QAAQ,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,iBAAiB,CAAC,CAmI5B;AAED;kEACkE;AAClE,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EACzB,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,iBAAiB;IAE3D,MAAM;IACN,IAAI;IACJ,UAAU;IACV,MAAM;IACN,IAAI;IACJ,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,oBAAoB;IACpB,MAAM;IACN,UAAU;IACV,SAAS;IACT,OAAO;IACP,UAAU;EAEb"}

package/dist/index.cjs

@@ -449,6 +449,7 @@ function parseLoadedCliConfig(raw) {
 			strict: isConfigBoolean(raw.strict) ? raw.strict : void 0,
 			verbose: isConfigBoolean(raw.verbose) || raw.verbose === "trace" ? raw.verbose : void 0,
 			prefix: isConfigString(raw.prefix) ? raw.prefix : void 0,
+			prefixContextualVars: isConfigBoolean(raw.prefixContextualVars) ? raw.prefixContextualVars : void 0,
 			targets: isConfigString(raw.targets) || isConfigStringArray(raw.targets) ? raw.targets : void 0,
 			minify: isConfigBoolean(raw.minify) ? raw.minify : void 0,
 			staticCss: configStaticCss(raw.staticCss),
@@ -539,6 +540,7 @@ async function resolveCliConfig(flags, cwd) {
 		strict: pick("strict", flags.strict),
 		verbose: pick("verbose", flags.verbose),
 		prefix: pick("prefix", void 0),
+		prefixContextualVars: pick("prefixContextualVars", void 0),
 		targets: pick("targets", flags.targets),
 		minify: pick("minify", void 0),
 		staticCss: pick("staticCss", void 0),
@@ -577,6 +579,7 @@ function projectResolvedConfig(config) {
 		targets: config.options.targets ?? null,
 		minify: config.options.minify ?? null,
 		prefix: config.options.prefix ?? null,
+		prefixContextualVars: config.options.prefixContextualVars ?? false,
 		layers: config.options.layers ?? null,
 		extensions: config.options.extensions ?? null,
 		staticCss: config.options.staticCss ?? null,
@@ -778,15 +781,21 @@ Options:
   --root <path>       Root every relative input resolves against
   --config <path>     Explicit config file (default: animus.config.* in root)
   --out-dir <path>    Artifact directory (default: <root>/.animus)
-  --exclude <glob>    Additional exclusion (repeatable; MERGES with defaults;
-                      an explicit exclude: [] in the config file means none)
+  --exclude <glob>    Exclusion (repeatable). With the config file's exclude,
+                      REPLACES the defaults (${_animus_ui_extract_pipeline.REPLACEABLE_DEFAULT_EXCLUDE.join(", ")});
+                      exclude: [] in the config file means none.
+                      ${_animus_ui_extract_pipeline.STRUCTURAL_EXCLUDE.join(", ")} are always excluded
   --mode <m>          'development' | 'production' (default: production)
   --targets <query>   Browserslist query for CSS lowering
   --strict            Fail on inputs that could not be read or resolved,
                       and on classified unsupported Animus declarations
   --fail-on-degraded  watch only: exit 3 instead of running with unwatched
                       roots (degradation is otherwise reported and tolerated)
-  --verbose           Verbose logging (stderr)
+  --verbose           Verbose logging (stderr): phase checkpoints,
+                      summaries and timing
+  --trace             The trace tier (config: verbose: 'trace'); the CLI
+                      has no per-item lines yet, so it logs what --verbose
+                      logs
   --print-config      Alias of the print-config command
   --help              This text
 
@@ -828,6 +837,7 @@ async function main(argv = process.argv.slice(2)) {
 				targets: { type: "string" },
 				strict: { type: "boolean" },
 				verbose: { type: "boolean" },
+				trace: { type: "boolean" },
 				"fail-on-degraded": { type: "boolean" },
 				"print-config": { type: "boolean" },
 				help: { type: "boolean" }
@@ -858,7 +868,7 @@ async function main(argv = process.argv.slice(2)) {
 		config: values.config,
 		outDir: values["out-dir"],
 		strict: values.strict,
-		verbose: values.verbose,
+		verbose: values.trace ? "trace" : values.verbose,
 		mode: values.mode,
 		targets: values.targets,
 		exclude: values.exclude

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;kDACkD;AAalD,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC;qEACqE;AACrE,eAAO,MAAM,YAAY,IAAI,CAAC;AAoD9B;sDACsD;AACtD,wBAAgB,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMzD;AAQD,wBAAsB,IAAI,CACxB,IAAI,GAAE,MAAM,EAA0B,GACrC,OAAO,CAAC,IAAI,CAAC,CA0Ff"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;kDACkD;AAiBlD,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC;qEACqE;AACrE,eAAO,MAAM,YAAY,IAAI,CAAC;AA0D9B;sDACsD;AACtD,wBAAgB,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMzD;AAQD,wBAAsB,IAAI,CACxB,IAAI,GAAE,MAAM,EAA0B,GACrC,OAAO,CAAC,IAAI,CAAC,CA2Ff"}

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { AnimusConfigError, assertKnownOptionKeys, assertNoRetiredEngineSelection, buildPathAliasesJson, contentHash, createExcludeMatcher, readTsconfigAliasPairs, resolveMode, runStructuralSelfCheck } from "@animus-ui/extract/pipeline";
+import { AnimusConfigError, REPLACEABLE_DEFAULT_EXCLUDE, STRUCTURAL_EXCLUDE, assertKnownOptionKeys, assertNoRetiredEngineSelection, buildPathAliasesJson, contentHash, createExcludeMatcher, readTsconfigAliasPairs, resolveMode, runStructuralSelfCheck } from "@animus-ui/extract/pipeline";
 import { parseArgs } from "node:util";
 import { ANIMUS_ARTIFACT_DIR, CLI_COMMIT_ARTIFACT, CLI_LOCK_ARTIFACT, ExtractionSession, MANIFEST_ARTIFACT, SESSION_ASSETS_DIR, STYLES_ARTIFACT, SYSTEM_PROPS_ARTIFACT, checkLockLiveness, collectSessionAssets, decodeCommitRecord, getAnalyzedHashes, getManifestJson, getSharedCss, getSharedSystemProps, holdDirectoryClaim, isLockHolderAlive, lockRecordBytes, readCliLockRecord, startTurbopackWatcher, verifyCommitRecord } from "@animus-ui/extract/session";
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, unlinkSync, writeFileSync } from "fs";
@@ -448,6 +448,7 @@ function parseLoadedCliConfig(raw) {
 			strict: isConfigBoolean(raw.strict) ? raw.strict : void 0,
 			verbose: isConfigBoolean(raw.verbose) || raw.verbose === "trace" ? raw.verbose : void 0,
 			prefix: isConfigString(raw.prefix) ? raw.prefix : void 0,
+			prefixContextualVars: isConfigBoolean(raw.prefixContextualVars) ? raw.prefixContextualVars : void 0,
 			targets: isConfigString(raw.targets) || isConfigStringArray(raw.targets) ? raw.targets : void 0,
 			minify: isConfigBoolean(raw.minify) ? raw.minify : void 0,
 			staticCss: configStaticCss(raw.staticCss),
@@ -538,6 +539,7 @@ async function resolveCliConfig(flags, cwd) {
 		strict: pick("strict", flags.strict),
 		verbose: pick("verbose", flags.verbose),
 		prefix: pick("prefix", void 0),
+		prefixContextualVars: pick("prefixContextualVars", void 0),
 		targets: pick("targets", flags.targets),
 		minify: pick("minify", void 0),
 		staticCss: pick("staticCss", void 0),
@@ -576,6 +578,7 @@ function projectResolvedConfig(config) {
 		targets: config.options.targets ?? null,
 		minify: config.options.minify ?? null,
 		prefix: config.options.prefix ?? null,
+		prefixContextualVars: config.options.prefixContextualVars ?? false,
 		layers: config.options.layers ?? null,
 		extensions: config.options.extensions ?? null,
 		staticCss: config.options.staticCss ?? null,
@@ -777,15 +780,21 @@ Options:
   --root <path>       Root every relative input resolves against
   --config <path>     Explicit config file (default: animus.config.* in root)
   --out-dir <path>    Artifact directory (default: <root>/.animus)
-  --exclude <glob>    Additional exclusion (repeatable; MERGES with defaults;
-                      an explicit exclude: [] in the config file means none)
+  --exclude <glob>    Exclusion (repeatable). With the config file's exclude,
+                      REPLACES the defaults (${REPLACEABLE_DEFAULT_EXCLUDE.join(", ")});
+                      exclude: [] in the config file means none.
+                      ${STRUCTURAL_EXCLUDE.join(", ")} are always excluded
   --mode <m>          'development' | 'production' (default: production)
   --targets <query>   Browserslist query for CSS lowering
   --strict            Fail on inputs that could not be read or resolved,
                       and on classified unsupported Animus declarations
   --fail-on-degraded  watch only: exit 3 instead of running with unwatched
                       roots (degradation is otherwise reported and tolerated)
-  --verbose           Verbose logging (stderr)
+  --verbose           Verbose logging (stderr): phase checkpoints,
+                      summaries and timing
+  --trace             The trace tier (config: verbose: 'trace'); the CLI
+                      has no per-item lines yet, so it logs what --verbose
+                      logs
   --print-config      Alias of the print-config command
   --help              This text
 
@@ -827,6 +836,7 @@ async function main(argv = process.argv.slice(2)) {
 				targets: { type: "string" },
 				strict: { type: "boolean" },
 				verbose: { type: "boolean" },
+				trace: { type: "boolean" },
 				"fail-on-degraded": { type: "boolean" },
 				"print-config": { type: "boolean" },
 				help: { type: "boolean" }
@@ -857,7 +867,7 @@ async function main(argv = process.argv.slice(2)) {
 		config: values.config,
 		outDir: values["out-dir"],
 		strict: values.strict,
-		verbose: values.verbose,
+		verbose: values.trace ? "trace" : values.verbose,
 		mode: values.mode,
 		targets: values.targets,
 		exclude: values.exclude

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/cli",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "Standalone Animus extraction CLI — one-shot builds and artifact emission for any build system",
   "keywords": [
     "animus",
@@ -41,7 +41,7 @@
     "compile": "tsc --noEmit"
   },
   "dependencies": {
-    "@animus-ui/extract": "0.1.18"
+    "@animus-ui/extract": "0.1.20"
   },
   "engines": {
     "node": ">=22.12.0"