@animus-ui/extract 0.1.0-next.v7 → 0.1.1-beta.2

package/README.md

@@ -0,0 +1,35 @@
+# @animus-ui/extract
+
+Rust/NAPI static CSS extraction pipeline for Animus. Analyzes TypeScript source files using OXC, resolves builder chains against serialized system config, and emits layered CSS.
+
+This package is consumed by [`@animus-ui/vite-plugin`](../vite-plugin) and [`@animus-ui/next-plugin`](../next-plugin). You typically don't install it directly — the bundler plugins depend on it.
+
+## Platforms
+
+Pre-built binaries for:
+
+- `darwin-arm64` (macOS Apple Silicon)
+- `linux-x64-gnu` (Linux x64)
+- `linux-arm64-gnu` (Linux ARM64)
+
+## API
+
+```tsx
+import { analyzeProject } from '@animus-ui/extract';
+
+const manifest = analyzeProject(
+  fileEntriesJson,
+  scalesJson,
+  variableMapJson,
+  contextualVarsJson,
+  propConfig,
+  groupRegistry,
+  packageResolutionJson,
+  devMode,
+  prefix
+);
+```
+
+## License
+
+MIT

package/crates/extract-v2/index.d.ts

@@ -0,0 +1,104 @@
+/* auto-generated by NAPI-RS */
+/* eslint-disable */
+export declare class ExtractEngine {
+  constructor(options?: EngineOptions | undefined | null)
+  /**
+   * Parse-once fact extraction over the file set; facts and sources are
+   * RETAINED on the handle for subsequent per-file calls. Returns the
+   * fact manifest (files + parseCount) as JSON.
+   */
+  analyze(fileEntriesJson: string): string
+  /** Reset all retained build state. */
+  clearCache(): void
+  get parseCount(): number
+  /**
+   * Per-file transformation from retained source + facts (no-config
+   * subset: variants/compounds/states; system/custom payloads need the
+   * row-07 config inputs and FAIL LOUD). Returns {code, hasComponents}
+   * JSON. Import decisions come from surviving chain/payload metadata;
+   * consumed-import stripping and directive handling are the ported v1
+   * semantics.
+   */
+  transformFile(path: string): string
+}
+
+/**
+ * Chain discovery over a file set: parse once per file (parallel), walk
+ * every stored AST, return owned facts. The v2 spine's first real surface;
+ * consumed by the parity comparison tooling.
+ */
+export declare function discoverChains(fileEntriesJson: string): string
+
+/**
+ * Engine options (row 07 Task 07.3 — replaces the RF-53 hardcodes).
+ * All fields optional; absent = v1 defaults.
+ */
+export interface EngineOptions {
+  /** Class-identity prefix (v1 default "animus"). */
+  prefix?: string
+  /** Runtime import source (v1 default "@animus-ui/system"). */
+  runtimeImport?: string
+  /** CSS virtual module id (v1 default "virtual:animus/styles.css"). */
+  cssModuleId?: string
+  /**
+   * System-props virtual module id (v1 EmitterConfig default
+   * "virtual:animus/system-props").
+   */
+  systemPropsModuleId?: string
+  /** Flat theme scales JSON (v1 analyzeProject `theme_json`). */
+  themeJson?: string
+  /** Token-alias variable map JSON (v1 `variable_map_json`). */
+  variableMapJson?: string
+  /** Contextual vars JSON (v1 `contextual_vars_json`). */
+  contextualVarsJson?: string
+  /** Prop config map JSON (v1 `config_json`). */
+  configJson?: string
+  /** Group registry JSON (v1 `group_registry_json`). */
+  groupRegistryJson?: string
+  /** Selector aliases JSON (v1 `selector_aliases_json`). */
+  selectorAliasesJson?: string
+  /** Global style blocks JSON (v1 `global_style_blocks_json`). */
+  globalStyleBlocksJson?: string
+  /**
+   * Keyframes blocks JSON (v1 `keyframes_blocks_json` — feeds BOTH the
+   * global sheet and the static keyframes registry, v1 Phase 2a).
+   */
+  keyframesJson?: string
+  /** Package resolution JSON (v1 `package_resolution_json`). */
+  packageResolutionJson?: string
+  /** Path aliases JSON (`{aliases: [...]}` wrapper, v1 shape). */
+  pathAliasesJson?: string
+  /** v1 `dev_mode`: retain all components (skip reconciliation pruning). */
+  devMode?: boolean
+}
+
+/**
+ * Build/probe identity: proves the v2 binary loads and its oxc linkage
+ * parses. Consumed by the dual-build verification and the parity harness
+ * engine registry.
+ */
+export declare function engineVersion(): string
+
+/**
+ * Full per-file fact extraction (increment 11): chains + eagerly evaluated
+ * stages + statics + raw usage facts + compose families — one parse per
+ * file. The store (and every AST) is dropped when this call returns; the
+ * D4-relevant invariant is that no program() read happens after
+ * cross-file facts resolve.
+ */
+export declare function extractFacts(fileEntriesJson: string): string
+
+export declare function loadSystemModule(systemPath: string, rootDir: string, exportName?: string | undefined | null): NapiSystemConfig
+
+export interface NapiSystemConfig {
+  propConfig: string
+  groupRegistry: string
+  scalesJson: string
+  variableMapJson: string
+  variableCss: string
+  contextualVarsJson: string
+  selectorAliases?: string
+  selectorOrder?: string
+  globalStyleBlocks?: string
+  keyframesBlocks?: string
+}