@angriff36/manifest 2.18.0

package/dist/manifest/projections/kysely/generator.js

@@ -0,0 +1,325 @@
+/**
+ * Kysely Type-Safe Query Builder projection.
+ *
+ * Consumes Manifest IR + projection config and emits a Kysely-compatible
+ * TypeScript types file as a single `ProjectionArtifact`.
+ *
+ * Kysely (https://kysely.dev) is a type-safe SQL query builder for TypeScript.
+ * Unlike Prisma or Drizzle, Kysely does NOT manage schema migrations or
+ * generate DDL. Instead, it provides compile-time type safety by mapping
+ * table names to row interfaces via a `Database` interface.
+ *
+ * This projection generates:
+ *   1. A per-table TypeScript interface (e.g., `TaskTable`)
+ *   2. A `Database` interface mapping table names to those interfaces
+ *   3. A factory function for creating a configured `Kysely<Database>` instance
+ *
+ * Boundary rules (following Prisma/Drizzle projection conventions):
+ *   - Relational interpretation starts HERE. No relational concept (table
+ *     name, column name) lives in Manifest core grammar or IR — all of it
+ *     arrives via projection options.
+ *   - The projection carries NO knowledge of any specific application,
+ *     database instance, tenant layout, table naming scheme, or domain
+ *     meaning of any field.
+ *   - `computed` properties are derived and MUST NEVER become columns.
+ *   - `external: true` entities are skipped. Non-SQL store targets are skipped.
+ *   - Unknown `type.name` produces a hard error diagnostic. No fallback.
+ */
+import { normalizeOptions } from './options.js';
+import { resolveKyselyColumnType, dialectClassName, dialectConfigTypeName, } from './type-mapping.js';
+// ============================================================================
+// Surface identifiers
+// ============================================================================
+const SURFACE_TYPES = 'kysely.types';
+const SURFACES = [SURFACE_TYPES];
+// ============================================================================
+// Store target classification
+// ============================================================================
+/**
+ * Store targets the Kysely projection considers eligible for type emission.
+ * Kysely works with SQL databases, so only SQL-compatible targets qualify.
+ * 'durable' is the backend-neutral signal for "any SQL store".
+ */
+const KYSELY_COMPATIBLE_TARGETS = new Set([
+    'durable',
+    'postgres',
+    'supabase',
+    'turso',
+]);
+function isKyselyCompatible(target) {
+    return KYSELY_COMPATIBLE_TARGETS.has(target);
+}
+/**
+ * Emit a single Kysely column type line for an IR property.
+ *
+ * Example output:
+ *   id: Generated<string>;
+ *   name: string;
+ *   qty: number | null;
+ *   createdAt: ColumnType<Date, Date | string | undefined, Date | string>;
+ */
+function emitPropertyColumn(entity, prop, ir, options) {
+    const diagnostics = [];
+    const isArray = prop.type.name === 'array' && prop.type.generic;
+    const effectiveTypeName = isArray ? prop.type.generic.name : prop.type.name;
+    const isValueObject = ir.values?.some(v => v.name === effectiveTypeName);
+    const typeOverrides = isValueObject ? undefined : options.typeMappings?.[entity.name];
+    const hasOverride = typeOverrides !== undefined
+        && Object.prototype.hasOwnProperty.call(typeOverrides, prop.name);
+    const colType = isValueObject
+        ? { tsType: 'unknown' }
+        : resolveKyselyColumnType(effectiveTypeName, typeOverrides, prop.name);
+    if (!colType) {
+        if (effectiveTypeName === 'number' && !hasOverride) {
+            diagnostics.push({
+                severity: 'error',
+                code: 'KYSELY_AMBIGUOUS_NUMBER',
+                entity: entity.name,
+                message: `Property '${entity.name}.${prop.name}' is typed 'number', which is ambiguous (Manifest does not ` +
+                    `distinguish integers from real numbers from money). Pick a precise type in the .manifest source: ` +
+                    `'int' or 'bigint' for counts and ids, 'float' for measurements where rounding is acceptable, ` +
+                    `'money' or 'decimal' for currency and other exact-decimal values. ` +
+                    `Or supply a 'typeMappings.${entity.name}.${prop.name}' override.`,
+            });
+            return { line: null, diagnostics };
+        }
+        diagnostics.push({
+            severity: 'error',
+            code: 'KYSELY_UNKNOWN_TYPE',
+            entity: entity.name,
+            message: `Property '${entity.name}.${prop.name}' has IR type '${effectiveTypeName}' which is not in the default type mapping ` +
+                `and no override was supplied in 'typeMappings.${entity.name}.${prop.name}'. ` +
+                `Add an entry to typeMappings, or change the property type in the .manifest source.`,
+        });
+        return { line: null, diagnostics };
+    }
+    const hasCompositeKey = entity.key && entity.key.length > 0;
+    const isId = prop.name === 'id' && !hasCompositeKey;
+    // For array types, only the type's nullable flag controls array nullability.
+    // For scalar types, both the type's nullable flag and the absence of 'required'
+    // modifier contribute.
+    const isNullable = isArray
+        ? prop.type.nullable
+        : (prop.type.nullable || !prop.modifiers.includes('required'));
+    // Determine if this column should use Generated<T>
+    // Generated<T> is used for columns with database-side defaults:
+    // - id columns (auto-generated IDs)
+    // - columns with defaultValue
+    const useGenerated = isId || (prop.defaultValue !== undefined);
+    // Determine if this column should use ColumnType for select/insert/update transforms
+    const useColumnType = colType.columnType === true;
+    // Build the TypeScript type expression
+    let tsExpr;
+    if (useColumnType) {
+        // ColumnType<SelectType, InsertType, UpdateType>
+        // For Date columns, allow Date | string on insert/update
+        tsExpr = `ColumnType<${colType.tsType}, ${colType.tsType} | string | undefined, ${colType.tsType} | string>`;
+    }
+    else if (useGenerated) {
+        tsExpr = `Generated<${colType.tsType}>`;
+    }
+    else {
+        tsExpr = colType.tsType;
+    }
+    // For array types, wrap in array before adding nullable marker
+    if (isArray) {
+        tsExpr = `${tsExpr}[]`;
+    }
+    // Add nullable marker (after array wrapping for correct precedence)
+    if (isNullable && !useGenerated) {
+        tsExpr = `${tsExpr} | null`;
+    }
+    return {
+        line: `  ${prop.name}: ${tsExpr};`,
+        diagnostics,
+    };
+}
+function emitTableInterface(entity, ir, options) {
+    const diagnostics = [];
+    const columns = [];
+    // Emit properties (never computedProperties)
+    for (const prop of entity.properties) {
+        const { line, diagnostics: propDiags } = emitPropertyColumn(entity, prop, ir, options);
+        diagnostics.push(...propDiags);
+        if (line !== null)
+            columns.push(line);
+    }
+    // Emit FK columns from belongsTo/ref relationships
+    for (const rel of entity.relationships) {
+        if (rel.kind === 'belongsTo' || rel.kind === 'ref') {
+            const fkField = rel.foreignKey?.fields?.[0] ?? `${rel.name}Id`;
+            // Check if FK field is already declared as a property
+            const fkAlreadyDeclared = entity.properties.some((p) => p.name === fkField);
+            if (!fkAlreadyDeclared) {
+                // Look up the target entity's id type
+                const targetEntity = ir.entities.find((e) => e.name === rel.target);
+                const targetIdProp = targetEntity?.properties.find((p) => p.name === 'id');
+                const fkTsType = targetIdProp
+                    ? resolveKyselyColumnType(targetIdProp.type.name, undefined, targetIdProp.name)?.tsType ?? 'string'
+                    : 'string';
+                const refNullable = targetIdProp?.type.nullable ?? false;
+                const tsExpr = refNullable ? `${fkTsType} | null` : fkTsType;
+                columns.push(`  ${fkField}: ${tsExpr};`);
+            }
+        }
+    }
+    const tableName = options.tableMappings?.[entity.name] ?? entity.name.toLowerCase();
+    const interfaceName = `${entity.name}Table`;
+    let interfaceCode = `export interface ${interfaceName} {\n${columns.join('\n')}\n}`;
+    // Add composite key comment
+    const hasCompositeKey = entity.key && entity.key.length > 0;
+    if (hasCompositeKey) {
+        interfaceCode = `// Composite primary key: [${entity.key.join(', ')}]\nexport interface ${interfaceName} {\n${columns.join('\n')}\n}`;
+    }
+    return { interfaceCode, tableName, diagnostics };
+}
+// ============================================================================
+// Projection target
+// ============================================================================
+export class KyselyProjection {
+    name = 'kysely';
+    description = 'Manifest IR → Kysely Type-Safe Query Builder types projection. Generates Database interface and per-table row types for Kysely query building.';
+    surfaces = SURFACES;
+    generate(ir, request) {
+        if (request.surface !== SURFACE_TYPES) {
+            return {
+                artifacts: [],
+                diagnostics: [
+                    {
+                        severity: 'error',
+                        code: 'UNKNOWN_SURFACE',
+                        message: `Unknown surface '${request.surface}'. Available: ${SURFACES.join(', ')}.`,
+                    },
+                ],
+            };
+        }
+        const options = normalizeOptions(request.options);
+        const diagnostics = [];
+        const dialect = (options.dialect ?? 'postgresql');
+        const storeByEntity = new Map();
+        for (const s of ir.stores)
+            storeByEntity.set(s.entity, s.target);
+        const toEmit = [];
+        const emittedEntities = new Set();
+        for (const entity of ir.entities) {
+            if (entity.external === true) {
+                diagnostics.push({
+                    severity: 'info',
+                    code: 'KYSELY_SKIPPED_EXTERNAL',
+                    entity: entity.name,
+                    message: `Entity '${entity.name}' is marked external; skipped.`,
+                });
+                continue;
+            }
+            const target = storeByEntity.get(entity.name);
+            if (target === undefined) {
+                diagnostics.push({
+                    severity: 'info',
+                    code: 'KYSELY_SKIPPED_NO_STORE',
+                    entity: entity.name,
+                    message: `Entity '${entity.name}' has no 'store' declaration; skipped.`,
+                });
+                continue;
+            }
+            if (!isKyselyCompatible(target)) {
+                diagnostics.push({
+                    severity: 'info',
+                    code: 'KYSELY_SKIPPED_INCOMPATIBLE',
+                    entity: entity.name,
+                    message: `Entity '${entity.name}' has store target '${target}' which is not SQL-compatible; skipped.`,
+                });
+                continue;
+            }
+            toEmit.push(entity);
+            emittedEntities.add(entity.name);
+        }
+        // Emit per-table interfaces
+        const tableInterfaces = [];
+        const dbMappings = [];
+        for (const entity of toEmit) {
+            const { interfaceCode, tableName, diagnostics: tableDiags } = emitTableInterface(entity, ir, options);
+            diagnostics.push(...tableDiags);
+            if (interfaceCode) {
+                tableInterfaces.push(interfaceCode);
+            }
+            // Map table name → interface in the Database interface
+            const propName = tableName; // e.g., "task", "user"
+            const interfaceName = `${entity.name}Table`;
+            dbMappings.push(`  ${propName}: ${interfaceName};`);
+        }
+        // Determine if we need Generated, ColumnType imports
+        const needsGenerated = toEmit.some((entity) => entity.properties.some((p) => p.name === 'id' || p.defaultValue !== undefined));
+        const needsColumnType = toEmit.some((entity) => entity.properties.some((p) => {
+            const effectiveTypeName = p.type.name === 'array' && p.type.generic
+                ? p.type.generic.name
+                : p.type.name;
+            return effectiveTypeName === 'date' || effectiveTypeName === 'datetime';
+        }));
+        // Build the header
+        const header = [
+            '// Auto-generated by @manifest/projection-kysely',
+            '// DO NOT EDIT — regenerate with the projection.',
+            '',
+        ];
+        // Type-only imports
+        const typeImports = [];
+        if (needsGenerated)
+            typeImports.push('Generated');
+        if (needsColumnType)
+            typeImports.push('ColumnType');
+        if (typeImports.length > 0) {
+            header.push(`import type { ${typeImports.join(', ')} } from 'kysely';`);
+        }
+        // Runtime imports for factory
+        if (options.emitFactory && toEmit.length > 0) {
+            const cls = dialectClassName(dialect);
+            header.push(`import { Kysely, ${cls} } from 'kysely';`);
+        }
+        header.push('');
+        const codeParts = [header.join('\n')];
+        if (tableInterfaces.length > 0) {
+            codeParts.push('// ============================================================================');
+            codeParts.push('// Table interfaces');
+            codeParts.push('// ============================================================================');
+            codeParts.push('');
+            codeParts.push(tableInterfaces.join('\n\n'));
+            codeParts.push('');
+        }
+        // Database interface
+        if (dbMappings.length > 0) {
+            codeParts.push('// ============================================================================');
+            codeParts.push('// Database interface');
+            codeParts.push('// ============================================================================');
+            codeParts.push('');
+            codeParts.push(`export interface ${options.databaseInterfaceName} {`);
+            codeParts.push(dbMappings.join('\n'));
+            codeParts.push('}');
+            codeParts.push('');
+        }
+        // Factory function
+        if (options.emitFactory && toEmit.length > 0) {
+            codeParts.push('// ============================================================================');
+            codeParts.push('// Kysely instance factory');
+            codeParts.push('// ============================================================================');
+            codeParts.push('');
+            const cls = dialectClassName(dialect);
+            const configType = dialectConfigTypeName(dialect);
+            codeParts.push(`export function ${options.factoryFunctionName}(config: ${configType}): Kysely<${options.databaseInterfaceName}> {`);
+            codeParts.push(`  return new Kysely<${options.databaseInterfaceName}>({`);
+            codeParts.push(`    dialect: new ${cls}(config),`);
+            codeParts.push(`  });`);
+            codeParts.push(`}`);
+        }
+        const code = codeParts.join('\n');
+        const artifacts = [
+            {
+                id: 'kysely.types',
+                pathHint: options.output,
+                contentType: 'typescript',
+                code,
+            },
+        ];
+        return { artifacts, diagnostics };
+    }
+}
+//# sourceMappingURL=generator.js.map

