@specverse/runtime 4.1.0

package/dist/runtime/views/core/entity-display.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Entity Display Utilities
+ *
+ * Centralized logic for generating human-readable display names for entities.
+ * Framework-agnostic — works with any frontend or backend context.
+ *
+ * Extracted from specverse-app-demo/frontend-react/src/lib/utils/entity-display.ts
+ */
+/**
+ * Get a human-readable display name for an entity.
+ *
+ * Resolution order:
+ * 1. Standard fields: name, title, label
+ * 2. Fields ending with Name, Title, Label
+ * 3. Relationship resolution via foreign keys
+ * 4. Fallback fields: email, location, description
+ * 5. Date formatting for temporal entities
+ * 6. Truncated ID as last resort
+ */
+export declare function getEntityDisplayName(entity: any, allEntities?: Record<string, any[]>): string;
+/**
+ * Humanize a field name for display.
+ * Converts camelCase/snake_case to human-readable format.
+ *
+ * Examples:
+ *   'firstName' → 'First Name'
+ *   'authorId'  → 'Author'
+ *   'created_at' → 'Created at'
+ */
+export declare function humanizeFieldName(fieldName: string): string;
+//# sourceMappingURL=entity-display.d.ts.map

package/dist/runtime/views/core/entity-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-display.d.ts","sourceRoot":"","sources":["../../../../src/runtime/views/core/entity-display.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,GAAG,EACX,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAM,GACtC,MAAM,CAiGR;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAO3D"}

package/dist/runtime/views/core/entity-display.js

@@ -0,0 +1,123 @@
+/**
+ * Entity Display Utilities
+ *
+ * Centralized logic for generating human-readable display names for entities.
+ * Framework-agnostic — works with any frontend or backend context.
+ *
+ * Extracted from specverse-app-demo/frontend-react/src/lib/utils/entity-display.ts
+ */
+/**
+ * Get a human-readable display name for an entity.
+ *
+ * Resolution order:
+ * 1. Standard fields: name, title, label
+ * 2. Fields ending with Name, Title, Label
+ * 3. Relationship resolution via foreign keys
+ * 4. Fallback fields: email, location, description
+ * 5. Date formatting for temporal entities
+ * 6. Truncated ID as last resort
+ */
+export function getEntityDisplayName(entity, allEntities = {}) {
+    const data = entity?.data || entity || {};
+    // Try standard name/title/label fields first
+    if (data.name)
+        return data.name;
+    if (data.title)
+        return data.title;
+    if (data.label)
+        return data.label;
+    // Try fields ending with Name (e.g., roomName, houseName, guestName)
+    for (const key in data) {
+        if (key.endsWith('Name') && typeof data[key] === 'string' && data[key]) {
+            return data[key];
+        }
+    }
+    // Try fields ending with Title
+    for (const key in data) {
+        if (key.endsWith('Title') && typeof data[key] === 'string' && data[key]) {
+            return data[key];
+        }
+    }
+    // Try fields ending with Label
+    for (const key in data) {
+        if (key.endsWith('Label') && typeof data[key] === 'string' && data[key]) {
+            return data[key];
+        }
+    }
+    // Helper to resolve a relationship by foreign key
+    const resolveRelation = (relName) => {
+        // First check if already populated
+        if (data[relName]?.name) {
+            return data[relName].name;
+        }
+        if (data[relName]?.title) {
+            return data[relName].title;
+        }
+        // Try to resolve using foreign key
+        const foreignKey = `${relName}Id`;
+        const foreignKeyValue = data[foreignKey];
+        if (foreignKeyValue) {
+            const targetModel = relName.charAt(0).toUpperCase() + relName.slice(1);
+            const targetEntities = allEntities[targetModel] || [];
+            const targetEntity = targetEntities.find((e) => e.data?.id === foreignKeyValue || e.id === foreignKeyValue);
+            if (targetEntity) {
+                return getEntityDisplayName(targetEntity, allEntities);
+            }
+        }
+        return null;
+    };
+    // For junction tables or entities without names, construct from relationships
+    const relatedNames = [];
+    // Check all keys in data that end with 'Id' (foreign keys)
+    for (const key in data) {
+        if (key.endsWith('Id')) {
+            const relName = key.slice(0, -2);
+            const relValue = resolveRelation(relName);
+            if (relValue) {
+                relatedNames.push(relValue);
+            }
+        }
+    }
+    if (relatedNames.length > 0) {
+        return relatedNames.join(' - ');
+    }
+    // Try other useful fields (generic)
+    if (data.email)
+        return data.email;
+    if (data.location)
+        return data.location;
+    if (data.description)
+        return data.description;
+    // Format date fields nicely (include time for uniqueness)
+    if (data.appliedAt) {
+        const date = new Date(data.appliedAt);
+        return `Applied ${date.toLocaleString()}`;
+    }
+    if (data.dateTime) {
+        const date = new Date(data.dateTime);
+        return date.toLocaleString();
+    }
+    // Last resort: use UUID with truncation for readability
+    if (data.id) {
+        return `${data.id.slice(0, 8)}...`;
+    }
+    return entity.id || 'Unknown';
+}
+/**
+ * Humanize a field name for display.
+ * Converts camelCase/snake_case to human-readable format.
+ *
+ * Examples:
+ *   'firstName' → 'First Name'
+ *   'authorId'  → 'Author'
+ *   'created_at' → 'Created at'
+ */
+export function humanizeFieldName(fieldName) {
+    return fieldName
+        .replace(/Id$/, '')
+        .replace(/([A-Z])/g, ' $1')
+        .replace(/_/g, ' ')
+        .replace(/^./, (str) => str.toUpperCase())
+        .trim();
+}
+//# sourceMappingURL=entity-display.js.map

