@llui/compiler 0.3.1 → 0.4.0

package/dist/emit-names.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Single source of truth for the compiler's emission name registry.
+ *
+ * Two disjoint sets:
+ *
+ *   - `COMPILER_RENAMEABLE_KEYS` — property keys the compiler synthesizes
+ *     onto `component({...})` literals. The runtime reads these via
+ *     property access (`def.__view`, `def.__prefixes`, etc.) inside the
+ *     same bundle that the compiler emitted them into. Their producer and
+ *     consumer are colocated in the bundle, so the vite-plugin's post-
+ *     bundle property-rename pass can shorten them to `$a`/`$b`/… without
+ *     breaking the contract.
+ *
+ *   - `COMPILER_DOM_INTERNAL_IMPORTS` — runtime helpers the compiler
+ *     references by NAME (not by property key) via an
+ *     `import { __cloneStaticTemplate } from '@llui/dom/internal'`
+ *     declaration. These cross a module boundary at consumer build time.
+ *     Anything the rename pass touches that ends up in an import specifier
+ *     would be rewritten to `$X`, which the source package never exports,
+ *     and rolldown fails the build with `MISSING_EXPORT`. **These names
+ *     must NEVER be renamed.**
+ *
+ * The two sets are disjoint by construction — the type-level
+ * `Extract<...>` assertion below fails compilation if any name appears
+ * in both lists. New compiler-emitted names land in whichever list
+ * matches their lifetime; if you accidentally add one to both, `tsc`
+ * tells you before the bug ships.
+ *
+ * Subpath choice matters: the helpers live at `@llui/dom/internal`, not
+ * at the root `@llui/dom`, because the rename regex matches any
+ * `__`-prefixed identifier in the bundle. By hosting the helpers on a
+ * subpath whose import specifier never gets touched by the rename, we
+ * keep both the regex and the runtime export surface internally
+ * consistent without needing an AST-aware rename pass.
+ */
+export declare const COMPILER_RENAMEABLE_KEYS: readonly ["__view", "__view$", "__prefixes", "__handlers", "__compilerVersion", "__directUpdate", "__mask", "__maskHi", "__maskLegend", "__perItem", "__rowUpd", "__rowUpdate", "__schemaHash", "__tpl", "__msgSchema", "__msgAnnotations", "__bindingDescriptors", "__stateSchema", "__effectSchema", "__componentMeta", "__renderToString", "__update", "__dirty"];
+export type CompilerRenameableKey = (typeof COMPILER_RENAMEABLE_KEYS)[number];
+export declare const COMPILER_DOM_INTERNAL_IMPORTS: readonly ["__bindUncertain", "__cloneStaticTemplate", "__runPhase2", "__handleMsg", "__registerScopeVariants", "__clientOnlyStub"];
+export type CompilerDomInternalImport = (typeof COMPILER_DOM_INTERNAL_IMPORTS)[number];
+/** Module specifier the compiler emits for the internal-helper imports. */
+export declare const DOM_INTERNAL_MODULE_SPECIFIER = "@llui/dom/internal";
+//# sourceMappingURL=emit-names.d.ts.map

package/dist/emit-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-names.d.ts","sourceRoot":"","sources":["../src/emit-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,eAAO,MAAM,wBAAwB,sWAwB3B,CAAA;AAEV,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE7E,eAAO,MAAM,6BAA6B,oIAOhC,CAAA;AAEV,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAA;AAUtF,2EAA2E;AAC3E,eAAO,MAAM,6BAA6B,uBAAuB,CAAA"}

package/dist/emit-names.js

