@animus-ui/extract 0.1.7 → 0.1.9

package/dist/source-identity.d.ts

@@ -0,0 +1,93 @@
+import path from 'node:path';
+/** Platform path API (`path` / `path.win32` / `path.posix`). Structural
+ *  local alias — the packed consumers' @types/node need not export
+ *  `PlatformPath` from 'node:path' (older versions don't, which fails
+ *  their declaration type-check against this file's emitted d.ts). */
+type PlatformPath = typeof path.win32;
+/**
+ * SourceId derivation authority + allowlist membership (openspec:
+ * external-source-watch-ingestion, design D1/D2/D5).
+ *
+ * One shared derivation produces the canonical source identity consumed by
+ * discovery, watch ingestion, ownership, deletion pruning, and diagnostics
+ * — raw event paths are lookup INPUTS only, so event spelling (symlink
+ * alias vs canonical, lexical vs realpath) can never fork identity.
+ *
+ * The containment and volume helpers are pure and path-API-injectable so
+ * Windows semantics are unit-testable via `path.win32` on any host; runtime
+ * callers use the ambient platform implementation.
+ */
+/**
+ * Structural containment: `target` is the root itself or a descendant of it,
+ * decided by `relative()` shape — never by string prefixing, so `/ui` can
+ * never claim `/ui-old`, and a cross-drive win32 target (whose relative()
+ * result is absolute) is never contained.
+ */
+export declare function isPathWithinRoot(root: string, target: string, pathApi?: PlatformPath): boolean;
+/**
+ * Cross-volume gate (design D5): two paths share a platform path root
+ * (win32 drive letter or UNC share; always true on posix). Compared
+ * case-insensitively — win32 drive letters are case-insensitive.
+ */
+export declare function sharesVolumeRoot(a: string, b: string, pathApi?: PlatformPath): boolean;
+/** One resolved source identity. */
+export interface ResolvedSourceId {
+    /**
+     * The rootDir-relative source key all persistent analysis state is
+     * indexed by — kit files keep their `..`-prefixed keys. Derived from
+     * CANONICAL paths (canonical suffix re-attached to the root's
+     * as-registered spelling) so it always matches the key discovery
+     * produced, whatever spelling the event carried.
+     */
+    sourceKey: string;
+    /** Canonical form of the owning external root; null when the project
+     *  root itself owns the file. */
+    owningRoot: string | null;
+    /** Canonical path of the file relative to its owning root (equals
+     *  `sourceKey` for project-root members) — the input for package-relative
+     *  exclusion filters. */
+    pathInRoot: string;
+}
+/**
+ * The per-generation identity handle (design D2): canonical roots are
+ * realpath'd once at registration, and every alias→SourceId association
+ * observed while a file existed is recorded so DELETION resolves through
+ * the cache — never through fresh canonicalization of a gone path.
+ */
+export interface SourceIdentity {
+    readonly rootDir: string;
+    readonly canonicalRootDir: string;
+    /**
+     * Register a discovery-resolved external source root. Both the
+     * as-registered (lexical) and canonical forms become membership
+     * witnesses; duplicate spellings of one canonical root collapse into the
+     * first registration. Returns the canonical form.
+     */
+    registerExternalRoot(root: string): string;
+    /** Canonical forms of every registered external root (registration order). */
+    externalRoots(): string[];
+    /**
+     * Resolve an EXISTING path to its source identity: canonicalize, then
+     * re-authorize containment against the canonical form of the allowed
+     * trees (a nested symlink escaping every allowed tree is rejected).
+     * Records the observed spelling (and the canonical form) as deletion
+     * aliases. Returns null for non-members and paths that cannot be
+     * canonicalized (vanished between event and resolution).
+     */
+    resolveSourceId(inputPath: string): ResolvedSourceId | null;
+    /**
+     * Resolve a DELETED path through the recorded alias associations only —
+     * a spelling never observed while the file existed resolves nothing.
+     */
+    resolveDeletedSourceId(inputPath: string): ResolvedSourceId | null;
+    /**
+     * The canonical external root structurally containing `inputPath`
+     * (matched against both root forms; the path itself need not exist and
+     * no file identity is resolved) — the watch pass's dirty-root witness
+     * for directory-granularity reports. Null when no root contains it.
+     */
+    containingExternalRoot(inputPath: string): string | null;
+}
+export declare function createSourceIdentity(rootDir: string): SourceIdentity;
+export {};
+//# sourceMappingURL=source-identity.d.ts.map

package/dist/source-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-identity.d.ts","sourceRoot":"","sources":["../pipeline/source-identity.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;sEAGsE;AACtE,KAAK,YAAY,GAAG,OAAO,IAAI,CAAC,KAAK,CAAC;AAEtC;;;;;;;;;;;;GAYG;AAEH;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,YAAmB,GAC3B,OAAO,CAQT;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,GAAE,YAAmB,GAC3B,OAAO,CAIT;AAED,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;qCACiC;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;6BAEyB;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC;;;;;OAKG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3C,8EAA8E;IAC9E,aAAa,IAAI,MAAM,EAAE,CAAC;IAC1B;;;;;;;OAOG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAC5D;;;OAGG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;IACnE;;;;;OAKG;IACH,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC1D;AAeD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CA0GpE"}

package/dist/system-config.d.ts

@@ -18,6 +18,14 @@ export interface SystemConfig {
      *  Optional so the plugins' pre-load `emptySystemConfig()` default need not
      *  restate it; `loadSystemConfig` always populates it after a real load. */
     conditionAliasesJson?: string | null;
+    /** `{ transformName: sourceText }` JSON captured during system evaluation.
+     *  The build-time evaluator can only be seeded from source text, and
+     *  `propConfigJson` names each prop's transform without carrying its body —
+     *  so this is the only channel by which transforms shipped inside a package
+     *  (rather than declared in a `createTransform()` call the extractor parses
+     *  out of a project file) become resolvable. Optional so the plugins'
+     *  pre-load `emptySystemConfig()` default need not restate it. */
+    transformSourcesJson?: string | null;
     globalStyleBlocksJson: string | null;
     keyframesJson: string | null;
     /** Canonical absolute paths of every module the loader evaluated for this

package/dist/system-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-config.d.ts","sourceRoot":"","sources":["../pipeline/system-config.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;;gFAG4E;IAC5E,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;;8DAG0D;IAC1D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;kDAG8C;IAC9C,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAE9B,SAAS,EAAE,MAAM,GAAG,EACpB,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D,YAAY,CAuCd"}
+{"version":3,"file":"system-config.d.ts","sourceRoot":"","sources":["../pipeline/system-config.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC;;;gFAG4E;IAC5E,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC;;;;;;sEAMkE;IAClE,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;;8DAG0D;IAC1D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;kDAG8C;IAC9C,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAE9B,SAAS,EAAE,MAAM,GAAG,EACpB,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D,YAAY,CAwCd"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@animus-ui/extract",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Animus static CSS extraction pipeline (Rust/NAPI)",
   "keywords": [
     "animus",
@@ -51,12 +51,12 @@
     "build:v2:debug": "cd crates/extract-v2 && bunx napi build --platform"
   },
   "dependencies": {
-    "@animus-ui/properties": "0.1.7",
+    "@animus-ui/properties": "0.1.9",
     "browserslist": "^4.24.0",
     "lightningcss": "^1.29.0"
   },
   "devDependencies": {
-    "@animus-ui/system": "0.1.7",
+    "@animus-ui/system": "0.1.9",
     "@mdx-js/mdx": "3.1.1",
     "@napi-rs/cli": "^3.7.3"
   },