package/dist/runtime/views/core/entity-display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-display.js","sourceRoot":"","sources":["../../../../src/runtime/views/core/entity-display.ts"],"names":[],"mappings":"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"}

package/dist/runtime/views/core/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/runtime/views/core/field-classification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-classification.d.ts","sourceRoot":"","sources":["../../../../src/runtime/views/core/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/runtime/views/core/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/runtime/views/core/field-classification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-classification.js","sourceRoot":"","sources":["../../../../src/runtime/views/core/field-classification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,wEAAwE;AACxE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa;CACvE,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAC5B,UAAmC;IAEnC,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;IACnD,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,IAAI,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;AAC9D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,OAAgB;IAC5D,mCAAmC;IACnC,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAK,OAAe,CAAC,IAAI,EAAE,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,OAAO,KAAK,QAAQ;QACzC,CAAC,CAAC,OAAO;QACT,CAAC,CAAE,OAAe,EAAE,IAAI,IAAI,EAAE,CAAC;IAEjC,oCAAoC;IACpC,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,gBAAgB;IAChB,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAE/D,wCAAwC;IACxC,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IAC7E,IAAI,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnF,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC;IACD,OAAQ,OAAe,CAAC,QAAQ,KAAK,IAAI,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,MAAM,OAAO,GAAG,OAAO,OAAO,KAAK,QAAQ;QACzC,CAAC,CAAC,OAAO;QACT,CAAC,CAAE,OAAe,EAAE,IAAI,IAAI,EAAE,CAAC;IAEjC,0CAA0C;IAC1C,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAK,OAAe,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACrF,MAAM,UAAU,GAAI,OAAe,CAAC,OAAO,CAAC;QAC5C,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3C,OAAO,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,IAAI,CAAC;QACtD,CAAC;aAAM,IACL,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;YACrC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,EACxC,CAAC;YACD,OAAO,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACjF,CAAC;aAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpD,OAAO,OAAO,UAAU,KAAK,QAAQ;gBACnC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;gBAClC,CAAC,CAAC,UAAU,CAAC;QACjB,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,sBAAsB;IACtB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,IACE,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;QACrC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACxC,OAAO,CAAC,CAAC;IACX,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAmC,EACnC,UAA8C,EAAE;IAEhD,MAAM,IAAI,GAA4B,EAAE,CAAC;IAEzC,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7D,IAAI,CAAC,OAAO,CAAC,oBAAoB,IAAI,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;YACpE,SAAS;QACX,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/runtime/views/core/index.d.ts

@@ -0,0 +1,5 @@
+export * from './entity-display.js';
+export * from './field-classification.js';
+export * from './pattern-engine.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/views/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/runtime/views/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC"}

package/dist/runtime/views/core/index.js

@@ -0,0 +1,5 @@
+export * from './entity-display.js';
+export * from './field-classification.js';
+export * from './pattern-engine.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/views/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/runtime/views/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC"}

package/dist/runtime/views/core/pattern-engine.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Pattern Engine — Framework-Agnostic
+ *
+ * Core logic for detecting view patterns and mapping CURVED operations
+ * to protocol (HTTP) endpoints. No React, no DOM, no Tailwind.
+ *
+ * Extracted from react-pattern-adapter.tsx — the framework-agnostic parts.
+ */
+/** CURVED operation names */
+export type CURVEDOperation = 'create' | 'update' | 'retrieve' | 'retrieve_many' | 'validate' | 'evolve' | 'delete';
+/** Protocol mapping for a CURVED operation */
+export interface ProtocolMapping {
+    method: string;
+    pathPattern: string;
+}
+/** Result of detecting a pattern from a view spec */
+export interface PatternDetectionResult {
+    /** Pattern ID (e.g., 'list-view', 'detail-view') */
+    patternId: string;
+    /** View category */
+    category: 'data-entry' | 'data-display' | 'dashboard';
+    /** Original view type from spec */
+    viewType: string;
+}
+/**
+ * Default CURVED → HTTP protocol mapping.
+ *
+ * Maps semantic CRUD operations to REST endpoints.
+ * Can be overridden per-instance for different backend patterns.
+ */
+export declare const CURVED_PROTOCOL_MAPPING: Record<CURVEDOperation, ProtocolMapping>;
+/**
+ * Detect the pattern type from a view specification.
+ *
+ * Maps view.type to a pattern ID and category.
+ * Returns null if the view type is unrecognized.
+ */
+export declare function detectPattern(viewSpec: {
+    type?: string;
+}): PatternDetectionResult | null;
+/**
+ * Infer displayable fields from a model schema.
+ *
+ * Returns field names suitable for rendering, excluding
+ * auto-generated and internal fields.
+ */
+export declare function inferFieldsFromSchema(modelSchemas: Record<string, any> | undefined, modelName: string): string[];
+/**
+ * Infer fields from actual entity data when schema is not available.
+ *
+ * Examines the first entity to determine field names.
+ */
+export declare function inferFieldsFromModel(entities: any[]): string[];
+//# sourceMappingURL=pattern-engine.d.ts.map