@@ -0,0 +1,73 @@
+/**
+ * Single source of truth for the compiler's emission name registry.
+ *
+ * Two disjoint sets:
+ *
+ *   - `COMPILER_RENAMEABLE_KEYS` — property keys the compiler synthesizes
+ *     onto `component({...})` literals. The runtime reads these via
+ *     property access (`def.__view`, `def.__prefixes`, etc.) inside the
+ *     same bundle that the compiler emitted them into. Their producer and
+ *     consumer are colocated in the bundle, so the vite-plugin's post-
+ *     bundle property-rename pass can shorten them to `$a`/`$b`/… without
+ *     breaking the contract.
+ *
+ *   - `COMPILER_DOM_INTERNAL_IMPORTS` — runtime helpers the compiler
+ *     references by NAME (not by property key) via an
+ *     `import { __cloneStaticTemplate } from '@llui/dom/internal'`
+ *     declaration. These cross a module boundary at consumer build time.
+ *     Anything the rename pass touches that ends up in an import specifier
+ *     would be rewritten to `$X`, which the source package never exports,
+ *     and rolldown fails the build with `MISSING_EXPORT`. **These names
+ *     must NEVER be renamed.**
+ *
+ * The two sets are disjoint by construction — the type-level
+ * `Extract<...>` assertion below fails compilation if any name appears
+ * in both lists. New compiler-emitted names land in whichever list
+ * matches their lifetime; if you accidentally add one to both, `tsc`
+ * tells you before the bug ships.
+ *
+ * Subpath choice matters: the helpers live at `@llui/dom/internal`, not
+ * at the root `@llui/dom`, because the rename regex matches any
+ * `__`-prefixed identifier in the bundle. By hosting the helpers on a
+ * subpath whose import specifier never gets touched by the rename, we
+ * keep both the regex and the runtime export surface internally
+ * consistent without needing an AST-aware rename pass.
+ */
+export const COMPILER_RENAMEABLE_KEYS = [
+    '__view',
+    '__view$',
+    '__prefixes',
+    '__handlers',
+    '__compilerVersion',
+    '__directUpdate',
+    '__mask',
+    '__maskHi',
+    '__maskLegend',
+    '__perItem',
+    '__rowUpd',
+    '__rowUpdate',
+    '__schemaHash',
+    '__tpl',
+    '__msgSchema',
+    '__msgAnnotations',
+    '__bindingDescriptors',
+    '__stateSchema',
+    '__effectSchema',
+    '__componentMeta',
+    '__renderToString',
+    '__update',
+    '__dirty',
+];
+export const COMPILER_DOM_INTERNAL_IMPORTS = [
+    '__bindUncertain',
+    '__cloneStaticTemplate',
+    '__runPhase2',
+    '__handleMsg',
+    '__registerScopeVariants',
+    '__clientOnlyStub',
+];
+const _disjointnessProof = true;
+void _disjointnessProof;
+/** Module specifier the compiler emits for the internal-helper imports. */
+export const DOM_INTERNAL_MODULE_SPECIFIER = '@llui/dom/internal';
+//# sourceMappingURL=emit-names.js.map