package/dist/manifest/projections/kysely/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../src/manifest/projections/kysely/generator.ts"],"names":[],"mappings":"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"}

package/dist/manifest/projections/kysely/index.d.ts

@@ -0,0 +1,4 @@
+export { KyselyProjection } from './generator.js';
+export type { KyselyProjectionOptions } from './options.js';
+export type { KyselyDialect, KyselyColumnType } from './type-mapping.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/manifest/projections/kysely/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/manifest/projections/kysely/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/manifest/projections/kysely/index.js

@@ -0,0 +1,2 @@
+export { KyselyProjection } from './generator.js';
+//# sourceMappingURL=index.js.map

package/dist/manifest/projections/kysely/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/manifest/projections/kysely/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/manifest/projections/kysely/options.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Configuration surface for the Kysely projection.
+ *
+ * Every relational concept (table name, column name) is supplied here at
+ * projection time. NONE of these enter Manifest core grammar or IR.
+ * The projection translates IR + this options bag into a Kysely types artifact.
+ */
+/** Entity name as it appears in IR (`IREntity.name`). */
+export type EntityName = string;
+/** Property name as it appears in IR (`IRProperty.name`). */
+export type PropertyName = string;
+export interface KyselyProjectionOptions {
+    /**
+     * Kysely dialect. Controls which dialect import and factory function are emitted.
+     * Default: 'postgresql'.
+     */
+    dialect?: 'postgresql' | 'mysql' | 'sqlite';
+    /**
+     * Per-entity table-name override.
+     *   tableMappings: { Widget: "widgets" }
+     * → emits `task: TaskTable;` mapped to table "widgets" in the Database interface.
+     */
+    tableMappings?: Record<EntityName, string>;
+    /**
+     * Per-entity, per-property column-name override.
+     *   columnMappings: { Widget: { createdAt: "created_at" } }
+     * → emits `createdAt: Date;` in the interface with a comment noting the actual column name.
+     */
+    columnMappings?: Record<EntityName, Record<PropertyName, string>>;
+    /**
+     * Per-entity, per-property type override. Bypasses the default
+     * IR-`type.name` → Kysely-type mapping. The value is the *literal* TypeScript
+     * type expression (e.g. `"string"`, `"number"`, `"Date"`, `"MyCustomType"`).
+     */
+    typeMappings?: Record<EntityName, Record<PropertyName, string>>;
+    /**
+     * Whether to emit a `createDb()` factory function in the output.
+     * Default: true.
+     */
+    emitFactory?: boolean;
+    /**
+     * Name of the generated Database interface.
+     * Default: 'DB'.
+     */
+    databaseInterfaceName?: string;
+    /**
+     * Name of the generated factory function.
+     * Default: 'createDb'.
+     */
+    factoryFunctionName?: string;
+    /**
+     * Output path hint for the emitted artifact. Default: 'kysely.types.ts'.
+     */
+    output?: string;
+}
+export declare const KYSELY_PROJECTION_DEFAULTS: Required<Pick<KyselyProjectionOptions, 'dialect' | 'emitFactory' | 'databaseInterfaceName' | 'factoryFunctionName' | 'output'>>;
+/**
+ * Normalize a raw `request.options` bag into a fully-typed options object.
+ */
+export declare function normalizeOptions(raw: Record<string, unknown> | undefined): KyselyProjectionOptions;
+//# sourceMappingURL=options.d.ts.map

