firebase-contract 0.1.0-rc.9 → 0.1.1

package/dist/lib/_internal/generators/data-connect/operations-generator.d.ts

@@ -8,11 +8,4 @@ import { Generator } from '../generator.js';
  * `<connector>/operations.gql`. Operations without a connector go to the root.
  */
 export declare const createDataConnectOperationsGenerator: () => Generator;
-/**
- * Split variant matching the real connector layout:
- * `<connector>/operations/<entity>/{queries,mutations}.gql` (+ one
- * `operations-types.ts` per connector). Selectable alongside the single-file
- * `data-connect-operations` generator.
- */
-export declare const createDataConnectOperationsSplitGenerator: () => Generator;
 //# sourceMappingURL=operations-generator.d.ts.map

package/dist/lib/_internal/generators/data-connect/operations-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"operations-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/data-connect/operations-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAkf5E;;;;;;;GAOG;AACH,eAAO,MAAM,oCAAoC,QAAO,SAsBtD,CAAA;AAMF;;;;;GAKG;AACH,eAAO,MAAM,yCAAyC,QAAO,SAmC3D,CAAA"}
+{"version":3,"file":"operations-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/data-connect/operations-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAmf5E;;;;;;;GAOG;AACH,eAAO,MAAM,oCAAoC,QAAO,SA0BrD,CAAA"}

package/dist/lib/_internal/generators/data-connect/operations-generator.js

@@ -2,6 +2,7 @@ import { findModel } from '../../ir/ir.js';
 import { camelCase, pluralize, snakeCase } from '../support/naming.js';
 import { isRelation, relationFkName, relationFkType } from '../support/relations.js';
 import { headerBlocks } from '../support/header.js';