package/dist/emit-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-names.js","sourceRoot":"","sources":["../src/emit-names.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,QAAQ;IACR,SAAS;IACT,YAAY;IACZ,YAAY;IACZ,mBAAmB;IACnB,gBAAgB;IAChB,QAAQ;IACR,UAAU;IACV,cAAc;IACd,WAAW;IACX,UAAU;IACV,aAAa;IACb,cAAc;IACd,OAAO;IACP,aAAa;IACb,kBAAkB;IAClB,sBAAsB;IACtB,eAAe;IACf,gBAAgB;IAChB,iBAAiB;IACjB,kBAAkB;IAClB,UAAU;IACV,SAAS;CACD,CAAA;AAIV,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,iBAAiB;IACjB,uBAAuB;IACvB,aAAa;IACb,aAAa;IACb,yBAAyB;IACzB,kBAAkB;CACV,CAAA;AASV,MAAM,kBAAkB,GAA2C,IAAI,CAAA;AACvE,KAAK,kBAAkB,CAAA;AAEvB,2EAA2E;AAC3E,MAAM,CAAC,MAAM,6BAA6B,GAAG,oBAAoB,CAAA","sourcesContent":["/**\n * Single source of truth for the compiler's emission name registry.\n *\n * Two disjoint sets:\n *\n *   - `COMPILER_RENAMEABLE_KEYS` — property keys the compiler synthesizes\n *     onto `component({...})` literals. The runtime reads these via\n *     property access (`def.__view`, `def.__prefixes`, etc.) inside the\n *     same bundle that the compiler emitted them into. Their producer and\n *     consumer are colocated in the bundle, so the vite-plugin's post-\n *     bundle property-rename pass can shorten them to `$a`/`$b`/… without\n *     breaking the contract.\n *\n *   - `COMPILER_DOM_INTERNAL_IMPORTS` — runtime helpers the compiler\n *     references by NAME (not by property key) via an\n *     `import { __cloneStaticTemplate } from '@llui/dom/internal'`\n *     declaration. These cross a module boundary at consumer build time.\n *     Anything the rename pass touches that ends up in an import specifier\n *     would be rewritten to `$X`, which the source package never exports,\n *     and rolldown fails the build with `MISSING_EXPORT`. **These names\n *     must NEVER be renamed.**\n *\n * The two sets are disjoint by construction — the type-level\n * `Extract<...>` assertion below fails compilation if any name appears\n * in both lists. New compiler-emitted names land in whichever list\n * matches their lifetime; if you accidentally add one to both, `tsc`\n * tells you before the bug ships.\n *\n * Subpath choice matters: the helpers live at `@llui/dom/internal`, not\n * at the root `@llui/dom`, because the rename regex matches any\n * `__`-prefixed identifier in the bundle. By hosting the helpers on a\n * subpath whose import specifier never gets touched by the rename, we\n * keep both the regex and the runtime export surface internally\n * consistent without needing an AST-aware rename pass.\n */\n\nexport const COMPILER_RENAMEABLE_KEYS = [\n  '__view',\n  '__view$',\n  '__prefixes',\n  '__handlers',\n  '__compilerVersion',\n  '__directUpdate',\n  '__mask',\n  '__maskHi',\n  '__maskLegend',\n  '__perItem',\n  '__rowUpd',\n  '__rowUpdate',\n  '__schemaHash',\n  '__tpl',\n  '__msgSchema',\n  '__msgAnnotations',\n  '__bindingDescriptors',\n  '__stateSchema',\n  '__effectSchema',\n  '__componentMeta',\n  '__renderToString',\n  '__update',\n  '__dirty',\n] as const\n\nexport type CompilerRenameableKey = (typeof COMPILER_RENAMEABLE_KEYS)[number]\n\nexport const COMPILER_DOM_INTERNAL_IMPORTS = [\n  '__bindUncertain',\n  '__cloneStaticTemplate',\n  '__runPhase2',\n  '__handleMsg',\n  '__registerScopeVariants',\n  '__clientOnlyStub',\n] as const\n\nexport type CompilerDomInternalImport = (typeof COMPILER_DOM_INTERNAL_IMPORTS)[number]\n\n// Compile-time proof that the two sets are disjoint. If any name appears\n// in both lists, `Extract<...>` resolves to that name's string literal\n// instead of `never`, and the assignment fails. Move the offending name\n// to one list or the other; never both.\ntype _Disjoint = Extract<CompilerRenameableKey, CompilerDomInternalImport>\nconst _disjointnessProof: _Disjoint extends never ? true : false = true\nvoid _disjointnessProof\n\n/** Module specifier the compiler emits for the internal-helper imports. */\nexport const DOM_INTERNAL_MODULE_SPECIFIER = '@llui/dom/internal'\n"]}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from './emit-names.js';
 export * from './accessor-resolver.js';
 export * from './binding-descriptors.js';
 export * from './collect-deps.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AACxC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,wBAAwB,CAAA;AACtC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,4BAA4B,CAAA;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AASzD,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EACL,cAAc,EACd,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,GACjC,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AACnF,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AACtF,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,GACxB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AACzF,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,GACvB,MAAM,6BAA6B,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AACxC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,wBAAwB,CAAA;AACtC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,4BAA4B,CAAA;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AASzD,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EACL,cAAc,EACd,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,GACjC,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AACnF,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AACtF,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,GACxB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AACzF,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,GACvB,MAAM,6BAA6B,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA"}

package/dist/index.js

@@ -1,5 +1,6 @@
 // @llui/compiler — engine. Adapters consume through these re-exports.
 // Migration in progress (see docs/proposals/v2-compiler/v2a.md §4.4).