package/dist/manifest/projections/kysely/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../../../src/manifest/projections/kysely/options.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,yDAAyD;AACzD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAChC,6DAA6D;AAC7D,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;IAE5C;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAE3C;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAElE;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;IAEhE;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAAC,IAAI,CAAC,uBAAuB,EAC5E,SAAS,GAAG,aAAa,GAAG,uBAAuB,GAAG,qBAAqB,GAAG,QAAQ,CACvF,CAMS,CAAC;AAEX;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,uBAAuB,CAYlG"}

package/dist/manifest/projections/kysely/options.js

@@ -0,0 +1,31 @@
+/**
+ * Configuration surface for the Kysely projection.
+ *
+ * Every relational concept (table name, column name) is supplied here at
+ * projection time. NONE of these enter Manifest core grammar or IR.
+ * The projection translates IR + this options bag into a Kysely types artifact.
+ */
+export const KYSELY_PROJECTION_DEFAULTS = {
+    dialect: 'postgresql',
+    emitFactory: true,
+    databaseInterfaceName: 'DB',
+    factoryFunctionName: 'createDb',
+    output: 'kysely.types.ts',
+};
+/**
+ * Normalize a raw `request.options` bag into a fully-typed options object.
+ */
+export function normalizeOptions(raw) {
+    const input = (raw ?? {});
+    return {
+        dialect: input.dialect ?? KYSELY_PROJECTION_DEFAULTS.dialect,
+        tableMappings: input.tableMappings ?? {},
+        columnMappings: input.columnMappings ?? {},
+        typeMappings: input.typeMappings ?? {},
+        emitFactory: input.emitFactory ?? KYSELY_PROJECTION_DEFAULTS.emitFactory,
+        databaseInterfaceName: input.databaseInterfaceName ?? KYSELY_PROJECTION_DEFAULTS.databaseInterfaceName,
+        factoryFunctionName: input.factoryFunctionName ?? KYSELY_PROJECTION_DEFAULTS.factoryFunctionName,
+        output: input.output ?? KYSELY_PROJECTION_DEFAULTS.output,
+    };
+}
+//# sourceMappingURL=options.js.map