package/dist/runtime/views/core/pattern-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-engine.d.ts","sourceRoot":"","sources":["../../../../src/runtime/views/core/pattern-engine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6BAA6B;AAC7B,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,eAAe,GACf,UAAU,GACV,QAAQ,GACR,QAAQ,CAAC;AAEb,8CAA8C;AAC9C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qDAAqD;AACrD,MAAM,WAAW,sBAAsB;IACrC,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,QAAQ,EAAE,YAAY,GAAG,cAAc,GAAG,WAAW,CAAC;IACtD,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,eAAe,EAAE,eAAe,CA6B5E,CAAC;AAmBF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,sBAAsB,GAAG,IAAI,CAYxF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,EAC7C,SAAS,EAAE,MAAM,GAChB,MAAM,EAAE,CAiBV;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,CAc9D"}

package/dist/runtime/views/core/pattern-engine.js

@@ -0,0 +1,125 @@
+/**
+ * Pattern Engine — Framework-Agnostic
+ *
+ * Core logic for detecting view patterns and mapping CURVED operations
+ * to protocol (HTTP) endpoints. No React, no DOM, no Tailwind.
+ *
+ * Extracted from react-pattern-adapter.tsx — the framework-agnostic parts.
+ */
+/**
+ * Default CURVED → HTTP protocol mapping.
+ *
+ * Maps semantic CRUD operations to REST endpoints.
+ * Can be overridden per-instance for different backend patterns.
+ */
+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}',
+    },
+};
+/** Map from view type string to pattern ID */
+const VIEW_TYPE_TO_PATTERN = {
+    'form': { patternId: 'form-view', category: 'data-entry' },
+    'create': { patternId: 'form-view', category: 'data-entry' },
+    'edit': { patternId: 'form-view', category: 'data-entry' },
+    'create-form': { patternId: 'form-view', category: 'data-entry' },
+    'edit-form': { patternId: 'form-view', category: 'data-entry' },
+    'list': { patternId: 'list-view', category: 'data-display' },
+    'table': { patternId: 'list-view', category: 'data-display' },
+    'detail': { patternId: 'detail-view', category: 'data-display' },
+    'master-detail': { patternId: 'detail-view', category: 'data-display' },
+    'dashboard': { patternId: 'dashboard-view', category: 'dashboard' },
+    'board': { patternId: 'board-view', category: 'data-display' },
+    'timeline': { patternId: 'timeline-view', category: 'data-display' },
+    'calendar': { patternId: 'calendar-view', category: 'data-display' },
+};
+/**
+ * Detect the pattern type from a view specification.
+ *
+ * Maps view.type to a pattern ID and category.
+ * Returns null if the view type is unrecognized.
+ */
+export function detectPattern(viewSpec) {
+    const viewType = viewSpec.type?.toLowerCase();
+    if (!viewType)
+        return null;
+    const mapping = VIEW_TYPE_TO_PATTERN[viewType];
+    if (!mapping)
+        return null;
+    return {
+        patternId: mapping.patternId,
+        category: mapping.category,
+        viewType,
+    };
+}
+/**
+ * Infer displayable fields from a model schema.
+ *
+ * Returns field names suitable for rendering, excluding
+ * auto-generated and internal fields.
+ */
+export function inferFieldsFromSchema(modelSchemas, modelName) {
+    if (!modelSchemas || !modelSchemas[modelName])
+        return [];
+    const schema = modelSchemas[modelName];
+    const attributes = schema.attributes || {};
+    const fields = [];
+    for (const [name, def] of Object.entries(attributes)) {
+        // Skip internal/auto fields
+        if (name === 'id')
+            continue;
+        if (name === 'createdAt' || name === 'updatedAt')
+            continue;
+        const typeDef = def;
+        if (typeDef?.auto)
+            continue;
+        fields.push(name);
+    }
+    return fields;
+}
+/**
+ * Infer fields from actual entity data when schema is not available.
+ *
+ * Examines the first entity to determine field names.
+ */
+export function inferFieldsFromModel(entities) {
+    if (!entities || entities.length === 0)
+        return [];
+    const firstEntity = entities[0];
+    const data = firstEntity?.data || firstEntity || {};
+    const fields = [];
+    for (const key of Object.keys(data)) {
+        if (key === 'id')
+            continue;
+        if (key === 'createdAt' || key === 'updatedAt')
+            continue;
+        fields.push(key);
+    }
+    return fields;
+}
+//# sourceMappingURL=pattern-engine.js.map

package/dist/runtime/views/core/pattern-engine.js.map

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