+export * from './emit-names.js';
 export * from './accessor-resolver.js';
 export * from './binding-descriptors.js';
 export * from './collect-deps.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,sEAAsE;AACtE,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AACxC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,wBAAwB,CAAA;AACtC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,4BAA4B,CAAA;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,wEAAwE;AACxE,2EAA2E;AAC3E,uEAAuE;AACvE,oEAAoE;AACpE,wEAAwE;AACxE,qEAAqE;AACrE,6BAA6B;AAC7B,wEAAwE;AACxE,OAAO,EAAE,gBAAgB,EAAgC,MAAM,0BAA0B,CAAA;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EACL,cAAc,EACd,cAAc,GAGf,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,oBAAoB,GAErB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,cAAc,EAA8B,MAAM,wBAAwB,CAAA;AACnF,OAAO,EAAE,eAAe,EAA+B,MAAM,yBAAyB,CAAA;AACtF,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAGrB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,gBAAgB,EAAgC,MAAM,0BAA0B,CAAA;AACzF,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GAGpB,MAAM,6BAA6B,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA","sourcesContent":["// @llui/compiler — engine. Adapters consume through these re-exports.\n// Migration in progress (see docs/proposals/v2-compiler/v2a.md §4.4).\nexport * from './accessor-resolver.js'\nexport * from './binding-descriptors.js'\nexport * from './collect-deps.js'\nexport * from './compiler-cache.js'\nexport * from './cross-file-resolver.js'\nexport * from './cross-file-walker.js'\nexport * from './diagnostic.js'\nexport * from './manifest.js'\nexport * from './module.js'\nexport * from './version.js'\nexport * from './introspection-factory.js'\nexport { findComponentCalls } from './modules/_shared.js'\n// Introspection modules (schemaHashModule, msg-schema, msg-annotations,\n// state-schema, binding-descriptors) moved to @llui/compiler-introspection\n// in v2c/decomp-26. Adapters that previously imported these names from\n// @llui/compiler must now import from @llui/compiler-introspection.\n// BINDING_DESCRIPTORS_SLOT is re-exported from introspection-factory.js\n// (above) so the orchestrator can read the slot without depending on\n// the introspection package.\n// componentMetaModule moved to @llui/compiler-devtools (v2c/decomp-27).\nexport { maskLegendModule, type MaskLegendModuleOptions } from './modules/mask-legend.js'\nexport { compilerStampModule } from './modules/compiler-stamp.js'\nexport {\n  eachMemoModule,\n  EACH_MEMO_SLOT,\n  type EachMemoModuleOptions,\n  type EachMemoSlot,\n} from './modules/each-memo.js'\nexport {\n  structuralMaskModule,\n  type StructuralMaskModuleOptions,\n} from './modules/structural-mask.js'\nexport { textMaskModule, type TextMaskModuleOptions } from './modules/text-mask.js'\nexport { itemDedupModule, type ItemDedupModuleOptions } from './modules/item-dedup.js'\nexport {\n  elementRewriteModule,\n  ELEMENT_REWRITE_SLOT,\n  type ElementRewriteModuleOptions,\n  type ElementRewriteSlot,\n} from './modules/element-rewrite.js'\nexport { rowFactoryModule, type RowFactoryModuleOptions } from './modules/row-factory.js'\nexport {\n  coreSynthesisModule,\n  CORE_SYNTHESIS_SLOT,\n  type CoreSynthesisModuleOptions,\n  type CoreSynthesisSlot,\n} from './modules/core-synthesis.js'\nexport * from './msg-annotations.js'\nexport * from './msg-schema.js'\nexport * from './schema-hash.js'\nexport * from './state-schema.js'\nexport * from './transform.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,sEAAsE;AACtE,cAAc,iBAAiB,CAAA;AAC/B,cAAc,wBAAwB,CAAA;AACtC,cAAc,0BAA0B,CAAA;AACxC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,wBAAwB,CAAA;AACtC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,4BAA4B,CAAA;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,wEAAwE;AACxE,2EAA2E;AAC3E,uEAAuE;AACvE,oEAAoE;AACpE,wEAAwE;AACxE,qEAAqE;AACrE,6BAA6B;AAC7B,wEAAwE;AACxE,OAAO,EAAE,gBAAgB,EAAgC,MAAM,0BAA0B,CAAA;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EACL,cAAc,EACd,cAAc,GAGf,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,oBAAoB,GAErB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,cAAc,EAA8B,MAAM,wBAAwB,CAAA;AACnF,OAAO,EAAE,eAAe,EAA+B,MAAM,yBAAyB,CAAA;AACtF,OAAO,EACL,oBAAoB,EACpB,oBAAoB,GAGrB,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,gBAAgB,EAAgC,MAAM,0BAA0B,CAAA;AACzF,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GAGpB,MAAM,6BAA6B,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA","sourcesContent":["// @llui/compiler — engine. Adapters consume through these re-exports.\n// Migration in progress (see docs/proposals/v2-compiler/v2a.md §4.4).\nexport * from './emit-names.js'\nexport * from './accessor-resolver.js'\nexport * from './binding-descriptors.js'\nexport * from './collect-deps.js'\nexport * from './compiler-cache.js'\nexport * from './cross-file-resolver.js'\nexport * from './cross-file-walker.js'\nexport * from './diagnostic.js'\nexport * from './manifest.js'\nexport * from './module.js'\nexport * from './version.js'\nexport * from './introspection-factory.js'\nexport { findComponentCalls } from './modules/_shared.js'\n// Introspection modules (schemaHashModule, msg-schema, msg-annotations,\n// state-schema, binding-descriptors) moved to @llui/compiler-introspection\n// in v2c/decomp-26. Adapters that previously imported these names from\n// @llui/compiler must now import from @llui/compiler-introspection.\n// BINDING_DESCRIPTORS_SLOT is re-exported from introspection-factory.js\n// (above) so the orchestrator can read the slot without depending on\n// the introspection package.\n// componentMetaModule moved to @llui/compiler-devtools (v2c/decomp-27).\nexport { maskLegendModule, type MaskLegendModuleOptions } from './modules/mask-legend.js'\nexport { compilerStampModule } from './modules/compiler-stamp.js'\nexport {\n  eachMemoModule,\n  EACH_MEMO_SLOT,\n  type EachMemoModuleOptions,\n  type EachMemoSlot,\n} from './modules/each-memo.js'\nexport {\n  structuralMaskModule,\n  type StructuralMaskModuleOptions,\n} from './modules/structural-mask.js'\nexport { textMaskModule, type TextMaskModuleOptions } from './modules/text-mask.js'\nexport { itemDedupModule, type ItemDedupModuleOptions } from './modules/item-dedup.js'\nexport {\n  elementRewriteModule,\n  ELEMENT_REWRITE_SLOT,\n  type ElementRewriteModuleOptions,\n  type ElementRewriteSlot,\n} from './modules/element-rewrite.js'\nexport { rowFactoryModule, type RowFactoryModuleOptions } from './modules/row-factory.js'\nexport {\n  coreSynthesisModule,\n  CORE_SYNTHESIS_SLOT,\n  type CoreSynthesisModuleOptions,\n  type CoreSynthesisSlot,\n} from './modules/core-synthesis.js'\nexport * from './msg-annotations.js'\nexport * from './msg-schema.js'\nexport * from './schema-hash.js'\nexport * from './state-schema.js'\nexport * from './transform.js'\n"]}