package/dist/manifest/projections/kysely/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../../src/manifest/projections/kysely/options.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA2DH,MAAM,CAAC,MAAM,0BAA0B,GAElC;IACH,OAAO,EAAE,YAAY;IACrB,WAAW,EAAE,IAAI;IACjB,qBAAqB,EAAE,IAAI;IAC3B,mBAAmB,EAAE,UAAU;IAC/B,MAAM,EAAE,iBAAiB;CACjB,CAAC;AAEX;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAwC;IACvE,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,EAAE,CAAqC,CAAC;IAC9D,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,0BAA0B,CAAC,OAAO;QAC5D,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,EAAE;QACxC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,EAAE;QAC1C,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,EAAE;QACtC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,0BAA0B,CAAC,WAAW;QACxE,qBAAqB,EAAE,KAAK,CAAC,qBAAqB,IAAI,0BAA0B,CAAC,qBAAqB;QACtG,mBAAmB,EAAE,KAAK,CAAC,mBAAmB,IAAI,0BAA0B,CAAC,mBAAmB;QAChG,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,0BAA0B,CAAC,MAAM;KAC1D,CAAC;AACJ,CAAC"}

package/dist/manifest/projections/kysely/type-mapping.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Default mapping from IR `type.name` strings to Kysely TypeScript column types.
+ *
+ * This table is the projection's sole interpreter of Manifest's open
+ * type vocabulary for Kysely. The projection knows what any given
+ * IR type name means for Kysely; nothing upstream carries Kysely knowledge.
+ *
+ * Kysely uses a `Database` interface where each table is a row type. Column
+ * types are TypeScript types, not DDL. The values here represent the
+ * TypeScript types that will appear in the generated row interfaces.
+ *
+ * Consumers can override per-property via `typeMappings`. Anything not
+ * in this table and not overridden produces a hard diagnostic — no
+ * fallback, no guessing. That is the contract.
+ *
+ * IMPORTANT: `'number'` is INTENTIONALLY ABSENT from this table.
+ * Manifest's `number` is ambiguous between integers, real numbers, and
+ * money. Silently mapping it to `number` is exactly the class of silent
+ * bug this project exists to prevent (rounding in financial values).
+ * Authors must pick a precise type:
+ *   - `int` / `bigint` for counts and ids
+ *   - `float` for measurements where rounding is acceptable
+ *   - `money` / `decimal` for currency and other exact-decimal values
+ * Bare `number` produces a hard KYSELY_AMBIGUOUS_NUMBER diagnostic
+ * (see the generator). Override via `typeMappings` if you really do
+ * want to attach a specific TypeScript type to a `number`-typed field.
+ */
+/**
+ * Kysely dialect controls which dialect import is emitted in the
+ * generated factory function.
+ */
+export type KyselyDialect = 'postgresql' | 'mysql' | 'sqlite';
+/**
+ * Maps an IR type name to a Kysely TypeScript column type.
+ * The value is the TypeScript type expression (e.g. 'string', 'number', 'Date').
+ */
+export interface KyselyColumnType {
+    /** TypeScript type expression (e.g. 'string', 'number', 'Date') */
+    tsType: string;
+    /** Whether this column should be wrapped in Generated<T> (auto-default columns) */
+    generated?: boolean;
+    /** Whether this column should use ColumnType for select/insert/update transforms */
+    columnType?: boolean;
+}
+declare const DEFAULT_TYPE_MAPPING: Readonly<Record<string, KyselyColumnType>>;
+export { DEFAULT_TYPE_MAPPING };
+/**
+ * Resolve a Kysely TypeScript column type for an IR `type.name`, given optional
+ * per-property overrides from projection config. Returns `undefined` when the
+ * name is unknown and no override is supplied — the caller MUST emit a diagnostic.
+ */
+export declare function resolveKyselyColumnType(irTypeName: string, overrides: Readonly<Record<string, string>> | undefined, propertyName: string): KyselyColumnType | undefined;
+/**
+ * Resolve the Kysely dialect class name and import path based on dialect.
+ */
+export declare function dialectClassName(dialect: KyselyDialect): string;
+/**
+ * Resolve the Kysely dialect config type name for a given dialect.
+ */
+export declare function dialectConfigTypeName(dialect: KyselyDialect): string;
+//# sourceMappingURL=type-mapping.d.ts.map