+import { withSplitVariant } from '../support/split-variant.js';
 const SCALAR_GQL = {
     string: 'String',
     int: 'Int',
@@ -338,7 +339,7 @@ const renderOperationGql = (ir, op, model) => {
             const rest = w.field.slice(dot + 1).split('.');
             let inner = `{ ${w.op}: ${value} }`;
             for (let i = rest.length - 1; i >= 0; i--)
-                inner = `{ ${rest[i]}: ${inner} }`.replace(/^\{ /, '{ ').replace(/ \}$/, ' }');
+                inner = `{ ${rest[i]}: ${inner} }`;
             // strip outermost braces since group renderer adds them
             group.conds.push(inner.slice(2, -2));
             group.sub = true;
@@ -473,7 +474,7 @@ const renderTsFile = (ir, entries, typesImport, context) => {
  * several connectors (`connectors: [app, api]`) and is emitted into each, under
  * `<connector>/operations.gql`. Operations without a connector go to the root.
  */
-export const createDataConnectOperationsGenerator = () => ({
+export const createDataConnectOperationsGenerator = () => withSplitVariant({
     name: 'data-connect-operations',
     description: 'Data Connect query/mutation operations (.gql + TS types), routed per connector',
     generate(ir, context) {
@@ -493,17 +494,17 @@ export const createDataConnectOperationsGenerator = () => ({
         }
         return files;
     },
-});
+}, createDataConnectOperationsSplitLayout());
 /** Entity directory name for a model: kebab-case of its table name. */
 const entityDir = (model) => (model.table ?? pluralize(snakeCase(model.name))).replace(/_/g, '-');
 /**
- * Split variant matching the real connector layout:
+ * Split layout matching the real connector repo structure:
  * `<connector>/operations/<entity>/{queries,mutations}.gql` (+ one
- * `operations-types.ts` per connector). Selectable alongside the single-file
- * `data-connect-operations` generator.
+ * `operations-types.ts` per connector). Selected via `split: true` on the
+ * `data-connect-operations` declaration.
  */
-export const createDataConnectOperationsSplitGenerator = () => ({
-    name: 'data-connect-operations-split',
+const createDataConnectOperationsSplitLayout = () => ({
+    name: 'data-connect-operations',
     description: 'Data Connect operations, one file per entity per connector',
     generate(ir, context) {
         if (ir.operations.length === 0) {

package/dist/lib/_internal/generators/firestore/firestore-projection-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"firestore-projection-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/firestore/firestore-projection-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAwF5E;;;;;;;GAOG;AACH,eAAO,MAAM,kCAAkC,QAAO,SAgBpD,CAAA"}
+{"version":3,"file":"firestore-projection-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/firestore/firestore-projection-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AA4E5E;;;;;;;GAOG;AACH,eAAO,MAAM,kCAAkC,QAAO,SAiBnD,CAAA"}

package/dist/lib/_internal/generators/firestore/firestore-projection-generator.js

@@ -1,8 +1,10 @@
-import { findModel } from '../../ir/ir.js';
+import { findFragment, findModel } from '../../ir/ir.js';
 import { singleQuote } from '../support/naming.js';
 import { isRelation, relationFkName } from '../support/relations.js';
 import { headerBlocks } from '../support/header.js';
 import { outputFile } from '../support/templates.js';
+import { withSplitVariant } from '../support/split-variant.js';
+import { createFirestoreSplitLayout } from './firestore-split-generator.js';
 // Firestore stores timestamps as dates and represents relations as resolved
 // (hashids-encoded) string ids, regardless of the Data Connect id's type.
 const SCALAR_ZOD = {
@@ -16,19 +18,6 @@ const SCALAR_ZOD = {
     json: 'z.unknown()',
     id: 'z.string()',
 };
-const META_BLOCK = [
-    'export const _Meta_OperationSchema = z.object({',
-    '  id: z.string(),',
-    '  identifierId: z.string(),',
-    '  updatedAt: z.number(),',
-    '})',
-    'export const _Meta_Schema = z.object({',
-    '  scope: z.number().nullable(),',
-    '  sys: z.number().nullable(),',
-    '  op: _Meta_OperationSchema.nullable(),',
-    '})',
-    'export type _Meta_ = z.infer<typeof _Meta_Schema>',
-].join('\n');
 const fsField = (ir, field) => {
     const name = isRelation(field) ? relationFkName(field) : field.name;
     let schema;
@@ -67,7 +56,8 @@ const effectiveFields = (ir, doc) => {
         const { name, schema } = fsField(ir, field);
         entries.set(name, schema);
     }
-    for (const field of doc.fields) {
+    const added = [...doc.fields, ...doc.extends.flatMap(name => findFragment(ir, name)?.fields ?? [])];
+    for (const field of added) {
         const { name, schema } = fsField(ir, field);
         entries.set(name, schema);
     }
@@ -80,8 +70,6 @@ const renderDoc = (ir, doc) => {
     else if (doc.description)
         lines.push(`// ${doc.description}`);
     const fields = effectiveFields(ir, doc).map(field => `  ${field.name}: ${field.schema},`);
-    if (doc.meta)
-        fields.push('  _meta_: _Meta_Schema,');
     lines.push(`export const ${doc.name}Schema = z.object({\n${fields.join('\n')}\n})`);
     lines.push(`export type ${doc.name} = z.infer<typeof ${doc.name}Schema>`);
     return lines.join('\n');
@@ -94,7 +82,7 @@ const renderDoc = (ir, doc) => {
  * add denormalized data (e.g. flattened graph edges) — mirroring a
  * hand-written Firestore schema library.
  */
-export const createFirestoreProjectionGenerator = () => ({
+export const createFirestoreProjectionGenerator = () => withSplitVariant({
     name: 'firestore',
     description: 'Firestore projection Zod schemas (derived from Data Connect models)',
     generate(ir, context) {
@@ -102,12 +90,9 @@ export const createFirestoreProjectionGenerator = () => ({
             return [];
         }
         const blocks = [...headerBlocks(context), "import { z } from 'zod'"];
-        if (ir.firestore.some(doc => doc.meta)) {
-            blocks.push(META_BLOCK);
-        }
         for (const doc of ir.firestore) {
             blocks.push(renderDoc(ir, doc));
         }
         return [{ path: outputFile(context, 'firestore.ts'), content: `${blocks.join('\n\n')}\n` }];
     },
-});
+}, createFirestoreSplitLayout());

package/dist/lib/_internal/generators/firestore/firestore-split-generator.d.ts

@@ -7,5 +7,5 @@ import { Generator } from '../generator.js';
  * the `_meta_` envelope under `firestore/_/`, and a `firestore.ts` barrel that
  * also carries the `FIRESTORE_DATABASES` constants.
  */
-export declare const createFirestoreSplitGenerator: () => Generator;
+export declare const createFirestoreSplitLayout: () => Generator;
 //# sourceMappingURL=firestore-split-generator.d.ts.map

package/dist/lib/_internal/generators/firestore/firestore-split-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"firestore-split-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/firestore/firestore-split-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAyO5E;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,QAAO,SAqI/C,CAAA"}
+{"version":3,"file":"firestore-split-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/firestore/firestore-split-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAoN5E;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,QAAO,SAiL5C,CAAA"}

package/dist/lib/_internal/generators/firestore/firestore-split-generator.js

@@ -1,10 +1,16 @@
-import { findEnum, findModel } from '../../ir/ir.js';
+import { findEnum, findFragment, findModel } from '../../ir/ir.js';
 import { zodConstraints } from '../support/constraints.js';
 import { headerBlocks } from '../support/header.js';
 import { camelCase, constantCase, pluralize, singleQuote } from '../support/naming.js';
 import { isRelation, relationFkName } from '../support/relations.js';
 import { collectDeps, kebabCase, tableNameOf } from '../support/split.js';
 import { outputFile } from '../support/templates.js';
+/** Fields spliced into a projection by its `extends` fragments (in declared order). */
+const fragmentFieldsOf = (ir, doc) => doc.extends.flatMap(name => findFragment(ir, name)?.fields ?? []);
+/** True for a placement-pinned value object (emitted at its own `out`, not co-located). */
+const isPinnedModel = (ir, name) => findModel(ir, name)?.out !== undefined;
+/** Import path (dir barrel) from a `firestore/<name>.ts` doc to a pinned model's `out` dir. */
+const pinnedImportPath = (out) => `./${out.startsWith('firestore/') ? out.slice('firestore/'.length) : out}`;
 // Projection-level scalars: timestamps become dates, ids/relations become
 // resolved (hashids-encoded) string ids.
 const SCALAR_FS = {
@@ -24,36 +30,6 @@ const SCALAR_EMBEDDED = {
     int: 'z.number().int()',
     int64: 'z.number().int()',
 };
-const META_FILE = `import { z } from 'zod'
-
-/**
- * Cloud Task 整合性管理用の operation 識別子メタ。
- * 整合性回復 (reconciliation) 処理の最新世代を表す。
- */
-export const _Meta_OperationSchema = z.object({
-  /** opId (operation id) */
-  id: z.string(),
-  /** 整合性回復処理の識別子 */
-  identifierId: z.string(),
-  /** unixtime (最終更新) */
-  updatedAt: z.number(),
-})
-export type _Meta_Operation = z.infer<typeof _Meta_OperationSchema>
-
-/**
- * 全 Firestore document に付ける整合性管理メタ。
- *
- * - \`scope\`: app hosting 経由で set される unixtime
- * - \`sys\`:   cloud functions / cloud task 経由で set される unixtime
- * - \`op\`:    cloud task で set される operation メタ
- */
-export const _Meta_Schema = z.object({
-  scope: z.number().nullable(),
-  sys: z.number().nullable(),
-  op: _Meta_OperationSchema.nullable(),
-})
-export type _Meta_ = z.infer<typeof _Meta_Schema>
-`;
 const lineComments = (description, indent) => description ? description.split('\n').map(line => `${indent}// ${line}`.trimEnd()) : [];
 const jsdoc = (description, indent) => {
     if (!description)
@@ -123,7 +99,7 @@ const renderEmbeddedModel = (ir, model) => {
     lines.push(`export type ${name} = z.infer<typeof ${name}Schema>`);
     return lines.join('\n');
 };
-// zod-split と同じ DC 側チェーン。FS 側と文字列一致するフィールドは
+// zod の split layout と同じ DC 側チェーン。FS 側と文字列一致するフィールドは
 // `.pick()` で DC スキーマから流用できる。
 const SCALAR_DC = {
     string: 'z.string()',
@@ -216,7 +192,7 @@ const effectiveFields = (ir, doc) => {
         entries.set(name, { comments: [], entry: `  ${name}: ${schema},`, name, pickable });
         roots.push(field);
     }
-    for (const field of doc.fields) {
+    for (const field of [...doc.fields, ...fragmentFieldsOf(ir, doc)]) {
         const { name, schema } = overrideFieldSchema(ir, field);
         const comments = field.jsdoc ? jsdoc(field.description, '  ') : lineComments(field.description, '  ');
         entries.set(name, { comments, entry: `  ${name}: ${schema},`, name, pickable: false });
@@ -233,8 +209,8 @@ const docModuleName = (doc) => camelCase(pluralize(doc.name));
  * the `_meta_` envelope under `firestore/_/`, and a `firestore.ts` barrel that
  * also carries the `FIRESTORE_DATABASES` constants.
  */
-export const createFirestoreSplitGenerator = () => ({
-    name: 'firestore-split',
+export const createFirestoreSplitLayout = () => ({
+    name: 'firestore',
     description: 'Firestore projection Zod schemas, one file per collection (firestore/<name>.ts + firestore.ts barrel)',
     generate(ir, context) {
         if (ir.firestore.length === 0)
@@ -249,7 +225,9 @@ export const createFirestoreSplitGenerator = () => ({
             const pseudo = { name: `__${doc.name}`, fields: roots, key: [], indexes: [] };
             const collected = collectDeps(ir, [pseudo]);
             const included = (doc.include ?? []).filter(name => !collected.models.includes(name));
-            const deps = { enums: collected.enums, models: [...included, ...collected.models] };
+            // Pinned value objects are emitted at their own `out`, never co-located.
+            const models = [...included, ...collected.models].filter(name => !isPinnedModel(ir, name));
+            const deps = { enums: collected.enums, models };
             docDeps.set(doc.name, deps);
             const moduleName = docModuleName(doc);
             for (const name of deps.enums)
@@ -285,8 +263,23 @@ export const createFirestoreSplitGenerator = () => ({
             const importLines = [...external.entries()]
                 .sort(([a], [b]) => a.localeCompare(b))
                 .map(([home, symbols]) => `import { ${[...symbols].sort().join(', ')} } from './${home}'`);
-            if (doc.meta)
-                importLines.unshift(`import { _Meta_Schema } from './_'`);
+            // Pinned value objects directly referenced by this doc: imported from their out-dir barrel.
+            const { roots } = effectiveFields(ir, doc);
+            const pinnedImports = new Map();
+            for (const field of roots) {
+                if (field.type.kind === 'model' && isPinnedModel(ir, field.type.name)) {
+                    const model = findModel(ir, field.type.name);
+                    if (!model?.out)
+                        continue;
+                    const from = pinnedImportPath(model.out);
+                    const set = pinnedImports.get(from) ?? new Set();
+                    set.add(`${fsModelName(ir, field.type.name)}Schema`);
+                    pinnedImports.set(from, set);
+                }
+            }
+            for (const [from, symbols] of [...pinnedImports.entries()].sort(([a], [b]) => a.localeCompare(b))) {
+                importLines.unshift(`import { ${[...symbols].sort().join(', ')} } from '${from}'`);
+            }
             // Fields whose Zod chain is identical to the Data Connect schema are
             // picked from it (single definition); only representation changes extend.
             const baseModel = doc.from ? findModel(ir, doc.from) : undefined;
@@ -330,8 +323,6 @@ export const createFirestoreSplitGenerator = () => ({
                     lines.push(...field.comments);
                     lines.push(field.entry);
                 }
-                if (doc.meta)
-                    lines.push('  _meta_: _Meta_Schema,');
                 lines.push('})');
             }
             else {
@@ -340,17 +331,48 @@ export const createFirestoreSplitGenerator = () => ({
                     lines.push(...field.comments);
                     lines.push(field.entry);
                 }
-                if (doc.meta)
-                    lines.push('  _meta_: _Meta_Schema,');
                 lines.push('})');
             }
             lines.push(`export type ${doc.name} = z.infer<typeof ${doc.name}Schema>`);
             blocks.push(lines.join('\n'));
             files.push({ path: `firestore/${moduleName}.ts`, content: `${blocks.join('\n\n')}\n` });
         }
-        if (ir.firestore.some(doc => doc.meta)) {
-            files.push({ path: 'firestore/_/_meta_.ts', content: META_FILE });
-            files.push({ path: 'firestore/_/index.ts', content: `export * from './_meta_'\n` });
+        // Pinned value objects: emitted at their own `out` (grouped per out+file),
+        // dependencies first, with an index barrel. These replace the former
+        // hardcoded `_meta_` envelope — the shape now lives entirely in the contract.
+        const pinDirs = [];
+        const pinGroups = new Map();
+        for (const model of ir.models) {
+            if (model.out === undefined)
+                continue;
+            const file = model.file ?? 'index.ts';
+            const key = `${model.out}${file}`;
+            const group = pinGroups.get(key) ?? { out: model.out, file, models: [] };
+            group.models.push(model);
+            pinGroups.set(key, group);
+        }
+        for (const { out, file, models } of pinGroups.values()) {
+            // Order so a referenced value object is declared before its referrer (same file).
+            const ordered = [];
+            const placed = new Set();
+            const place = (m) => {
+                if (placed.has(m.name))
+                    return;
+                placed.add(m.name);
+                for (const dep of collectDeps(ir, [m]).models) {
+                    const depModel = models.find(x => x.name === dep);
+                    if (depModel)
+                        place(depModel);
+                }
+                ordered.push(m);
+            };
+            for (const m of models)
+                place(m);
+            const body = ['import { z }' + " from 'zod'", ...ordered.map(m => renderEmbeddedModel(ir, m))].join('\n\n');
+            const base = file.replace(/\.ts$/, '');
+            files.push({ path: `${out}/${file}`, content: `${body}\n` });
+            files.push({ path: `${out}/index.ts`, content: `export * from './${base}'\n` });
+            pinDirs.push(out);
         }
         // Barrel: database name constants (when the project defines services) + re-exports.
         const barrel = [...headerBlocks(context)];
@@ -367,8 +389,8 @@ export const createFirestoreSplitGenerator = () => ({
             ].join('\n'));
         }
         const exportLines = ir.firestore.map(doc => `export * from './firestore/${docModuleName(doc)}'`);
-        if (ir.firestore.some(doc => doc.meta))
-            exportLines.push(`export * from './firestore/_'`);
+        for (const out of pinDirs)
+            exportLines.push(`export * from './${out}'`);
         barrel.push(['// Zod schema / TypeScript 型のエクスポート', ...exportLines].join('\n'));
         files.push({ path: outputFile(context, 'firestore.ts'), content: `${barrel.join('\n\n')}\n` });
         return files;

package/dist/lib/_internal/generators/generator.d.ts

@@ -50,6 +50,8 @@ export interface Generator {
         file: string;
         split: boolean;
     };
+    /** Document scope: true when `split: true` switches to a per-item file layout. */
+    readonly splittable?: boolean;
     generate(ir: Ir, context?: GeneratorContext): GeneratedFile[];
 }
 /** Narrow `ir.apis` to the compiler-selected subset (no-op without a filter). */

package/dist/lib/_internal/generators/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/generators/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAEhC,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,uBAAuB,CAAA;CACjC;AAED,+EAA+E;AAC/E,MAAM,WAAW,uBAAuB;IACtC,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,UAAU,CAAA;IACnC,qFAAqF;IACrF,QAAQ,CAAC,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAA;IACzD,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,aAAa,EAAE,CAAA;CAC9D;AAED,iFAAiF;AACjF,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,CAAC,EAAE,EAAE,UAAU,gBAAgB,KAAG,CAAC,EAI/F,CAAA"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/generators/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAEhC,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,uBAAuB,CAAA;CACjC;AAED,+EAA+E;AAC/E,MAAM,WAAW,uBAAuB;IACtC,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,UAAU,CAAA;IACnC,qFAAqF;IACrF,QAAQ,CAAC,aAAa,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAA;IACzD,kFAAkF;IAClF,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,aAAa,EAAE,CAAA;CAC9D;AAED,iFAAiF;AACjF,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,CAAC,EAAE,EAAE,UAAU,gBAAgB,KAAG,CAAC,EAI/F,CAAA"}

package/dist/lib/_internal/generators/index.d.ts

@@ -2,17 +2,14 @@ import { GeneratorRegistry } from './registry.js';
 export type { GeneratedFile, Generator, GeneratorContext } from './generator.js';
 export { GeneratorRegistry } from './registry.js';
 export { createTypeScriptGenerator } from './typescript/typescript-generator.js';
-export { createTypeScriptSplitGenerator } from './typescript/typescript-split-generator.js';
 export type { TypeScriptGeneratorOptions } from './typescript/typescript-generator.js';
 export { createZodGenerator } from './zod/zod-generator.js';
-export { createZodSplitGenerator } from './zod/zod-split-generator.js';
-export { createDataConnectGraphqlGenerator, createDataConnectGraphqlSplitGenerator } from './data-connect/graphql-generator.js';
+export { createDataConnectGraphqlGenerator } from './data-connect/graphql-generator.js';
 export { createDataConnectAdapterGenerator } from './data-connect/adapter-generator.js';
-export { createDataConnectOperationsGenerator, createDataConnectOperationsSplitGenerator } from './data-connect/operations-generator.js';
+export { createDataConnectOperationsGenerator } from './data-connect/operations-generator.js';
 export { createFirestoreTypeGenerator } from './firestore/firestore-type-generator.js';
 export type { FirestoreGeneratorOptions } from './firestore/firestore-type-generator.js';
 export { createFirestoreProjectionGenerator } from './firestore/firestore-projection-generator.js';
-export { createFirestoreSplitGenerator } from './firestore/firestore-split-generator.js';
 export { createApiTypesGenerator } from './api/api-types-generator.js';
 export { createApiValidationGenerator } from './api/api-validation-generator.js';
 export { createApiDtoGenerator } from './api/api-dto-generator.js';

package/dist/lib/_internal/generators/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/generators/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAMjD,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAA;AAChF,OAAO,EAAE,8BAA8B,EAAE,MAAM,4CAA4C,CAAA;AAC3F,YAAY,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAA;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,OAAO,EAAE,iCAAiC,EAAE,sCAAsC,EAAE,MAAM,qCAAqC,CAAA;AAC/H,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAA;AACvF,OAAO,EAAE,oCAAoC,EAAE,yCAAyC,EAAE,MAAM,wCAAwC,CAAA;AACxI,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAA;AACtF,YAAY,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAA;AACxF,OAAO,EAAE,kCAAkC,EAAE,MAAM,+CAA+C,CAAA;AAClG,OAAO,EAAE,6BAA6B,EAAE,MAAM,0CAA0C,CAAA;AACxF,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAA;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAA;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACnE,YAAY,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AAEpE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAO,iBAqBH,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/generators/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAIjD,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAA;AAChF,YAAY,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAA;AACtF,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAA;AACvF,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAA;AACvF,OAAO,EAAE,oCAAoC,EAAE,MAAM,wCAAwC,CAAA;AAC7F,OAAO,EAAE,4BAA4B,EAAE,MAAM,yCAAyC,CAAA;AACtF,YAAY,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAA;AACxF,OAAO,EAAE,kCAAkC,EAAE,MAAM,+CAA+C,CAAA;AAClG,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAA;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAA;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAA;AAC9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACnE,YAAY,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAA;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AAEpE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAO,iBAgBH,CAAA"}

package/dist/lib/_internal/generators/index.js

@@ -4,30 +4,24 @@ import { createApiValidationGenerator } from './api/api-validation-generator.js'
 import { createTaskPayloadGenerator } from './api/task-payload-generator.js';
 import { createConfigGenerator } from './config/config-generator.js';
 import { createDataConnectAdapterGenerator } from './data-connect/adapter-generator.js';
-import { createDataConnectGraphqlGenerator, createDataConnectGraphqlSplitGenerator } from './data-connect/graphql-generator.js';
-import { createDataConnectOperationsGenerator, createDataConnectOperationsSplitGenerator } from './data-connect/operations-generator.js';
+import { createDataConnectGraphqlGenerator } from './data-connect/graphql-generator.js';
+import { createDataConnectOperationsGenerator } from './data-connect/operations-generator.js';
 import { createFirestoreProjectionGenerator } from './firestore/firestore-projection-generator.js';
-import { createFirestoreSplitGenerator } from './firestore/firestore-split-generator.js';
 import { createFirestoreTypeGenerator } from './firestore/firestore-type-generator.js';
 import { createIdCodecGenerator } from './id/id-codec-generator.js';
 import { createSqlMigrationGenerator } from './sql/sql-migration-generator.js';
 import { createUnionGenerator } from './union/union-generator.js';
 import { GeneratorRegistry } from './registry.js';
 import { createTypeScriptGenerator } from './typescript/typescript-generator.js';
-import { createTypeScriptSplitGenerator } from './typescript/typescript-split-generator.js';
 import { createZodGenerator } from './zod/zod-generator.js';
-import { createZodSplitGenerator } from './zod/zod-split-generator.js';
 export { GeneratorRegistry } from './registry.js';
 export { createTypeScriptGenerator } from './typescript/typescript-generator.js';
-export { createTypeScriptSplitGenerator } from './typescript/typescript-split-generator.js';
 export { createZodGenerator } from './zod/zod-generator.js';
-export { createZodSplitGenerator } from './zod/zod-split-generator.js';
-export { createDataConnectGraphqlGenerator, createDataConnectGraphqlSplitGenerator } from './data-connect/graphql-generator.js';
+export { createDataConnectGraphqlGenerator } from './data-connect/graphql-generator.js';
 export { createDataConnectAdapterGenerator } from './data-connect/adapter-generator.js';
-export { createDataConnectOperationsGenerator, createDataConnectOperationsSplitGenerator } from './data-connect/operations-generator.js';
+export { createDataConnectOperationsGenerator } from './data-connect/operations-generator.js';
 export { createFirestoreTypeGenerator } from './firestore/firestore-type-generator.js';
 export { createFirestoreProjectionGenerator } from './firestore/firestore-projection-generator.js';
-export { createFirestoreSplitGenerator } from './firestore/firestore-split-generator.js';
 export { createApiTypesGenerator } from './api/api-types-generator.js';
 export { createApiValidationGenerator } from './api/api-validation-generator.js';
 export { createApiDtoGenerator } from './api/api-dto-generator.js';
@@ -43,17 +37,12 @@ export { createConfigGenerator } from './config/config-generator.js';
  */
 export const createDefaultRegistry = () => new GeneratorRegistry()
     .register(createTypeScriptGenerator())
-    .register(createTypeScriptSplitGenerator())
     .register(createZodGenerator())
-    .register(createZodSplitGenerator())
     .register(createDataConnectGraphqlGenerator())
-    .register(createDataConnectGraphqlSplitGenerator())
     .register(createDataConnectOperationsGenerator())
-    .register(createDataConnectOperationsSplitGenerator())
     .register(createDataConnectAdapterGenerator())
     .register(createFirestoreTypeGenerator())
     .register(createFirestoreProjectionGenerator())
-    .register(createFirestoreSplitGenerator())
     .register(createApiTypesGenerator())
     .register(createApiValidationGenerator())
     .register(createApiDtoGenerator())

package/dist/lib/_internal/generators/support/jsdoc.d.ts

@@ -0,0 +1,3 @@
+/** Render a JSDoc block for a possibly multi-line description ('' when absent). */
+export declare const jsdoc: (description: string | undefined, indent: string) => string;
+//# sourceMappingURL=jsdoc.d.ts.map

package/dist/lib/_internal/generators/support/jsdoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsdoc.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/support/jsdoc.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,eAAO,MAAM,KAAK,GAAI,aAAa,MAAM,GAAG,SAAS,EAAE,QAAQ,MAAM,KAAG,MAKvE,CAAA"}

package/dist/lib/_internal/generators/support/jsdoc.js

@@ -0,0 +1,9 @@
+/** Render a JSDoc block for a possibly multi-line description ('' when absent). */
+export const jsdoc = (description, indent) => {
+    if (!description)
+        return '';
+    const lines = description.split('\n');
+    if (lines.length === 1)
+        return `${indent}/** ${lines[0]} */\n`;
+    return `${indent}/**\n${lines.map(line => `${indent} * ${line}`.trimEnd()).join('\n')}\n${indent} */\n`;
+};

package/dist/lib/_internal/generators/support/split-variant.d.ts

@@ -0,0 +1,9 @@
+import { Generator } from '../generator.js';
+/**
+ * Merge a single-file generator and its per-item split layout into ONE
+ * registry entry: `split: true` in the declaration routes to the split
+ * implementation, everything else (name, description, defaults) comes from
+ * the base. Keeps "one concern = one generator id" in the YAML surface.
+ */
+export declare const withSplitVariant: (base: Generator, splitVariant: Generator) => Generator;
+//# sourceMappingURL=split-variant.d.ts.map

package/dist/lib/_internal/generators/support/split-variant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split-variant.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/support/split-variant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,SAAS,EAAE,cAAc,SAAS,KAAG,SAM1E,CAAA"}

package/dist/lib/_internal/generators/support/split-variant.js

@@ -0,0 +1,13 @@
+/**
+ * Merge a single-file generator and its per-item split layout into ONE
+ * registry entry: `split: true` in the declaration routes to the split
+ * implementation, everything else (name, description, defaults) comes from
+ * the base. Keeps "one concern = one generator id" in the YAML surface.
+ */
+export const withSplitVariant = (base, splitVariant) => ({
+    ...base,
+    splittable: true,
+    generate(ir, context) {
+        return (context?.output?.split ? splitVariant : base).generate(ir, context);
+    },
+});

package/dist/lib/_internal/generators/support/split.d.ts

@@ -18,7 +18,7 @@ export declare const collectDeps: (ir: Ir, roots: IrModel[]) => HostedDeps;
 /**
  * Assign a unique module basename to every table. Two models may share a
  * physical table name across services (e.g. both declare
- * `reconciliation_operations`); the first keeps the table-derived name and
+ * `audit_logs`); the first keeps the table-derived name and
  * later ones fall back to their model name so files never overwrite each other.
  */
 export declare const assignModuleNames: (tables: IrModel[]) => Map<string, string>;

package/dist/lib/_internal/generators/support/split.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"split.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/support/split.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,EAAE,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAIvD,qEAAqE;AACrE,eAAO,MAAM,OAAO,GAAI,OAAO,OAAO,KAAG,OAAiE,CAAA;AAE1G,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,MAAyD,CAAA;AAEtG,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,MAA6C,CAAA;AAavF,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,8DAA8D;IAC9D,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,IAAI,EAAE,EAAE,OAAO,OAAO,EAAE,KAAG,UAuBtD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,OAAO,EAAE,KAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAavE,CAAA;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,2CAA2C;IAC3C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,qDAAqD;IACrD,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,oDAAoD;IACpD,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,IAAI,EAAE,KAAG,WAepC,CAAA"}
+{"version":3,"file":"split.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/support/split.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,EAAE,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAIvD,qEAAqE;AACrE,eAAO,MAAM,OAAO,GAAI,OAAO,OAAO,KAAG,OAAiE,CAAA;AAE1G,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,MAAyD,CAAA;AAEtG,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,MAA6C,CAAA;AAavF,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,8DAA8D;IAC9D,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,IAAI,EAAE,EAAE,OAAO,OAAO,EAAE,KAAG,UAuBtD,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,OAAO,EAAE,KAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAavE,CAAA;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,2CAA2C;IAC3C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,qDAAqD;IACrD,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,oDAAoD;IACpD,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,IAAI,EAAE,KAAG,WAgBpC,CAAA"}

package/dist/lib/_internal/generators/support/split.js

@@ -52,7 +52,7 @@ export const collectDeps = (ir, roots) => {
 /**
  * Assign a unique module basename to every table. Two models may share a
  * physical table name across services (e.g. both declare
- * `reconciliation_operations`); the first keeps the table-derived name and
+ * `audit_logs`); the first keeps the table-derived name and
  * later ones fall back to their model name so files never overwrite each other.
  */
 export const assignModuleNames = (tables) => {
@@ -90,7 +90,8 @@ export const splitGroups = (ir) => {
     }
     const leftoverEnums = ir.enums.map(e => e.name).filter(name => !enumHome.has(name));
     const leftoverModels = ir.models
-        .filter(model => !isTable(model))
+        // Pinned value objects are emitted at their own `out`, never in the default barrels.
+        .filter(model => !isTable(model) && model.out === undefined)
         .map(model => model.name)
         .filter(name => !modelHome.has(name));
     return { tables, enumHome, modelHome, leftoverEnums, leftoverModels };

package/dist/lib/_internal/generators/typescript/render.d.ts

@@ -0,0 +1,15 @@
+import { Ir, IrEnum, IrField, IrModel, ScalarType } from '../../ir/ir.js';
+/**
+ * Rendering shared by the bundled and split TypeScript layouts. Both layouts
+ * MUST go through these helpers so a contract setting (valueKeys, nullable,
+ * multi-line descriptions, …) means the same thing regardless of layout.
+ */
+export declare const SCALAR_TS: Record<ScalarType, string>;
+export declare const JSON_TYPE: string;
+export declare const docLines: (description: string | undefined, indent: string) => string[];
+export declare const renderField: (field: IrField, ir: Ir) => string;
+export declare const renderEnumConst: (irEnum: IrEnum) => string;
+export declare const renderEnumUnion: (irEnum: IrEnum) => string;
+export declare const renderModel: (model: IrModel, ir: Ir) => string;
+export declare const usesJson: (models: IrModel[]) => boolean;
+//# sourceMappingURL=render.d.ts.map

package/dist/lib/_internal/generators/typescript/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/typescript/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAa,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAIpF;;;;GAIG;AAEH,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAUhD,CAAA;AAED,eAAO,MAAM,SAAS,QAQV,CAAA;AAcZ,eAAO,MAAM,QAAQ,GAAI,aAAa,MAAM,GAAG,SAAS,EAAE,QAAQ,MAAM,KAAG,MAAM,EAKhF,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,EAAE,IAAI,EAAE,KAAG,MAiBpD,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAchD,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAIhD,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,EAAE,IAAI,EAAE,KAAG,MAIpD,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,QAAQ,OAAO,EAAE,KAAG,OACiE,CAAA"}