@specverse/types 4.0.4 → 4.1.1

package/dist/engine.d.ts

@@ -89,6 +89,8 @@ export interface InferenceResult {
     component: any;
     deployments?: Record<string, any>;
     yaml: string;
+    /** Dev GUI specification YAML — consumed by @specverse/runtime DevShell */
+    devYaml?: string;
     validation: ValidationResult;
     statistics: {
         modelsProcessed: number;

package/dist/engine.d.ts.map

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

package/dist/index.d.ts

@@ -11,5 +11,6 @@ export * from './ast.js';
 export * from './engine.js';
 export * from './processor.js';
 export * from './entity-module.js';
+export * from './instance-factory.js';
 export * from './utils.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -11,5 +11,6 @@ export * from './ast.js';
 export * from './engine.js';
 export * from './processor.js';
 export * from './entity-module.js';
+export * from './instance-factory.js';
 export * from './utils.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,YAAY,CAAC"}

package/dist/instance-factory.d.ts

@@ -0,0 +1,289 @@
+/**
+ * Instance Factory Definitions
+ *
+ * TypeScript interfaces for SpecVerse Instance Factories.
+ * These define reusable technology specifications for code generation.
+ */
+/**
+ * Package dependency specification
+ */
+export interface Dependency {
+    name: string;
+    version: string;
+    optional?: boolean;
+}
+/**
+ * Code template specification
+ */
+export interface CodeTemplate {
+    /** Template engine to use */
+    engine: 'typescript' | 'handlebars' | 'ai';
+    /** Template content or path (for handlebars) */
+    template?: string;
+    /** Path to generator function (for typescript) */
+    generator?: string;
+    /** Generation prompt (for AI) */
+    prompt?: string;
+    /** Output file path pattern with variables like {controller}, {model} */
+    outputPattern: string;
+    /** Paths to validation functions */
+    validators?: string[];
+    /** Paths to post-processing functions */
+    postProcessors?: string[];
+}
+/**
+ * Technology stack information
+ */
+export interface TechnologyStack {
+    /**
+     * Runtime environment identifier (kebab-case).
+     * Standard: node, deno, bun, python, rust, go, browser
+     * Custom values allowed (e.g., "zig", "dotnet")
+     * Pattern: ^[a-z][a-z0-9-]+$
+     */
+    runtime: string;
+    /**
+     * Programming language identifier (kebab-case).
+     * Standard: typescript, javascript, python, rust, go, java, csharp, php, ruby, kotlin, swift
+     * Custom values allowed (e.g., "gleam", "elixir")
+     * Pattern: ^[a-z][a-z0-9-]+$
+     */
+    language: string;
+    /** Framework name (fastify, express, react, vue, etc.) */
+    framework?: string;
+    /** ORM/database library (prisma, typeorm, drizzle, etc.) */
+    orm?: string;
+    /** Validation library (zod, joi, class-validator, etc.) */
+    validation?: string;
+    /** Additional technology properties */
+    [key: string]: string | undefined;
+}
+/**
+ * Compatibility requirements
+ */
+export interface CompatibilityRequirements {
+    /** SpecVerse version range (semver) */
+    specverse: string;
+    /** Node.js version requirement */
+    node?: string;
+    /** Additional compatibility requirements */
+    [key: string]: string | undefined;
+}
+/**
+ * Capability declaration
+ */
+export interface Capabilities {
+    /** Capabilities this implementation provides */
+    provides: string[];
+    /** Capabilities this implementation requires */
+    requires?: string[];
+}
+/**
+ * Dependencies specification
+ */
+export interface Dependencies {
+    /** Runtime dependencies */
+    runtime?: Dependency[];
+    /** Development dependencies */
+    dev?: Dependency[];
+    /** Peer dependencies */
+    peer?: Dependency[];
+}
+/**
+ * Instance factory metadata
+ */
+export interface InstanceFactoryMetadata {
+    /** Author name or organization */
+    author?: string;
+    /** Repository URL */
+    repository?: string;
+    /** Homepage URL */
+    homepage?: string;
+    /** License identifier (MIT, Apache-2.0, etc.) */
+    license?: string;
+    /** Tags for categorization */
+    tags?: string[];
+    /** Keywords for search */
+    keywords?: string[];
+    /** Documentation URL */
+    documentation?: string;
+}
+/**
+ * Complete Instance Factory definition
+ *
+ * An instance factory defines a specific technology stack and
+ * how to generate code for that stack from SpecVerse specifications.
+ */
+export interface InstanceFactory {
+    /** Unique name for this instance factory */
+    name: string;
+    /** Semantic version */
+    version: string;
+    /** Category for deployment instances */
+    category: 'controller' | 'service' | 'view' | 'storage' | 'security' | 'infrastructure' | 'monitoring' | 'communication';
+    /** Human-readable description */
+    description?: string;
+    /** Version compatibility requirements */
+    compatibility?: CompatibilityRequirements;
+    /** What this implementation provides and requires */
+    capabilities: Capabilities;
+    /** Technology stack information */
+    technology: TechnologyStack;
+    /** Package dependencies */
+    dependencies?: Dependencies;
+    /** Code generation templates */
+    codeTemplates: Record<string, CodeTemplate>;
+    /** Default configuration */
+    configuration?: Record<string, any>;
+    /** Parent implementation type to extend from */
+    extends?: string;
+    /** Additional metadata */
+    metadata?: InstanceFactoryMetadata;
+}
+/**
+ * Reference to an instance factory in a manifest
+ */
+export interface InstanceFactoryReference {
+    /** Reference path: "backend/fastify-prisma" or "@org/impl-types/name" */
+    ref: string;
+    /** Semantic version range */
+    version?: string;
+    /** Short alias for referencing in mappings */
+    alias?: string;
+    /** Configuration overrides */
+    configuration?: Record<string, any>;
+    /** Template overrides */
+    templates?: Record<string, string>;
+}
+/**
+ * Capability mapping in a manifest (v3.3 with instanceFactory)
+ */
+export interface CapabilityMapping {
+    /** Capability pattern (e.g., "api.rest" or "storage.database.*") */
+    capability: string;
+    /** Instance factory reference (alias or full ref) */
+    instanceFactory: string;
+    /** Version constraint for instance factory */
+    version?: string;
+    /** Configuration overrides for this mapping */
+    configuration?: Record<string, any>;
+    /** Namespace for grouping */
+    namespace?: string;
+}
+/**
+ * Instance mapping in a manifest (v3.3 - highest priority)
+ */
+export interface InstanceMapping {
+    /** Specific instance name from deployment */
+    instanceName: string;
+    /** Instance factory reference */
+    instanceFactory: string;
+    /** Version constraint for instance factory */
+    version?: string;
+    /** Configuration overrides for this mapping */
+    configuration?: Record<string, any>;
+}
+/**
+ * Default mappings by category (v3.3 - lowest priority)
+ */
+export interface DefaultMappings {
+    controller?: string;
+    service?: string;
+    view?: string;
+    storage?: string;
+    security?: string;
+    infrastructure?: string;
+    monitoring?: string;
+    communication?: string;
+}
+/**
+ * Deployment reference in manifest (v3.3)
+ */
+export interface DeploymentReference {
+    /** Path to .specly file containing deployment */
+    deploymentSource: string;
+    /** Name of deployment in the spec */
+    deploymentName: string;
+    /** Version constraint for deployment */
+    deploymentVersion?: string;
+}
+/**
+ * Resolved implementation with context
+ */
+export interface ResolvedImplementation {
+    /** The capability being resolved */
+    capability: string;
+    /** The resolved instance factory (with overrides applied) */
+    instanceFactory: InstanceFactory;
+    /** The deployment instance this is for */
+    instance?: any;
+    /** Resolved configuration (defaults + manifest overrides + mapping overrides) */
+    configuration: Record<string, any>;
+    /** Base path for resolving template files (directory containing the instance factory file) */
+    basePath?: string;
+}
+/**
+ * Factory validation result
+ */
+export interface FactoryValidationResult {
+    /** Whether validation passed */
+    valid: boolean;
+    /** Error messages if validation failed */
+    errors?: string[];
+    /** Warning messages */
+    warnings?: string[];
+    /** Suggested fixes */
+    suggestions?: string[];
+}
+/**
+ * Template context for code generation
+ */
+export interface TemplateContext {
+    /** AI-optimized specification */
+    spec: any;
+    /** Resolved instance factory */
+    factory: InstanceFactory;
+    /** Current model (if generating for a specific model) */
+    model?: any;
+    /** Current controller (if generating for a specific controller) */
+    controller?: any;
+    /** Current service (if generating for a specific service) */
+    service?: any;
+    /** Deployment instance (if generating for a specific instance) */
+    instance?: any;
+    /** Additional context properties */
+    [key: string]: any;
+}
+/**
+ * Template engine interface
+ */
+export interface TemplateEngine {
+    /**
+     * Render a template with the given context
+     */
+    render(template: CodeTemplate, context: TemplateContext): Promise<string>;
+}
+/**
+ * Library source configuration
+ */
+export interface LibrarySource {
+    /** Source type */
+    type: 'local' | 'npm' | 'remote';
+    /** Source path or URL */
+    path: string;
+    /** Priority (higher = checked first) */
+    priority?: number;
+}
+/**
+ * Implementation type library configuration
+ */
+export interface LibraryConfig {
+    /** Library sources to search */
+    sources: LibrarySource[];
+    /** Cache configuration */
+    cache?: {
+        enabled: boolean;
+        ttl?: number;
+    };
+}
+//# sourceMappingURL=instance-factory.d.ts.map

package/dist/instance-factory.d.ts.map

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

package/dist/instance-factory.js

@@ -0,0 +1,8 @@
+/**
+ * Instance Factory Definitions
+ *
+ * TypeScript interfaces for SpecVerse Instance Factories.
+ * These define reusable technology specifications for code generation.
+ */
+export {};
+//# sourceMappingURL=instance-factory.js.map

package/dist/instance-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-factory.js","sourceRoot":"","sources":["../src/instance-factory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/spec-rules/curved-protocol.d.ts

@@ -0,0 +1,52 @@
+/**
+ * CURVED Protocol Mapping — Shared Spec Behaviour Rules
+ *
+ * Maps CURVED operations (Create, Update, Retrieve, Validate, Evolve, Delete)
+ * to HTTP protocol details. Single source of truth used by:
+ *   - generators (at build time to emit static route code)
+ *   - @specverse/runtime (at render time for API calls)
+ *   - app-demo (at request time for dynamic routing)
+ */
+/**
+ * CURVED operations supported by SpecVerse
+ */
+export type CURVEDOperation = 'create' | 'update' | 'retrieve' | 'retrieve_many' | 'validate' | 'evolve' | 'delete';
+/**
+ * Protocol mapping for a CURVED operation
+ */
+export interface ProtocolMapping {
+    method: string;
+    pathPattern: string;
+}
+/**
+ * Default CURVED → HTTP protocol mapping.
+ * Maps semantic CRUD operations to REST endpoints.
+ */
+export declare const CURVED_PROTOCOL_MAPPING: Record<CURVEDOperation, ProtocolMapping>;
+/**
+ * Infer HTTP method from operation name.
+ */
+export declare function inferHttpMethod(operation: string): string;
+/**
+ * Infer canonical relative path from operation name.
+ * Returns path relative to the resource base (e.g., /, /:id, /:id/evolve).
+ */
+export declare function inferPath(operation: string): string;
+/**
+ * Derive REST base path from model name.
+ * E.g., "Post" → "/api/posts", "Category" → "/api/categories"
+ */
+export declare function deriveBasePath(modelName: string): string;
+/**
+ * Derived endpoint from a CURVED operation
+ */
+export interface DerivedEndpoint {
+    operation: string;
+    method: string;
+    path: string;
+}
+/**
+ * Convert CURED operations object to endpoint list.
+ */
+export declare function curedToEndpoints(cured: Record<string, any>): DerivedEndpoint[];
+//# sourceMappingURL=curved-protocol.d.ts.map

package/dist/spec-rules/curved-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"curved-protocol.d.ts","sourceRoot":"","sources":["../../src/spec-rules/curved-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,eAAe,GACf,UAAU,GACV,QAAQ,GACR,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,eAAe,EAAE,eAAe,CAQ5E,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAUzD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAUnD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,eAAe,EAAE,CAY9E"}

package/dist/spec-rules/curved-protocol.js

@@ -0,0 +1,87 @@
+/**
+ * CURVED Protocol Mapping — Shared Spec Behaviour Rules
+ *
+ * Maps CURVED operations (Create, Update, Retrieve, Validate, Evolve, Delete)
+ * to HTTP protocol details. Single source of truth used by:
+ *   - generators (at build time to emit static route code)
+ *   - @specverse/runtime (at render time for API calls)
+ *   - app-demo (at request time for dynamic routing)
+ */
+import { pluralize } from '../utils.js';
+/**
+ * Default CURVED → HTTP protocol mapping.
+ * Maps semantic CRUD operations to REST endpoints.
+ */
+export const CURVED_PROTOCOL_MAPPING = {
+    create: { method: 'POST', pathPattern: '/api/{resource}' },
+    update: { method: 'PUT', pathPattern: '/api/{resource}/{id}' },
+    retrieve: { method: 'GET', pathPattern: '/api/{resource}/{id}' },
+    retrieve_many: { method: 'GET', pathPattern: '/api/{resource}' },
+    validate: { method: 'POST', pathPattern: '/api/{resource}/validate' },
+    evolve: { method: 'POST', pathPattern: '/api/{resource}/{id}/evolve' },
+    delete: { method: 'DELETE', pathPattern: '/api/{resource}/{id}' },
+};
+/**
+ * Infer HTTP method from operation name.
+ */
+export function inferHttpMethod(operation) {
+    if (!operation)
+        return 'post';
+    const op = operation.toLowerCase();
+    if (op === 'create' || op === 'validate')
+        return 'post';
+    if (op === 'retrieve' || op === 'list' || op === 'retrieve_many')
+        return 'get';
+    if (op === 'update' || op === 'evolve')
+        return 'put';
+    if (op === 'delete')
+        return 'delete';
+    return 'post';
+}
+/**
+ * Infer canonical relative path from operation name.
+ * Returns path relative to the resource base (e.g., /, /:id, /:id/evolve).
+ */
+export function inferPath(operation) {
+    if (!operation)
+        return '/';
+    const op = operation.toLowerCase();
+    if (op === 'create' || op === 'list' || op === 'retrieve_many')
+        return '/';
+    if (op === 'retrieve' || op === 'update' || op === 'delete')
+        return '/:id';
+    if (op === 'evolve')
+        return '/:id/evolve';
+    if (op === 'validate')
+        return '/validate';
+    return `/${op}`;
+}
+/**
+ * Derive REST base path from model name.
+ * E.g., "Post" → "/api/posts", "Category" → "/api/categories"
+ */
+export function deriveBasePath(modelName) {
+    return `/api/${pluralize(modelName.toLowerCase())}`;
+}
+/**
+ * Convert CURED operations object to endpoint list.
+ */
+export function curedToEndpoints(cured) {
+    const endpoints = [];
+    if (cured.create)
+        endpoints.push({ operation: 'create', method: 'POST', path: '/' });
+    if (cured.retrieve)
+        endpoints.push({ operation: 'retrieve', method: 'GET', path: '/:id' });
+    if (cured.retrieve_many)
+        endpoints.push({ operation: 'list', method: 'GET', path: '/' });
+    if (cured.update)
+        endpoints.push({ operation: 'update', method: 'PUT', path: '/:id' });
+    if (cured.evolve)
+        endpoints.push({ operation: 'evolve', method: 'PATCH', path: '/:id/evolve' });
+    if (cured.delete)
+        endpoints.push({ operation: 'delete', method: 'DELETE', path: '/:id' });
+    if (cured.validate)
+        endpoints.push({ operation: 'validate', method: 'POST', path: '/validate' });
+    return endpoints;
+}
+//# sourceMappingURL=curved-protocol.js.map

package/dist/spec-rules/curved-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curved-protocol.js","sourceRoot":"","sources":["../../src/spec-rules/curved-protocol.ts"],"names":[],"mappings":"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"}

package/dist/spec-rules/field-classification.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Field Classification
+ *
+ * Pure functions for classifying spec fields into categories:
+ * business, relationship, lifecycle, metadata, auto-generated.
+ *
+ * Framework-agnostic — no React or DOM dependencies.
+ *
+ * Consolidated from:
+ * - app-demo useEntityHelpers.ts (field separation, metadata detection)
+ * - engines field-helpers-generator.ts (auto-generated detection, defaults)
+ */
+/** Result of classifying a model's fields */
+export interface FieldClassification {
+    /** Business logic fields (displayed prominently) */
+    regularFields: string[];
+    /** Metadata fields (id, timestamps — displayed at end, muted) */
+    metadataFields: string[];
+}
+/** Fields always treated as metadata (displayed last, muted styling) */
+export declare const METADATA_FIELDS: string[];
+/**
+ * Classify fields into regular (business) vs metadata categories.
+ *
+ * Column order in views:
+ * 1. Regular business fields
+ * 2. Relationship fields (blue)
+ * 3. Lifecycle fields (purple badges)
+ * 4. Metadata fields (gray, italic)
+ */
+export declare function classifyFields(attributes: Record<string, unknown>): FieldClassification;
+/**
+ * Check if a field is auto-generated (should be hidden in forms).
+ *
+ * Detection:
+ * - Has `auto` property in schema (auto=now, auto=uuid4, etc.)
+ * - String format contains `auto=`
+ * - Common auto-generated DateTime fields (createdAt, updatedAt, etc.)
+ * - UUID id field
+ */
+export declare function isAutoField(attrName: string, attrDef: unknown): boolean;
+/**
+ * Check if a field is a metadata field (id, timestamps).
+ */
+export declare function isMetadataField(name: string): boolean;
+/**
+ * Check if a field represents a relationship (foreign key).
+ */
+export declare function isRelationshipField(name: string): boolean;
+/**
+ * Check if a field is required.
+ */
+export declare function isFieldRequired(attrDef: unknown): boolean;
+/**
+ * Get default value for a field based on its type.
+ */
+export declare function getFieldDefaultValue(attrDef: unknown): unknown;
+/**
+ * Initialize form data from schema attributes.
+ * Skips auto-generated fields by default.
+ */
+export declare function initializeFormData(attributes: Record<string, unknown>, options?: {
+    includeAutoGenerated?: boolean;
+}): Record<string, unknown>;
+//# sourceMappingURL=field-classification.d.ts.map

package/dist/spec-rules/field-classification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-classification.d.ts","sourceRoot":"","sources":["../../src/spec-rules/field-classification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,iEAAiE;IACjE,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wEAAwE;AACxE,eAAO,MAAM,eAAe,UAE3B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,mBAAmB,CAiBrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAqBvE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAMzD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAgC9D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,GAAE;IAAE,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC/C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWzB"}

package/dist/spec-rules/field-classification.js

@@ -0,0 +1,142 @@
+/**
+ * Field Classification
+ *
+ * Pure functions for classifying spec fields into categories:
+ * business, relationship, lifecycle, metadata, auto-generated.
+ *
+ * Framework-agnostic — no React or DOM dependencies.
+ *
+ * Consolidated from:
+ * - app-demo useEntityHelpers.ts (field separation, metadata detection)
+ * - engines field-helpers-generator.ts (auto-generated detection, defaults)
+ */
+/** Fields always treated as metadata (displayed last, muted styling) */
+export const METADATA_FIELDS = [
+    'id', 'createdAt', 'updatedAt', 'appliedAt', 'joinedAt', 'publishedAt',
+];
+/**
+ * Classify fields into regular (business) vs metadata categories.
+ *
+ * Column order in views:
+ * 1. Regular business fields
+ * 2. Relationship fields (blue)
+ * 3. Lifecycle fields (purple badges)
+ * 4. Metadata fields (gray, italic)
+ */
+export function classifyFields(attributes) {
+    if (!attributes || Object.keys(attributes).length === 0) {
+        return { regularFields: [], metadataFields: [] };
+    }
+    const regular = [];
+    const metadata = [];
+    for (const key of Object.keys(attributes)) {
+        if (METADATA_FIELDS.includes(key)) {
+            metadata.push(key);
+        }
+        else {
+            regular.push(key);
+        }
+    }
+    return { regularFields: regular, metadataFields: metadata };
+}
+/**
+ * Check if a field is auto-generated (should be hidden in forms).
+ *
+ * Detection:
+ * - Has `auto` property in schema (auto=now, auto=uuid4, etc.)
+ * - String format contains `auto=`
+ * - Common auto-generated DateTime fields (createdAt, updatedAt, etc.)
+ * - UUID id field
+ */
+export function isAutoField(attrName, attrDef) {
+    // Object format with auto property
+    if (attrDef && typeof attrDef === 'object' && attrDef.auto) {
+        return true;
+    }
+    const typeStr = typeof attrDef === 'string'
+        ? attrDef
+        : attrDef?.type || '';
+    // String format with auto= modifier
+    if (typeStr.includes('auto='))
+        return true;
+    // UUID id field
+    if (attrName === 'id' && typeStr.includes('UUID'))
+        return true;
+    // Common auto-generated DateTime fields
+    const autoDateFields = ['createdAt', 'updatedAt', 'joinedAt', 'publishedAt'];
+    if (autoDateFields.includes(attrName) && typeStr.includes('DateTime'))
+        return true;
+    return false;
+}
+/**
+ * Check if a field is a metadata field (id, timestamps).
+ */
+export function isMetadataField(name) {
+    return METADATA_FIELDS.includes(name);
+}
+/**
+ * Check if a field represents a relationship (foreign key).
+ */
+export function isRelationshipField(name) {
+    return name.endsWith('Id') && name !== 'id';
+}
+/**
+ * Check if a field is required.
+ */
+export function isFieldRequired(attrDef) {
+    if (!attrDef)
+        return false;
+    if (typeof attrDef === 'string') {
+        return attrDef.toLowerCase().includes('required');
+    }
+    return attrDef.required === true;
+}
+/**
+ * Get default value for a field based on its type.
+ */
+export function getFieldDefaultValue(attrDef) {
+    if (!attrDef)
+        return '';
+    const typeStr = typeof attrDef === 'string'
+        ? attrDef
+        : attrDef?.type || '';
+    // Check if schema has an explicit default
+    if (attrDef && typeof attrDef === 'object' && attrDef.default !== undefined) {
+        const defaultVal = attrDef.default;
+        if (typeStr.toLowerCase().includes('bool')) {
+            return defaultVal === 'true' || defaultVal === true;
+        }
+        else if (typeStr.toLowerCase().includes('int') ||
+            typeStr.toLowerCase().includes('number')) {
+            return typeof defaultVal === 'number' ? defaultVal : parseInt(defaultVal) || 0;
+        }
+        else if (typeStr.toLowerCase().includes('string')) {
+            return typeof defaultVal === 'string'
+                ? defaultVal.replace(/^"|"$/g, '')
+                : defaultVal;
+        }
+        return defaultVal;
+    }
+    // Type-based defaults
+    if (typeStr.toLowerCase().includes('bool'))
+        return false;
+    if (typeStr.toLowerCase().includes('int') ||
+        typeStr.toLowerCase().includes('number'))
+        return 0;
+    return '';
+}
+/**
+ * Initialize form data from schema attributes.
+ * Skips auto-generated fields by default.
+ */
+export function initializeFormData(attributes, options = {}) {
+    const data = {};
+    for (const [attrName, attrDef] of Object.entries(attributes)) {
+        if (!options.includeAutoGenerated && isAutoField(attrName, attrDef)) {
+            continue;
+        }
+        data[attrName] = getFieldDefaultValue(attrDef);
+    }
+    return data;
+}
+//# sourceMappingURL=field-classification.js.map

package/dist/spec-rules/field-classification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-classification.js","sourceRoot":"","sources":["../../src/spec-rules/field-classification.ts"],"names":[],"mappings":"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"}

package/dist/spec-rules/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Spec Rules — Shared Behaviour Layer
+ *
+ * Pure functions that derive behaviour from SpecVerse specifications.
+ * Used by generators (at build time) and runtime engines (at request time).
+ *
+ * @packageDocumentation
+ */
+export { type CURVEDOperation, type ProtocolMapping, type DerivedEndpoint, CURVED_PROTOCOL_MAPPING, inferHttpMethod, inferPath, deriveBasePath, curedToEndpoints, } from './curved-protocol.js';
+export { type LifecycleFlowResult, parseLifecycleFlow, normalizeSpec, } from './spec-normalization.js';
+export { type LifecycleDefinition, type TransitionMap, buildTransitionMap, isValidTransition, getAvailableTransitions, resolveInitialState, } from './lifecycle-rules.js';
+export { type FieldClassification, METADATA_FIELDS, classifyFields, isAutoField, isMetadataField, isRelationshipField, isFieldRequired, getFieldDefaultValue, initializeFormData, } from './field-classification.js';
+export { type DerivedRoute, deriveRoutes, } from './route-derivation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/spec-rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/spec-rules/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,uBAAuB,EACvB,eAAe,EACf,SAAS,EACT,cAAc,EACd,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,KAAK,mBAAmB,EACxB,kBAAkB,EAClB,aAAa,GACd,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,KAAK,mBAAmB,EACxB,eAAe,EACf,cAAc,EACd,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,KAAK,YAAY,EACjB,YAAY,GACb,MAAM,uBAAuB,CAAC"}

package/dist/spec-rules/index.js

@@ -0,0 +1,14 @@
+/**
+ * Spec Rules — Shared Behaviour Layer
+ *
+ * Pure functions that derive behaviour from SpecVerse specifications.
+ * Used by generators (at build time) and runtime engines (at request time).
+ *
+ * @packageDocumentation
+ */
+export { CURVED_PROTOCOL_MAPPING, inferHttpMethod, inferPath, deriveBasePath, curedToEndpoints, } from './curved-protocol.js';
+export { parseLifecycleFlow, normalizeSpec, } from './spec-normalization.js';
+export { buildTransitionMap, isValidTransition, getAvailableTransitions, resolveInitialState, } from './lifecycle-rules.js';
+export { METADATA_FIELDS, classifyFields, isAutoField, isMetadataField, isRelationshipField, isFieldRequired, getFieldDefaultValue, initializeFormData, } from './field-classification.js';
+export { deriveRoutes, } from './route-derivation.js';
+//# sourceMappingURL=index.js.map

package/dist/spec-rules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/spec-rules/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAIL,uBAAuB,EACvB,eAAe,EACf,SAAS,EACT,cAAc,EACd,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,kBAAkB,EAClB,aAAa,GACd,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAGL,kBAAkB,EAClB,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,eAAe,EACf,cAAc,EACd,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAEL,YAAY,GACb,MAAM,uBAAuB,CAAC"}

package/dist/spec-rules/lifecycle-rules.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Lifecycle Rules — Shared Spec Behaviour Rules
+ *
+ * Pure functions for lifecycle state machine logic:
+ *   - Building transition maps from lifecycle definitions
+ *   - Validating transitions
+ *   - Resolving initial states
+ *
+ * Single source of truth used by:
+ *   - generators (at build time to emit static transition maps)
+ *   - @specverse/runtime (for lifecycle UI controls)
+ *   - app-demo (at runtime for transition validation)
+ */
+/**
+ * Lifecycle definition — accepts all formats from spec
+ */
+export interface LifecycleDefinition {
+    name?: string;
+    states?: Array<string | {
+        name: string;
+    }>;
+    transitions?: Array<{
+        from: string | string[];
+        to: string;
+    }> | Record<string, any>;
+    flow?: string;
+    initialState?: string;
+}
+/**
+ * Map of valid transitions: fromState → [toState1, toState2, ...]
+ */
+export interface TransitionMap {
+    [fromState: string]: string[];
+}
+/**
+ * Build a transition map from a lifecycle definition.
+ *
+ * Handles all input formats:
+ *   - flow string: "draft -> open -> closed"
+ *   - states array with default linear transitions
+ *   - explicit transitions array: [{from, to}]
+ *   - mixed: states + explicit transitions (explicit override linear defaults)
+ */
+export declare function buildTransitionMap(lifecycle: LifecycleDefinition): TransitionMap;
+/**
+ * Check if a specific transition is valid.
+ */
+export declare function isValidTransition(map: TransitionMap, from: string, to: string): boolean;
+/**
+ * Get all valid next states from current state.
+ */
+export declare function getAvailableTransitions(map: TransitionMap, currentState: string): string[];
+/**
+ * Resolve the initial state from a lifecycle definition.
+ */
+export declare function resolveInitialState(lifecycle: LifecycleDefinition): string;
+//# sourceMappingURL=lifecycle-rules.d.ts.map

package/dist/spec-rules/lifecycle-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-rules.d.ts","sourceRoot":"","sources":["../../src/spec-rules/lifecycle-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1C,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC/B;AASD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,mBAAmB,GAAG,aAAa,CA6ChF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAEvF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAE1F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,mBAAmB,GAAG,MAAM,CAgB1E"}

package/dist/spec-rules/lifecycle-rules.js

@@ -0,0 +1,106 @@
+/**
+ * Lifecycle Rules — Shared Spec Behaviour Rules
+ *
+ * Pure functions for lifecycle state machine logic:
+ *   - Building transition maps from lifecycle definitions
+ *   - Validating transitions
+ *   - Resolving initial states
+ *
+ * Single source of truth used by:
+ *   - generators (at build time to emit static transition maps)
+ *   - @specverse/runtime (for lifecycle UI controls)
+ *   - app-demo (at runtime for transition validation)
+ */
+import { parseLifecycleFlow } from './spec-normalization.js';
+/**
+ * Extract state name from various formats
+ */
+function stateName(s) {
+    return typeof s === 'string' ? s : s.name;
+}
+/**
+ * Build a transition map from a lifecycle definition.
+ *
+ * Handles all input formats:
+ *   - flow string: "draft -> open -> closed"
+ *   - states array with default linear transitions
+ *   - explicit transitions array: [{from, to}]
+ *   - mixed: states + explicit transitions (explicit override linear defaults)
+ */
+export function buildTransitionMap(lifecycle) {
+    const map = {};
+    // If there's a flow string and no states, parse it first
+    let states = lifecycle.states || [];
+    if (lifecycle.flow && typeof lifecycle.flow === 'string' && states.length === 0) {
+        const parsed = parseLifecycleFlow(lifecycle.flow);
+        states = parsed.states;
+        // If no explicit transitions, use the flow-derived ones
+        if (!lifecycle.transitions) {
+            for (const t of parsed.transitions) {
+                if (!map[t.from])
+                    map[t.from] = [];
+                if (!map[t.from].includes(t.to))
+                    map[t.from].push(t.to);
+            }
+            return map;
+        }
+    }
+    // Default linear transitions from states array: state[i] → state[i+1]
+    const stateNames = states.map(stateName);
+    if (stateNames.length > 1) {
+        for (let i = 0; i < stateNames.length - 1; i++) {
+            if (!map[stateNames[i]])
+                map[stateNames[i]] = [];
+            if (!map[stateNames[i]].includes(stateNames[i + 1])) {
+                map[stateNames[i]].push(stateNames[i + 1]);
+            }
+        }
+    }
+    // Override/extend with explicit transitions
+    if (lifecycle.transitions) {
+        const transitions = Array.isArray(lifecycle.transitions)
+            ? lifecycle.transitions
+            : Object.entries(lifecycle.transitions).map(([name, t]) => ({ name, ...t }));
+        for (const t of transitions) {
+            const fromStates = Array.isArray(t.from) ? t.from : [t.from];
+            for (const from of fromStates) {
+                if (!map[from])
+                    map[from] = [];
+                if (!map[from].includes(t.to))
+                    map[from].push(t.to);
+            }
+        }
+    }
+    return map;
+}
+/**
+ * Check if a specific transition is valid.
+ */
+export function isValidTransition(map, from, to) {
+    return (map[from] || []).includes(to);
+}
+/**
+ * Get all valid next states from current state.
+ */
+export function getAvailableTransitions(map, currentState) {
+    return map[currentState] || [];
+}
+/**
+ * Resolve the initial state from a lifecycle definition.
+ */
+export function resolveInitialState(lifecycle) {
+    // Explicit initialState
+    if (lifecycle.initialState)
+        return lifecycle.initialState;
+    // First state in states array
+    if (lifecycle.states && lifecycle.states.length > 0) {
+        return stateName(lifecycle.states[0]);
+    }
+    // Parse from flow string
+    if (lifecycle.flow && typeof lifecycle.flow === 'string') {
+        const parsed = parseLifecycleFlow(lifecycle.flow);
+        return parsed.initialState;
+    }
+    return '';
+}
+//# sourceMappingURL=lifecycle-rules.js.map

package/dist/spec-rules/lifecycle-rules.js.map

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

package/dist/spec-rules/route-derivation.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Route Derivation — Shared Spec Behaviour Rules
+ *
+ * Derives a route table from a controller's CURVED operations.
+ * Single source of truth used by:
+ *   - generators (to emit static route registrations)
+ *   - app-demo (to register dynamic routes)
+ */
+import { deriveBasePath } from './curved-protocol.js';
+/**
+ * A derived route from a controller's operations
+ */
+export interface DerivedRoute {
+    /** Operation name (create, retrieve, list, update, evolve, delete, validate) */
+    operation: string;
+    /** HTTP method (GET, POST, PUT, DELETE, PATCH) */
+    method: string;
+    /** Relative path (/, /:id, /:id/evolve, /validate) */
+    relativePath: string;
+    /** Whether the route takes an :id parameter */
+    hasIdParam: boolean;
+    /** Whether the route expects a request body */
+    hasBody: boolean;
+}
+/**
+ * Derive a complete route table from a controller definition.
+ *
+ * Accepts controllers with CURED operations and/or explicit endpoints.
+ */
+export declare function deriveRoutes(controller: {
+    cured?: Record<string, any>;
+    endpoints?: Array<{
+        operation: string;
+        method?: string;
+        path?: string;
+    }>;
+}): DerivedRoute[];
+export { deriveBasePath };
+//# sourceMappingURL=route-derivation.d.ts.map

package/dist/spec-rules/route-derivation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-derivation.d.ts","sourceRoot":"","sources":["../../src/spec-rules/route-derivation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAA8B,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,UAAU,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,SAAS,CAAC,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E,GAAG,YAAY,EAAE,CA+CjB;AAGD,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/spec-rules/route-derivation.js

@@ -0,0 +1,68 @@
+/**
+ * Route Derivation — Shared Spec Behaviour Rules
+ *
+ * Derives a route table from a controller's CURVED operations.
+ * Single source of truth used by:
+ *   - generators (to emit static route registrations)
+ *   - app-demo (to register dynamic routes)
+ */
+import { inferHttpMethod, inferPath, deriveBasePath } from './curved-protocol.js';
+/**
+ * Derive a complete route table from a controller definition.
+ *
+ * Accepts controllers with CURED operations and/or explicit endpoints.
+ */
+export function deriveRoutes(controller) {
+    const routes = [];
+    // From CURED operations
+    if (controller.cured) {
+        const ops = controller.cured;
+        const addRoute = (operation) => {
+            const method = inferHttpMethod(operation).toUpperCase();
+            const path = inferPath(operation);
+            routes.push({
+                operation,
+                method,
+                relativePath: path,
+                hasIdParam: path.includes(':id'),
+                hasBody: ['POST', 'PUT', 'PATCH'].includes(method),
+            });
+        };
+        if (ops.create)
+            addRoute('create');
+        if (ops.retrieve)
+            addRoute('retrieve');
+        if (ops.retrieve_many) {
+            addRoute('list');
+        }
+        if (ops.update)
+            addRoute('update');
+        if (ops.evolve)
+            addRoute('evolve');
+        if (ops.delete)
+            addRoute('delete');
+        if (ops.validate)
+            addRoute('validate');
+    }
+    // From explicit endpoints (override or supplement CURED)
+    if (controller.endpoints) {
+        for (const ep of controller.endpoints) {
+            const method = (ep.method || inferHttpMethod(ep.operation)).toUpperCase();
+            const path = ep.path || inferPath(ep.operation);
+            // Don't duplicate if same operation already from CURED
+            if (!routes.find(r => r.operation === ep.operation)) {
+                routes.push({
+                    operation: ep.operation,
+                    method,
+                    relativePath: path,
+                    hasIdParam: path.includes(':id'),
+                    hasBody: ['POST', 'PUT', 'PATCH'].includes(method),
+                });
+            }
+        }
+    }
+    return routes;
+}
+// Re-export deriveBasePath for convenience (lives in curved-protocol)
+export { deriveBasePath };
+//# sourceMappingURL=route-derivation.js.map

package/dist/spec-rules/route-derivation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-derivation.js","sourceRoot":"","sources":["../../src/spec-rules/route-derivation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAkBlF;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,UAG5B;IACC,MAAM,MAAM,GAAmB,EAAE,CAAC;IAElC,wBAAwB;IACxB,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC;QAE7B,MAAM,QAAQ,GAAG,CAAC,SAAiB,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;YACxD,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC;gBACV,SAAS;gBACT,MAAM;gBACN,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAChC,OAAO,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;aACnD,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,IAAI,GAAG,CAAC,MAAM;YAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,GAAG,CAAC,QAAQ;YAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;YAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAAC,CAAC;QAC5C,IAAI,GAAG,CAAC,MAAM;YAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,GAAG,CAAC,MAAM;YAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,GAAG,CAAC,MAAM;YAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,GAAG,CAAC,QAAQ;YAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAED,yDAAyD;IACzD,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;QACzB,KAAK,MAAM,EAAE,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,IAAI,eAAe,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YAC1E,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,IAAI,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;YAChD,uDAAuD;YACvD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;gBACpD,MAAM,CAAC,IAAI,CAAC;oBACV,SAAS,EAAE,EAAE,CAAC,SAAS;oBACvB,MAAM;oBACN,YAAY,EAAE,IAAI;oBAClB,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAChC,OAAO,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;iBACnD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,sEAAsE;AACtE,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/spec-rules/spec-normalization.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Spec Normalization — Shared Spec Behaviour Rules
+ *
+ * Converts spec data between formats:
+ *   - Array-format attributes/relationships/lifecycles → object format
+ *   - Lifecycle flow strings → states + transitions
+ *   - Array model references → single model string
+ *
+ * Single source of truth used by:
+ *   - generators (server-generator embeds normalized spec)
+ *   - @specverse/runtime (frontend consumes normalized schemas)
+ *   - app-demo (dynamic engine normalizes on load)
+ */
+/**
+ * Parsed lifecycle flow result
+ */
+export interface LifecycleFlowResult {
+    states: Array<{
+        name: string;
+    }>;
+    transitions: Array<{
+        from: string;
+        to: string;
+    }>;
+    initialState: string;
+}
+/**
+ * Parse a lifecycle flow string into states and transitions.
+ * E.g., "draft -> open -> closed" → { states: [{name:"draft"}, ...], transitions: [{from:"draft",to:"open"}, ...] }
+ */
+export declare function parseLifecycleFlow(flow: string): LifecycleFlowResult;
+/**
+ * Normalize spec data for consistent consumption.
+ *
+ * Converts:
+ *   - Array attributes → object keyed by name
+ *   - Array relationships → object keyed by name (with targetModel alias)
+ *   - Array lifecycles → object keyed by name
+ *   - Lifecycle flow strings → parsed states + transitions
+ *   - Array view.model → single string (first element)
+ */
+export declare function normalizeSpec(spec: any): any;
+//# sourceMappingURL=spec-normalization.d.ts.map

package/dist/spec-rules/spec-normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-normalization.d.ts","sourceRoot":"","sources":["../../src/spec-rules/spec-normalization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChC,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAcpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAwD5C"}

package/dist/spec-rules/spec-normalization.js

@@ -0,0 +1,99 @@
+/**
+ * Spec Normalization — Shared Spec Behaviour Rules
+ *
+ * Converts spec data between formats:
+ *   - Array-format attributes/relationships/lifecycles → object format
+ *   - Lifecycle flow strings → states + transitions
+ *   - Array model references → single model string
+ *
+ * Single source of truth used by:
+ *   - generators (server-generator embeds normalized spec)
+ *   - @specverse/runtime (frontend consumes normalized schemas)
+ *   - app-demo (dynamic engine normalizes on load)
+ */
+/**
+ * Parse a lifecycle flow string into states and transitions.
+ * E.g., "draft -> open -> closed" → { states: [{name:"draft"}, ...], transitions: [{from:"draft",to:"open"}, ...] }
+ */
+export function parseLifecycleFlow(flow) {
+    const stateNames = flow.split('->').map(s => s.trim()).filter(Boolean);
+    const states = stateNames.map(s => ({ name: s }));
+    const transitions = [];
+    for (let i = 0; i < stateNames.length - 1; i++) {
+        transitions.push({ from: stateNames[i], to: stateNames[i + 1] });
+    }
+    return {
+        states,
+        transitions,
+        initialState: stateNames[0] || '',
+    };
+}
+/**
+ * Normalize spec data for consistent consumption.
+ *
+ * Converts:
+ *   - Array attributes → object keyed by name
+ *   - Array relationships → object keyed by name (with targetModel alias)
+ *   - Array lifecycles → object keyed by name
+ *   - Lifecycle flow strings → parsed states + transitions
+ *   - Array view.model → single string (first element)
+ */
+export function normalizeSpec(spec) {
+    if (!spec)
+        return spec;
+    const normalized = { ...spec };
+    // Normalize models
+    if (normalized.models && typeof normalized.models === 'object') {
+        for (const [_name, model] of Object.entries(normalized.models)) {
+            // Attributes: [{name:'id', type:'UUID'}] → {id: {type:'UUID'}}
+            if (Array.isArray(model.attributes)) {
+                const obj = {};
+                for (const attr of model.attributes) {
+                    if (attr.name)
+                        obj[attr.name] = attr;
+                }
+                model.attributes = obj;
+            }
+            // Relationships: [{name:'author', type:'belongsTo', target:'Author'}] → {author: {..., targetModel:'Author'}}
+            if (Array.isArray(model.relationships)) {
+                const obj = {};
+                for (const rel of model.relationships) {
+                    if (rel.name)
+                        obj[rel.name] = { ...rel, targetModel: rel.target || rel.targetModel };
+                }
+                model.relationships = obj;
+            }
+            // Lifecycles: [{name:'status', states:[...]}] → {status: {states:[...]}}
+            if (Array.isArray(model.lifecycles)) {
+                const obj = {};
+                for (const lc of model.lifecycles) {
+                    if (lc.name)
+                        obj[lc.name] = lc;
+                }
+                model.lifecycles = obj;
+            }
+            // Parse flow strings in lifecycles
+            if (model.lifecycles && typeof model.lifecycles === 'object') {
+                for (const lc of Object.values(model.lifecycles)) {
+                    if (lc.flow && typeof lc.flow === 'string' && !lc.states) {
+                        const result = parseLifecycleFlow(lc.flow);
+                        lc.states = result.states;
+                        lc.transitions = result.transitions;
+                        lc.initialState = result.initialState;
+                    }
+                }
+            }
+        }
+    }
+    // Normalize views — ensure model is a single string
+    if (normalized.views && typeof normalized.views === 'object') {
+        for (const view of Object.values(normalized.views)) {
+            if (Array.isArray(view.model)) {
+                view.models = view.model;
+                view.model = view.model[0];
+            }
+        }
+    }
+    return normalized;
+}
+//# sourceMappingURL=spec-normalization.js.map

package/dist/spec-rules/spec-normalization.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@specverse/types",
-  "version": "4.0.4",
+  "version": "4.1.1",
   "description": "Shared type definitions for SpecVerse engines \u2014 AST, specs, engine interfaces",
   "type": "module",
   "main": "dist/index.js",
@@ -11,6 +11,11 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./spec-rules": {
+      "types": "./dist/spec-rules/index.d.ts",
+      "import": "./dist/spec-rules/index.js",
+      "default": "./dist/spec-rules/index.js"
+    },
     "./package.json": "./package.json"
   },
   "scripts": {