package/dist/manifest/projections/kysely/type-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-mapping.d.ts","sourceRoot":"","sources":["../../../../src/manifest/projections/kysely/type-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oFAAoF;IACpF,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,QAAA,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CA4BnE,CAAC;AAEH,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAEhC;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,EACvD,YAAY,EAAE,MAAM,GACnB,gBAAgB,GAAG,SAAS,CAM9B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAM/D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAMpE"}

package/dist/manifest/projections/kysely/type-mapping.js

@@ -0,0 +1,84 @@
+/**
+ * Default mapping from IR `type.name` strings to Kysely TypeScript column types.
+ *
+ * This table is the projection's sole interpreter of Manifest's open
+ * type vocabulary for Kysely. The projection knows what any given
+ * IR type name means for Kysely; nothing upstream carries Kysely knowledge.
+ *
+ * Kysely uses a `Database` interface where each table is a row type. Column
+ * types are TypeScript types, not DDL. The values here represent the
+ * TypeScript types that will appear in the generated row interfaces.
+ *
+ * Consumers can override per-property via `typeMappings`. Anything not
+ * in this table and not overridden produces a hard diagnostic — no
+ * fallback, no guessing. That is the contract.
+ *
+ * IMPORTANT: `'number'` is INTENTIONALLY ABSENT from this table.
+ * Manifest's `number` is ambiguous between integers, real numbers, and
+ * money. Silently mapping it to `number` is exactly the class of silent
+ * bug this project exists to prevent (rounding in financial values).
+ * Authors must pick a precise type:
+ *   - `int` / `bigint` for counts and ids
+ *   - `float` for measurements where rounding is acceptable
+ *   - `money` / `decimal` for currency and other exact-decimal values
+ * Bare `number` produces a hard KYSELY_AMBIGUOUS_NUMBER diagnostic
+ * (see the generator). Override via `typeMappings` if you really do
+ * want to attach a specific TypeScript type to a `number`-typed field.
+ */
+const DEFAULT_TYPE_MAPPING = Object.freeze({
+    // String family
+    string: { tsType: 'string' },
+    text: { tsType: 'string' },
+    uuid: { tsType: 'string' },
+    // Boolean
+    boolean: { tsType: 'boolean' },
+    bool: { tsType: 'boolean' },
+    // Integer family
+    int: { tsType: 'number' },
+    bigint: { tsType: 'string' }, // Kysely recommends string for bigint to avoid precision loss
+    // Real number family
+    float: { tsType: 'number' },
+    // Exact decimal family — Kysely uses string for exact decimals to avoid JS float issues
+    decimal: { tsType: 'string' },
+    money: { tsType: 'string' },
+    // Temporal — use ColumnType for Date columns that may accept strings on insert
+    date: { tsType: 'Date', columnType: true },
+    datetime: { tsType: 'Date', columnType: true },
+    // Structured
+    json: { tsType: 'unknown' },
+    bytes: { tsType: 'Uint8Array' },
+});
+export { DEFAULT_TYPE_MAPPING };
+/**
+ * Resolve a Kysely TypeScript column type for an IR `type.name`, given optional
+ * per-property overrides from projection config. Returns `undefined` when the
+ * name is unknown and no override is supplied — the caller MUST emit a diagnostic.
+ */
+export function resolveKyselyColumnType(irTypeName, overrides, propertyName) {
+    if (overrides && Object.prototype.hasOwnProperty.call(overrides, propertyName)) {
+        // Override is a raw TypeScript type string — wrap it in a KyselyColumnType.
+        return { tsType: overrides[propertyName] };
+    }
+    return DEFAULT_TYPE_MAPPING[irTypeName];
+}
+/**
+ * Resolve the Kysely dialect class name and import path based on dialect.
+ */
+export function dialectClassName(dialect) {
+    switch (dialect) {
+        case 'postgresql': return 'PostgresDialect';
+        case 'mysql': return 'MysqlDialect';
+        case 'sqlite': return 'SqliteDialect';
+    }
+}
+/**
+ * Resolve the Kysely dialect config type name for a given dialect.
+ */
+export function dialectConfigTypeName(dialect) {
+    switch (dialect) {
+        case 'postgresql': return 'PostgresDialectConfig';
+        case 'mysql': return 'MysqlDialectConfig';
+        case 'sqlite': return 'SqliteDialectConfig';
+    }
+}
+//# sourceMappingURL=type-mapping.js.map

