@angriff36/manifest 2.18.0

package/dist/manifest/projections/shared/naming.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Deterministic identifier casing + pluralization helpers for projections.
+ *
+ * These are PURE, deterministic string transforms — identical input always
+ * yields identical output (house-style invariant). No locale, no randomness,
+ * no external dependency. Projections that map IR identifiers to physical
+ * database names (Prisma `@map`/`@@map`, Drizzle column names, …) use these
+ * to apply a consumer-chosen naming convention.
+ *
+ * IMPORTANT: convention output is best-effort. The built-in pluralizer covers
+ * common English rules plus a tiny irregular set; anything it gets wrong is
+ * meant to be overridden by an explicit per-entity mapping (e.g. the Prisma
+ * projection's `tableMappings`). The convention is the default, the explicit
+ * mapping is the escape hatch.
+ */
+/** Target case style for a generated identifier. */
+export type CaseStyle = 'snake_case' | 'camelCase' | 'PascalCase' | 'preserve';
+/** Object form of a naming convention. */
+export interface NamingConvention {
+    /** Case style for table/model physical names. Default `'preserve'`. */
+    table?: CaseStyle;
+    /** Case style for column/field physical names. Default `'preserve'`. */
+    column?: CaseStyle;
+    /** Pluralize resolved table names. Default `true`. */
+    pluralizeTables?: boolean;
+}
+/**
+ * Public input shape. The string shorthand `'snake_case'` expands to
+ * `{ table: 'snake_case', column: 'snake_case', pluralizeTables: true }` —
+ * the common Rails/Postgres convention.
+ */
+export type NamingConventionInput = 'snake_case' | NamingConvention;
+/**
+ * Canonicalize the public input into a fully-populated convention, or
+ * `undefined` when no convention is requested (fully back-compatible: callers
+ * emit IR names verbatim).
+ */
+export declare function normalizeNaming(input: NamingConventionInput | undefined): Required<NamingConvention> | undefined;
+/** `createdAt` / `Widget` / `author id` → `created_at` / `widget` / `author_id`. */
+export declare function toSnakeCase(s: string): string;
+/** `created_at` / `Widget` → `CreatedAt` / `Widget`. */
+export declare function toPascalCase(s: string): string;
+/** `created_at` / `Widget` → `createdAt` / `widget`. */
+export declare function toCamelCase(s: string): string;
+/** Apply a case style. `'preserve'` returns the input unchanged. */
+export declare function applyCase(name: string, style: CaseStyle): string;
+/**
+ * Pluralize the final word of an identifier, preserving any snake_case prefix
+ * (`user_account` → `user_accounts`). Already-plural inputs ending in `s` are
+ * returned unchanged, so the function is effectively idempotent for the common
+ * case (`widgets` → `widgets`).
+ */
+export declare function pluralize(word: string): string;
+/**
+ * Physical table name for an entity under the given convention. Returns the
+ * input unchanged when no convention is active.
+ */
+export declare function resolveTableName(entityName: string, input?: NamingConventionInput): string;
+/**
+ * Physical column name for a property under the given convention. Returns the
+ * input unchanged when no convention is active.
+ */
+export declare function resolveColumnName(propName: string, input?: NamingConventionInput): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/manifest/projections/shared/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../../../src/manifest/projections/shared/naming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,oDAAoD;AACpD,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,UAAU,CAAC;AAE/E,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,wEAAwE;IACxE,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,sDAAsD;IACtD,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG,gBAAgB,CAAC;AAEpE;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,qBAAqB,GAAG,SAAS,GACvC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,SAAS,CAUxC;AAoBD,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CAOhE;AAkBD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAe9C;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAK1F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,qBAAqB,GAAG,MAAM,CAIzF"}

package/dist/manifest/projections/shared/naming.js

@@ -0,0 +1,138 @@
+/**
+ * Deterministic identifier casing + pluralization helpers for projections.
+ *
+ * These are PURE, deterministic string transforms — identical input always
+ * yields identical output (house-style invariant). No locale, no randomness,
+ * no external dependency. Projections that map IR identifiers to physical
+ * database names (Prisma `@map`/`@@map`, Drizzle column names, …) use these
+ * to apply a consumer-chosen naming convention.
+ *
+ * IMPORTANT: convention output is best-effort. The built-in pluralizer covers
+ * common English rules plus a tiny irregular set; anything it gets wrong is
+ * meant to be overridden by an explicit per-entity mapping (e.g. the Prisma
+ * projection's `tableMappings`). The convention is the default, the explicit
+ * mapping is the escape hatch.
+ */
+/**
+ * Canonicalize the public input into a fully-populated convention, or
+ * `undefined` when no convention is requested (fully back-compatible: callers
+ * emit IR names verbatim).
+ */
+export function normalizeNaming(input) {
+    if (input == null)
+        return undefined;
+    if (input === 'snake_case') {
+        return { table: 'snake_case', column: 'snake_case', pluralizeTables: true };
+    }
+    return {
+        table: input.table ?? 'preserve',
+        column: input.column ?? 'preserve',
+        pluralizeTables: input.pluralizeTables ?? true,
+    };
+}
+// ----------------------------------------------------------------------------
+// Case transforms
+// ----------------------------------------------------------------------------
+/** Split an identifier into lower-cased words on camel/Pascal/snake/kebab boundaries. */
+function splitWords(s) {
+    return s
+        // acronym followed by a capitalized word: HTTPServer → HTTP Server
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+        // lower/digit followed by upper: createdAt → created At
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        // separators
+        .replace(/[\s_-]+/g, ' ')
+        .trim()
+        .split(' ')
+        .filter(Boolean);
+}
+/** `createdAt` / `Widget` / `author id` → `created_at` / `widget` / `author_id`. */
+export function toSnakeCase(s) {
+    return splitWords(s).map(w => w.toLowerCase()).join('_');
+}
+/** `created_at` / `Widget` → `CreatedAt` / `Widget`. */
+export function toPascalCase(s) {
+    return splitWords(s)
+        .map(w => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
+        .join('');
+}
+/** `created_at` / `Widget` → `createdAt` / `widget`. */
+export function toCamelCase(s) {
+    const pascal = toPascalCase(s);
+    return pascal.charAt(0).toLowerCase() + pascal.slice(1);
+}
+/** Apply a case style. `'preserve'` returns the input unchanged. */
+export function applyCase(name, style) {
+    switch (style) {
+        case 'snake_case': return toSnakeCase(name);
+        case 'camelCase': return toCamelCase(name);
+        case 'PascalCase': return toPascalCase(name);
+        case 'preserve': return name;
+    }
+}
+// ----------------------------------------------------------------------------
+// Pluralization
+// ----------------------------------------------------------------------------
+/** Small irregular set. Anything missing here is overridable via explicit mappings. */
+const IRREGULAR_PLURALS = {
+    person: 'people',
+    child: 'children',
+    man: 'men',
+    woman: 'women',
+    tooth: 'teeth',
+    foot: 'feet',
+    mouse: 'mice',
+    goose: 'geese',
+};
+/**
+ * Pluralize the final word of an identifier, preserving any snake_case prefix
+ * (`user_account` → `user_accounts`). Already-plural inputs ending in `s` are
+ * returned unchanged, so the function is effectively idempotent for the common
+ * case (`widgets` → `widgets`).
+ */
+export function pluralize(word) {
+    if (!word)
+        return word;
+    const cut = word.lastIndexOf('_');
+    const prefix = cut >= 0 ? word.slice(0, cut + 1) : '';
+    const base = cut >= 0 ? word.slice(cut + 1) : word;
+    if (!base)
+        return word;
+    const lower = base.toLowerCase();
+    if (IRREGULAR_PLURALS[lower])
+        return prefix + IRREGULAR_PLURALS[lower];
+    if (/[^aeiou]y$/i.test(base))
+        return prefix + base.slice(0, -1) + 'ies';
+    // Use double-s (`ss`), not single `s`, so singular words like `class` →
+    // `classes` while already-plural words like `widgets` stay unchanged below.
+    if (/(ss|x|z|ch|sh)$/i.test(base))
+        return prefix + base + 'es';
+    if (/s$/i.test(base))
+        return prefix + base; // already plural-ish (idempotent)
+    return prefix + base + 's';
+}
+// ----------------------------------------------------------------------------
+// Resolution entry points
+// ----------------------------------------------------------------------------
+/**
+ * Physical table name for an entity under the given convention. Returns the
+ * input unchanged when no convention is active.
+ */
+export function resolveTableName(entityName, input) {
+    const n = normalizeNaming(input);
+    if (!n)
+        return entityName;
+    const cased = applyCase(entityName, n.table);
+    return n.pluralizeTables ? pluralize(cased) : cased;
+}
+/**
+ * Physical column name for a property under the given convention. Returns the
+ * input unchanged when no convention is active.
+ */
+export function resolveColumnName(propName, input) {
+    const n = normalizeNaming(input);
+    if (!n)
+        return propName;
+    return applyCase(propName, n.column);
+}
+//# sourceMappingURL=naming.js.map

package/dist/manifest/projections/shared/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../../../src/manifest/projections/shared/naming.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAsBH;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAwC;IAExC,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IACpC,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;QAC3B,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC;IAC9E,CAAC;IACD,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,UAAU;QAChC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,UAAU;QAClC,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,IAAI;KAC/C,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,yFAAyF;AACzF,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC;QACN,mEAAmE;SAClE,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC;QAC1C,wDAAwD;SACvD,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;QACvC,aAAa;SACZ,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,IAAI,EAAE;SACN,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,OAAO,UAAU,CAAC,CAAC,CAAC;SACjB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC9D,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAgB;IACtD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,YAAY,CAAC,CAAC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC5C,KAAK,WAAW,CAAC,CAAC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3C,KAAK,YAAY,CAAC,CAAC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC7C,KAAK,UAAU,CAAC,CAAC,OAAO,IAAI,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,uFAAuF;AACvF,MAAM,iBAAiB,GAAqC;IAC1D,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,UAAU;IACjB,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,OAAO;CACf,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtD,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACjC,IAAI,iBAAiB,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACvE,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IACxE,wEAAwE;IACxE,4EAA4E;IAC5E,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/D,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,GAAG,IAAI,CAAC,CAAC,kCAAkC;IAC9E,OAAO,MAAM,GAAG,IAAI,GAAG,GAAG,CAAC;AAC7B,CAAC;AAED,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB,EAAE,KAA6B;IAChF,MAAM,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC;QAAE,OAAO,UAAU,CAAC;IAC1B,MAAM,KAAK,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,KAA6B;IAC/E,MAAM,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,CAAC,CAAC;QAAE,OAAO,QAAQ,CAAC;IACxB,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC"}

package/dist/manifest/projections/storybook/generator.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Storybook CSF3 projection for Manifest IR.
+ *
+ * Generates Component Story Format 3 stories and arg types from IR entities
+ * and commands. Each entity gets a default story with all properties as
+ * controls. Each command gets interaction stories demonstrating guard scenarios.
+ *
+ * Helps design teams preview UI states driven by real domain constraints.
+ */
+import type { IR } from '../../ir';
+import type { ProjectionTarget, ProjectionRequest, ProjectionResult } from '../interface';
+export interface StorybookProjectionOptions {
+    /**
+     * Component import path pattern.
+     * Use `{Entity}` as placeholder for entity PascalCase name.
+     * Use `{Command}` as placeholder for command PascalCase name.
+     * Default: '@/components/{Entity}'
+     */
+    componentImportPattern?: string;
+    /** Storybook title prefix for story hierarchy (default: 'Manifest') */
+    titlePrefix?: string;
+    /** Whether to generate guard pass/fail interaction stories (default: true) */
+    includeGuardScenarios?: boolean;
+    /** Whether to generate constraint violation stories (default: true) */
+    includeConstraintStories?: boolean;
+}
+export declare class StorybookProjection implements ProjectionTarget {
+    readonly name = "storybook";
+    readonly description = "Storybook CSF3 stories with typed controls from IR entities and commands";
+    readonly surfaces: readonly ["storybook.entity", "storybook.command", "storybook.all"];
+    generate(ir: IR, request: ProjectionRequest): ProjectionResult;
+    private _generateEntitySurface;
+    private _generateCommandSurface;
+    private _generateAllSurface;
+    private _entityArtifact;
+    private _commandArtifact;
+}
+//# sourceMappingURL=generator.d.ts.map

package/dist/manifest/projections/storybook/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../src/manifest/projections/storybook/generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,EAAE,EAAkE,MAAM,UAAU,CAAC;AACnG,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,EAA4C,MAAM,cAAc,CAAC;AAMpI,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,8EAA8E;IAC9E,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC,uEAAuE;IACvE,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAuYD,qBAAa,mBAAoB,YAAW,gBAAgB;IAC1D,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,8EAA8E;IAClG,QAAQ,CAAC,QAAQ,sEAAuE;IAExF,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,iBAAiB,GAAG,gBAAgB;IAsB9D,OAAO,CAAC,sBAAsB;IA2B9B,OAAO,CAAC,uBAAuB;IA0B/B,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,gBAAgB;CASzB"}