package/dist/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":"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"}

package/dist/transform.js

@@ -718,6 +718,20 @@ export function transformLlui(source, _filename, devMode = false, emitAgentMetad
                 ? generateDevCode(componentDecls, mcpPort)
                 : { top: '', bottom: '' };
             let output = (_top ? _top + '\n' : '') + printer.printFile(transformed) + (_bottom ? '\n' + _bottom : '');
+            // Inject the `@llui/dom/internal` import on the fallback path too.
+            // The per-statement edit loop (where the normal injection lives)
+            // never ran to completion in this branch, so do it inline.
+            const internalEditFb = buildInternalImportEdit(lluiImport, usesBindUncertain, usesCloneStaticTemplate, usesApplyBinding, scopeRegistrationsInjected);
+            if (internalEditFb) {
+                // Place right after the public `@llui/dom` import in the
+                // printed output. The printer normalizes the import to a
+                // single line; locate it by string match.
+                const m = output.match(/import\s*\{[^}]*\}\s*from\s*['"]@llui\/dom['"];?\n/);
+                if (m && m.index !== undefined) {
+                    const insertAt = m.index + m[0].length;
+                    output = output.slice(0, insertAt) + internalEditFb.replacement + output.slice(insertAt);
+                }
+            }
             if (devMode || emitAgentMetadata) {
                 output = appendCompilerCacheProps(output, componentDecls);
             }
@@ -738,6 +752,14 @@ export function transformLlui(source, _filename, devMode = false, emitAgentMetad
             finalEdits.push({ start: origStart, end: origEnd, replacement });
         }
     }
+    // Compiler-emitted internal helpers ride on `@llui/dom/internal`,
+    // not on the public `@llui/dom` barrel. Insert the import as a
+    // text-level edit (not an AST statement) so it doesn't disturb the
+    // origin↔transformed index pairing the per-statement diff relies on.
+    // See cleanupImports' NOTE and buildInternalImportEdit's docstring.
+    const internalEdit = buildInternalImportEdit(lluiImport, usesBindUncertain, usesCloneStaticTemplate, usesApplyBinding, scopeRegistrationsInjected);
+    if (internalEdit)
+        finalEdits.push(internalEdit);
     // Dev setup: enable* must run BEFORE user's mountApp (top of file),
     // but import.meta.hot.accept needs to reference user's component vars
     // (bottom of file). So split the injection.
@@ -976,12 +998,19 @@ const VIEW_BAG_FIELD_TO_PRIMITIVE = {
  * Idempotent — returns `call` unchanged when:
  *   • the config arg is not an object literal
  *   • no `view:` property exists, or its value is not an arrow/function
- *   • the view's first parameter is not an ObjectBindingPattern
  *   • the config arg already has a `__view` property (re-run safety)
  *
  * Bag fields that aren't in `VIEW_BAG_FIELD_TO_PRIMITIVE` (e.g. unknown
- * names from a user-typed View extension) are skipped so the runtime falls
- * back to `createView` for any access to them.
+ * names from a user-typed View extension) are skipped — the runtime
+ * cannot fabricate them, so accessing them at runtime is the user's
+ * problem (matches dev-mode behavior).
+ *
+ * Identifier-style view params (`view: (h) => ...` or `view: (send) => ...`)
+ * can't be statically narrowed to a known subset of primitives — `h` may
+ * be passed to helpers, destructured later, or read dynamically. For
+ * those we emit `__view: ($send) => createView($send)` so the runtime
+ * gets the full bag. The instance-level `_viewBag` cache on
+ * `getInstanceViewBag` means this is still one allocation per mount.
  */
 function injectViewBag(call, needed, f) {
     const configArg = call.arguments[0];
@@ -1008,51 +1037,67 @@ function injectViewBag(call, needed, f) {
     }
     if (!viewFn)
         return call;
-    // Inspect the first parameter — must be an ObjectBindingPattern.
-    const firstParam = viewFn.parameters[0];
-    if (!firstParam || !ts.isObjectBindingPattern(firstParam.name))
-        return call;
-    const entries = [];
-    for (const elem of firstParam.name.elements) {
-        const localName = ts.isIdentifier(elem.name) ? elem.name.text : null;
-        const sourceName = elem.propertyName && ts.isIdentifier(elem.propertyName) ? elem.propertyName.text : localName;
-        if (!localName || !sourceName)
-            continue;
-        if (sourceName === 'send') {
-            entries.push({ localName, primitive: null });
-            continue;
-        }
-        const primitive = VIEW_BAG_FIELD_TO_PRIMITIVE[sourceName];
-        if (!primitive)
-            continue; // unknown name — let the runtime fail at runtime if accessed
-        entries.push({ localName, primitive });
-    }
-    if (entries.length === 0)
-        return call;
-    // Synthesize: __view: ($send) => ({ localA: $send, localB: text, localC: each, ... })
-    // We use a fixed parameter name `$send` to avoid shadowing — the bag
-    // entries that map to send use this identifier.
     const sendParamName = f.createIdentifier('$send');
-    const bagProps = [];
-    for (const e of entries) {
-        if (e.primitive === null) {
-            // local name → send parameter
-            bagProps.push(e.localName === '$send'
-                ? f.createShorthandPropertyAssignment(sendParamName)
-                : f.createPropertyAssignment(f.createIdentifier(e.localName), sendParamName));
-        }
-        else if (e.localName === e.primitive) {
-            bagProps.push(f.createShorthandPropertyAssignment(f.createIdentifier(e.localName)));
-            needed.add(e.primitive);
+    // Build the __view factory body. Two shapes:
+    //
+    //   Destructured param — `view: ({ send, text, each }) => ...`
+    //     emit `__view: ($send) => ({ send: $send, text, each })`
+    //     (tree-shakes unused primitives — the Tier 1.2 size cut).
+    //
+    //   Identifier / no param — `view: (h) => ...`, `view: () => ...`,
+    //   `view: (send) => ...`, etc.
+    //     emit `__view: ($send) => createView($send)`
+    //     The compiler can't see which fields `h` is accessed on (it
+    //     may be passed to a helper, destructured later, read by
+    //     name dynamically). Full bag, instance-cached.
+    const firstParam = viewFn.parameters[0];
+    const isDestructured = !!firstParam && ts.isObjectBindingPattern(firstParam.name);
+    let factoryBody;
+    if (isDestructured) {
+        const entries = [];
+        for (const elem of firstParam.name.elements) {
+            const localName = ts.isIdentifier(elem.name) ? elem.name.text : null;
+            const sourceName = elem.propertyName && ts.isIdentifier(elem.propertyName) ? elem.propertyName.text : localName;
+            if (!localName || !sourceName)
+                continue;
+            if (sourceName === 'send') {
+                entries.push({ localName, primitive: null });
+                continue;
+            }
+            const primitive = VIEW_BAG_FIELD_TO_PRIMITIVE[sourceName];
+            if (!primitive)
+                continue; // unknown name — accessing it at runtime is the user's problem
+            entries.push({ localName, primitive });
         }
-        else {
-            bagProps.push(f.createPropertyAssignment(f.createIdentifier(e.localName), f.createIdentifier(e.primitive)));
-            needed.add(e.primitive);
+        const bagProps = [];
+        for (const e of entries) {
+            if (e.primitive === null) {
+                bagProps.push(e.localName === '$send'
+                    ? f.createShorthandPropertyAssignment(sendParamName)
+                    : f.createPropertyAssignment(f.createIdentifier(e.localName), sendParamName));
+            }
+            else if (e.localName === e.primitive) {
+                bagProps.push(f.createShorthandPropertyAssignment(f.createIdentifier(e.localName)));
+                needed.add(e.primitive);
+            }
+            else {
+                bagProps.push(f.createPropertyAssignment(f.createIdentifier(e.localName), f.createIdentifier(e.primitive)));
+                needed.add(e.primitive);
+            }
         }
+        factoryBody = f.createParenthesizedExpression(f.createObjectLiteralExpression(bagProps, false));
+    }
+    else {
+        // Identifier-style or zero-arg view: emit `createView($send)` and
+        // pull `createView` into the file imports via cleanupImports.
+        needed.add('createView');
+        factoryBody = f.createCallExpression(f.createIdentifier('createView'), undefined, [
+            sendParamName,
+        ]);
     }
     const viewBagFactory = f.createArrowFunction(undefined, undefined, [
         f.createParameterDeclaration(undefined, undefined, sendParamName, undefined, undefined, undefined),
-    ], undefined, f.createToken(ts.SyntaxKind.EqualsGreaterThanToken), f.createParenthesizedExpression(f.createObjectLiteralExpression(bagProps, false)));
+    ], undefined, f.createToken(ts.SyntaxKind.EqualsGreaterThanToken), factoryBody);
     const newConfig = f.createObjectLiteralExpression([...configArg.properties, f.createPropertyAssignment('__view', viewBagFactory)], true);
     return f.createCallExpression(call.expression, call.typeArguments, [
         newConfig,
@@ -1181,50 +1226,37 @@ function cleanupImports(sf, lluiImport, _helpers, compiled, usesElSplit, usesElT
     const clause = lluiImport.importClause;
     if (!clause?.namedBindings || !ts.isNamedImports(clause.namedBindings))
         return sf;
-    const remaining = clause.namedBindings.elements.filter((spec) => !compiled.has(spec.name.text));
-    const hasElSplit = clause.namedBindings.elements.some((s) => s.name.text === 'elSplit');
-    if (!hasElSplit && usesElSplit) {
-        remaining.push(f.createImportSpecifier(false, undefined, f.createIdentifier('elSplit')));
-    }
-    const hasBindUncertain = clause.namedBindings.elements.some((s) => s.name.text === '__bindUncertain');
-    if (!hasBindUncertain && usesBindUncertain) {
-        remaining.push(f.createImportSpecifier(false, undefined, f.createIdentifier('__bindUncertain')));
-    }
-    const hasElTemplate = clause.namedBindings.elements.some((s) => s.name.text === 'elTemplate');
-    if (!hasElTemplate && usesElTemplate) {
-        remaining.push(f.createImportSpecifier(false, undefined, f.createIdentifier('elTemplate')));
-    }
-    const hasCloneStaticTemplate = clause.namedBindings.elements.some((s) => s.name.text === '__cloneStaticTemplate');
-    if (!hasCloneStaticTemplate && usesCloneStaticTemplate) {
-        remaining.push(f.createImportSpecifier(false, undefined, f.createIdentifier('__cloneStaticTemplate')));
-    }
-    const hasMemo = clause.namedBindings.elements.some((s) => s.name.text === 'memo');
-    if (!hasMemo && usesMemo) {
-        remaining.push(f.createImportSpecifier(false, undefined, f.createIdentifier('memo')));
-    }
-    if (usesApplyBinding) {
-        if (!clause.namedBindings.elements.some((s) => s.name.text === '__runPhase2')) {
-            remaining.push(f.createImportSpecifier(false, undefined, f.createIdentifier('__runPhase2')));
-        }
-        if (!clause.namedBindings.elements.some((s) => s.name.text === '__handleMsg')) {
-            remaining.push(f.createImportSpecifier(false, undefined, f.createIdentifier('__handleMsg')));
+    // Public-surface imports stay on `from '@llui/dom'`. Compiler-emitted
+    // runtime helpers go on a separate `from '@llui/dom/internal'`
+    // declaration so the vite-plugin's post-bundle property-rename pass
+    // never rewrites an import specifier against a public export name.
+    // See emit-names.ts § COMPILER_DOM_INTERNAL_IMPORTS for the contract.
+    const namedBindings = clause.namedBindings;
+    const remaining = namedBindings.elements.filter((spec) => !compiled.has(spec.name.text));
+    const publicHas = (name) => remaining.some((s) => s.name.text === name) ||
+        namedBindings.elements.some((s) => s.name.text === name);
+    const addPublic = (name) => {
+        if (!publicHas(name)) {
+            remaining.push(f.createImportSpecifier(false, undefined, f.createIdentifier(name)));
         }
-    }
-    // The connect-pattern injector (binding-descriptors.ts) emits
-    // `__registerScopeVariants([...])` calls; ensure the runtime
-    // helper is imported when at least one was inserted.
-    const hasRegisterScopeVariants = clause.namedBindings.elements.some((s) => s.name.text === '__registerScopeVariants');
-    if (!hasRegisterScopeVariants && usesRegisterScopeVariants) {
-        remaining.push(f.createImportSpecifier(false, undefined, f.createIdentifier('__registerScopeVariants')));
-    }
-    // v0.4 size-cut (Tier 1.2): add @llui/dom imports for each primitive
-    // referenced by synthesized __view factories. `ctx` is the destructured
-    // bag name; its primitive is `useContext` (the only rename pair).
-    for (const prim of viewBagPrimitivesNeeded) {
-        if (!clause.namedBindings.elements.some((s) => s.name.text === prim)) {
-            remaining.push(f.createImportSpecifier(false, undefined, f.createIdentifier(prim)));
-        }
-    }
+    };
+    if (usesElSplit)
+        addPublic('elSplit');
+    if (usesElTemplate)
+        addPublic('elTemplate');
+    if (usesMemo)
+        addPublic('memo');
+    for (const prim of viewBagPrimitivesNeeded)
+        addPublic(prim);
+    // NOTE: the compiler-emitted internal helpers (`__bindUncertain`,
+    // `__cloneStaticTemplate`, `__runPhase2`, `__handleMsg`,
+    // `__registerScopeVariants`) are NOT added here. They live on
+    // `@llui/dom/internal`, and the outer transform pipeline inserts a
+    // separate `from '@llui/dom/internal'` import via a text-level edit
+    // (see `buildInternalImportEdit`). Inserting a new ImportDeclaration
+    // here would break the caller's per-statement origin↔transformed
+    // index pairing — the statement count would change and trailing
+    // statements would silently drop out of the edit list.
     const newBindings = f.createNamedImports(remaining);
     // New TS 6 signature: first arg is `phaseModifier` (undefined =
     // regular import; `ts.SyntaxKind.TypeKeyword` = `import type`).
@@ -1238,8 +1270,7 @@ function cleanupImports(sf, lluiImport, _helpers, compiled, usesElSplit, usesElT
             ts.isStringLiteral(stmt.moduleSpecifier) &&
             stmt.moduleSpecifier.text === '@llui/dom' &&
             // `phaseModifier === ts.SyntaxKind.TypeKeyword` is `import type
-            // …`; we only want to rewrite value imports. Replaces deprecated
-            // `isTypeOnly` from the TS<6 API.
+            // …`; we only want to rewrite value imports.
             stmt.importClause?.phaseModifier !== ts.SyntaxKind.TypeKeyword) {
             replaced = true;
             return newImportDecl;
@@ -1248,6 +1279,40 @@ function cleanupImports(sf, lluiImport, _helpers, compiled, usesElSplit, usesElT
     });
     return f.updateSourceFile(sf, statements);
 }
+/**
+ * Build a single text-insert edit that places
+ * `import { ... } from '@llui/dom/internal'` immediately after the
+ * existing `import { ... } from '@llui/dom'` statement (or appends it
+ * at the start of the file if no @llui/dom import is found, though
+ * the caller has already short-circuited in that case).
+ *
+ * Returns null when no internal helpers are needed. The edit is text-
+ * level (not AST) so it does NOT alter `transformed.statements.length`,
+ * keeping the per-statement origin↔transformed pairing intact.
+ */
+function buildInternalImportEdit(lluiImport, usesBindUncertain, usesCloneStaticTemplate, usesApplyBinding, usesRegisterScopeVariants) {
+    const names = new Set();
+    if (usesBindUncertain)
+        names.add('__bindUncertain');
+    if (usesCloneStaticTemplate)
+        names.add('__cloneStaticTemplate');
+    if (usesApplyBinding) {
+        names.add('__runPhase2');
+        names.add('__handleMsg');
+    }
+    if (usesRegisterScopeVariants)
+        names.add('__registerScopeVariants');
+    if (names.size === 0)
+        return null;
+    const sortedNames = [...names].sort();
+    const importLine = `import { ${sortedNames.join(', ')} } from '@llui/dom/internal'\n`;
+    const insertAt = lluiImport.getEnd();
+    // The lluiImport's getEnd() points to the position right after the
+    // statement's trailing `;` or `'\n'`. Emit the new import on a fresh
+    // line — `\n` prefix guarantees that even if the original import had
+    // no trailing newline.
+    return { start: insertAt, end: insertAt, replacement: '\n' + importLine };
+}
 // ── __msgSchema injection ────────────────────────────────────────
 // `injectStateSchema` was the inline emitter for `__stateSchema`.
 // Migrated to `stateSchemaModule` + the registry bridge (v2c/decomp-3).