package/dist/manifest/projections/kysely/type-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-mapping.js","sourceRoot":"","sources":["../../../../src/manifest/projections/kysely/type-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAqBH,MAAM,oBAAoB,GAA+C,MAAM,CAAC,MAAM,CAAC;IACrF,gBAAgB;IAChB,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;IAC5B,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;IAC1B,IAAI,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;IAE1B,UAAU;IACV,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;IAC9B,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;IAE3B,iBAAiB;IACjB,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;IACzB,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,8DAA8D;IAE5F,qBAAqB;IACrB,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;IAE3B,wFAAwF;IACxF,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;IAC7B,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;IAE3B,+EAA+E;IAC/E,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE;IAC1C,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE;IAE9C,aAAa;IACb,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;IAC3B,KAAK,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE;CAChC,CAAC,CAAC;AAEH,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAEhC;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAAkB,EAClB,SAAuD,EACvD,YAAoB;IAEpB,IAAI,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,CAAC;QAC/E,4EAA4E;QAC5E,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,oBAAoB,CAAC,UAAU,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAsB;IACrD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,YAAY,CAAC,CAAC,OAAO,iBAAiB,CAAC;QAC5C,KAAK,OAAO,CAAC,CAAC,OAAO,cAAc,CAAC;QACpC,KAAK,QAAQ,CAAC,CAAC,OAAO,eAAe,CAAC;IACxC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAsB;IAC1D,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,YAAY,CAAC,CAAC,OAAO,uBAAuB,CAAC;QAClD,KAAK,OAAO,CAAC,CAAC,OAAO,oBAAoB,CAAC;QAC1C,KAAK,QAAQ,CAAC,CAAC,OAAO,qBAAqB,CAAC;IAC9C,CAAC;AACH,CAAC"}

package/dist/manifest/projections/llm-context/generator.d.ts

@@ -0,0 +1,24 @@
+/**
+ * LLM Context projection — generates a structured manifest-context.json
+ * optimized for AI agent context injection.
+ *
+ * Enables agents to fully understand the domain model (entities, commands,
+ * policies, constraints, relationships, enums, events) in a single context load.
+ *
+ * Surfaces:
+ *   - llm-context.full    — complete manifest-context.json with all sections
+ *   - llm-context.summary — lightweight summary without full IR or expressions
+ *   - llm-context.ir      — raw IR passthrough as JSON
+ */
+import type { IR } from '../../ir';
+import type { ProjectionTarget, ProjectionRequest, ProjectionResult } from '../interface';
+export declare class LlmContextProjection implements ProjectionTarget {
+    readonly name = "llm-context";
+    readonly description = "Structured manifest-context.json for LLM context injection \u2014 entities, commands, policies, constraints, and relationships in one document.";
+    readonly surfaces: readonly ["llm-context.full", "llm-context.summary", "llm-context.ir"];
+    generate(ir: IR, request: ProjectionRequest): ProjectionResult;
+    private generateFull;
+    private generateSummary;
+    private generateIR;
+}
+//# sourceMappingURL=generator.d.ts.map

package/dist/manifest/projections/llm-context/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../src/manifest/projections/llm-context/generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAiC,MAAM,UAAU,CAAC;AAClE,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAwUtB,qBAAa,oBAAqB,YAAW,gBAAgB;IAC3D,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,qJAC2H;IAC/I,QAAQ,CAAC,QAAQ,yEAIN;IAEX,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,iBAAiB,GAAG,gBAAgB;IAwB9D,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,eAAe;IA0BvB,OAAO,CAAC,UAAU;CAkBnB"}