@ramme-io/kernel 1.3.0

package/dist/engine/validation/schema.js

@@ -0,0 +1,156 @@
+import { z } from 'zod';
+/**
+ * @file schema.ts
+ * @description The "Application Constitution".
+ *
+ * ARCHITECTURAL ROLE:
+ * This file uses Zod to define the strict runtime validation rules for the
+ * App Manifest. While `manifest-types.ts` handles compile-time TypeScript checks,
+ * this file handles runtime validation, ensuring that any JSON loaded into the
+ * engine (whether from a file, API, or user input) is structurally sound.
+ *
+ * LAYERS DEFINED:
+ * 1. **SaaS Layer:** Data resources, fields, and tables.
+ * 2. **Physical Layer:** IoT signals, sensors, and entities.
+ * 3. **Logic Layer:** Workflows, triggers, and automated actions.
+ * 4. **Presentation Layer:** Pages, sections, and UI blocks.
+ */
+// ------------------------------------------------------------------
+// 1. DATA RESOURCE DEFINITIONS (SaaS Layer)
+// ------------------------------------------------------------------
+export const FieldSchema = z.object({
+    key: z.string(),
+    label: z.string(),
+    type: z.enum(['text', 'number', 'currency', 'date', 'boolean', 'status', 'email', 'image', 'textarea']),
+    required: z.boolean().optional(),
+    description: z.string().optional(),
+    defaultValue: z.any().optional(),
+});
+export const ResourceSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    fields: z.array(FieldSchema),
+    defaultView: z.enum(['table', 'grid', 'list']).optional(),
+    features: z.object({
+        searchable: z.boolean().optional(),
+        creatable: z.boolean().optional(),
+        editable: z.boolean().optional(),
+        deletable: z.boolean().optional(),
+        exportable: z.boolean().optional(),
+    }).optional(),
+});
+// ------------------------------------------------------------------
+// 2. SIGNAL & IOT DEFINITIONS (Physical Layer)
+// ------------------------------------------------------------------
+export const SignalSchema = z.object({
+    id: z.string().min(1, "Signal ID is required"),
+    label: z.string(),
+    description: z.string().optional(),
+    kind: z.enum(['sensor', 'actuator', 'setpoint', 'metric', 'status', 'kpi']),
+    source: z.enum(['mock', 'mqtt', 'http', 'derived', 'local']),
+    // Connectivity
+    topic: z.string().optional(),
+    endpoint: z.string().optional(),
+    jsonPath: z.string().optional(),
+    refreshRate: z.number().optional().default(1000),
+    // Values
+    defaultValue: z.any().optional(),
+    unit: z.string().optional(),
+    min: z.number().optional(),
+    max: z.number().optional(),
+});
+export const EntitySchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    description: z.string().optional(),
+    type: z.string(),
+    category: z.string().default('logical'),
+    signals: z.array(z.string()),
+    ui: z.object({
+        icon: z.string().optional(),
+        color: z.string().optional(),
+        dashboardComponent: z.string().optional(),
+    }).optional(),
+});
+// ------------------------------------------------------------------
+// ✅ NEW: LOGIC & WORKFLOW DEFINITIONS
+// ------------------------------------------------------------------
+export const TriggerSchema = z.object({
+    id: z.string(),
+    type: z.enum(['signal_change', 'manual_action', 'schedule', 'webhook']),
+    config: z.record(z.string(), z.any()),
+});
+export const ActionSchema = z.object({
+    id: z.string(),
+    type: z.enum([
+        'update_resource',
+        'send_notification',
+        'mqtt_publish',
+        'api_call',
+        'navigate',
+        'agent_task'
+    ]),
+    config: z.record(z.string(), z.any()),
+});
+export const WorkflowSchema = z.object({
+    id: z.string(),
+    name: z.string(),
+    active: z.boolean().default(true),
+    trigger: TriggerSchema,
+    actions: z.array(ActionSchema),
+});
+// ------------------------------------------------------------------
+// 3. UI LAYOUT DEFINITIONS (Presentation Layer)
+// ------------------------------------------------------------------
+export const BlockSchema = z.object({
+    id: z.string(),
+    type: z.string(),
+    props: z.record(z.string(), z.any()),
+    layout: z.object({
+        colSpan: z.number().optional(),
+        rowSpan: z.number().optional(),
+    }).optional(),
+});
+export const PageSectionSchema = z.object({
+    id: z.string(),
+    title: z.string().optional(),
+    description: z.string().optional(),
+    layout: z.object({
+        columns: z.number().optional(),
+        variant: z.enum(['grid', 'stack', 'split']).optional()
+    }).optional(),
+    blocks: z.array(BlockSchema),
+});
+export const PageSchema = z.object({
+    id: z.string(),
+    slug: z.string(),
+    title: z.string(),
+    description: z.string().optional(),
+    icon: z.string().optional(),
+    sections: z.array(PageSectionSchema),
+});
+// MASTER APP SPECIFICATION
+export const AppSpecificationSchema = z.object({
+    meta: z.object({
+        name: z.string(),
+        version: z.string(),
+        description: z.string().optional(),
+        author: z.string().optional(),
+        createdAt: z.string().optional(),
+    }),
+    config: z.object({
+        theme: z.enum(['light', 'dark', 'system', 'corporate', 'midnight', 'blueprint']).default('system'),
+        mockMode: z.boolean().default(true),
+        brokerUrl: z.string().optional(),
+    }),
+    modules: z.array(z.string()).optional(),
+    resources: z.array(ResourceSchema).optional(),
+    domain: z.object({
+        signals: z.array(SignalSchema),
+        entities: z.array(EntitySchema),
+        // ✅ ADDED WORKFLOWS HERE
+        workflows: z.array(WorkflowSchema).optional(),
+    }),
+    pages: z.array(PageSchema).optional(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/engine/validation/schema.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export * from './engine/runtime/ManifestContext';
+export * from './engine/runtime/MqttContext';
+export * from './engine/runtime/SitemapContext';
+export * from './engine/runtime/useAction';
+export * from './engine/runtime/useCrudLocalStorage';
+export * from './engine/runtime/useDataQuery';
+export * from './engine/runtime/useDynamicSitemap';
+export * from './engine/runtime/useJustInTimeSeeder';
+export * from './engine/runtime/useLiveBridge';
+export * from './engine/runtime/useSignal';
+export * from './engine/runtime/useSignalStore';
+export * from './engine/runtime/useWorkflowEngine';
+export * from './engine/runtime/data-seeder';
+export * from './engine/renderers/DynamicBlock';
+export * from './engine/renderers/DynamicPage';
+export * from './engine/renderers/route-generator';
+export * from './engine/types/manifest-types';
+export * from './engine/types/sitemap-entry';
+export * from './engine/validation/schema';
+export { SmartTable } from './components/SmartTable';
+export { AutoForm } from './components/AutoForm';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,8BAA8B,CAAC;AAE7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AAEnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAE7C,cAAc,4BAA4B,CAAC;AAG3C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+// Engine exports
+export * from './engine/runtime/ManifestContext';
+export * from './engine/runtime/MqttContext';
+export * from './engine/runtime/SitemapContext';
+export * from './engine/runtime/useAction';
+export * from './engine/runtime/useCrudLocalStorage';
+export * from './engine/runtime/useDataQuery';
+export * from './engine/runtime/useDynamicSitemap';
+export * from './engine/runtime/useJustInTimeSeeder';
+export * from './engine/runtime/useLiveBridge';
+export * from './engine/runtime/useSignal';
+export * from './engine/runtime/useSignalStore';
+export * from './engine/runtime/useWorkflowEngine';
+export * from './engine/runtime/data-seeder';
+export * from './engine/renderers/DynamicBlock';
+export * from './engine/renderers/DynamicPage';
+export * from './engine/renderers/route-generator';
+export * from './engine/types/manifest-types';
+export * from './engine/types/sitemap-entry';
+export * from './engine/validation/schema';
+// Component exports
+export { SmartTable } from './components/SmartTable';
+export { AutoForm } from './components/AutoForm';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,8BAA8B,CAAC;AAE7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AAEnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAE7C,cAAc,4BAA4B,CAAC;AAE3C,oBAAoB;AACpB,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@ramme-io/kernel",
+  "version": "1.3.0",
+  "description": "Core engine",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "mqtt": "^5.14.1",
+    "zustand": "^5.0.3",
+    "@ramme-io/ui": "1.2.3"
+  },
+  "peerDependencies": {
+    "react": ">=18.2.0",
+    "react-dom": ">=18.2.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "typescript": "^5.0.0"
+  },
+  "scripts": {
+    "dev": "tsc --watch",
+    "build": "tsc"
+  }
+}

package/src/components/AutoForm.tsx

@@ -0,0 +1,141 @@
+import React, { useMemo } from 'react';
+import { Drawer, FormTemplate, Button, type FormField } from '@ramme-io/ui';
+
+/**
+ * @file AutoForm.tsx
+ * @description The "Zero-Boilerplate" Form Engine.
+ * * ARCHITECTURAL ROLE:
+ * This component acts as the bridge between your data schema (JSON) and the UI.
+ * Instead of writing manual form code for every resource (Users, Products, Orders),
+ * this component dynamically generates the correct inputs based on the field type.
+ * * KEY FEATURES:
+ * 1. **Smart Mapping:** Automatically converts 'boolean' -> Toggle, 'date' -> DatePicker, etc.
+ * 2. **Context Aware:** Auto-detects "Create" vs "Edit" mode based on `initialData`.
+ * 3. **Safety Logic:** Automatically hides primary keys during creation and locks them during editing.
+ */
+
+interface AutoFormProps {
+  isOpen: boolean;
+  onClose: () => void;
+  onSubmit: (data: any) => void;
+  title: string;
+  fields: any[]; // The raw metadata from app.manifest.ts
+  initialData?: any;
+}
+
+export const AutoForm: React.FC<AutoFormProps> = ({
+  isOpen,
+  onClose,
+  onSubmit,
+  title,
+  fields,
+  initialData
+}) => {
+  
+  // 1. Safe Data Handling
+  const safeData = initialData || {};
+  const isEditMode = !!safeData.id;
+
+  // 2. Schema-to-UI Mapping Engine
+  const formFields = useMemo<FormField[]>(() => {
+    return fields
+      // 🛑 RULE 1: Hide ID field during creation (System handles it)
+      .filter((f: any) => !(f.key === 'id' && !isEditMode))
+      .map((f: any) => {
+      
+      const isIdField = f.key === 'id';
+
+      // Base Configuration for all fields
+      const baseConfig = {
+        name: f.key,
+        label: f.label,
+        required: f.required,
+        placeholder: f.description || `Enter ${f.label.toLowerCase()}`,
+        // Pre-fill data if editing, or use default from schema
+        value: safeData[f.key] !== undefined ? safeData[f.key] : (f.defaultValue || ''),
+        colSpan: 1,
+        // 🛑 RULE 2: If it's the ID field, force it to be disabled (View Only)
+        disabled: isIdField
+      };
+
+      // Intelligent Type Switching
+      switch (f.type) {
+        case 'number':
+        case 'integer':
+        case 'currency':
+          return { 
+            ...baseConfig, 
+            type: 'number',
+            value: Number(baseConfig.value) || 0 
+          };
+
+        case 'boolean':
+          return { 
+            ...baseConfig, 
+            type: 'toggle', 
+            checked: !!baseConfig.value 
+          };
+
+        case 'date':
+          return { 
+            ...baseConfig, 
+            type: 'datepicker', 
+            value: baseConfig.value ? new Date(baseConfig.value) : null 
+          };
+
+        case 'status':
+          return { 
+            ...baseConfig, 
+            type: 'select', 
+            options: [
+              { value: 'Active', label: 'Active' },
+              { value: 'Pending', label: 'Pending' },
+              { value: 'Inactive', label: 'Inactive' },
+              { value: 'Archived', label: 'Archived' }
+            ]
+          };
+
+        case 'textarea':
+          return { 
+            ...baseConfig, 
+            type: 'textarea', 
+            colSpan: 2 
+          };
+
+        case 'email':
+          return { ...baseConfig, type: 'email' };
+
+        default:
+          return { ...baseConfig, type: 'text' };
+      }
+    });
+  }, [fields, safeData, isEditMode]);
+
+  return (
+    <Drawer
+      isOpen={isOpen}
+      onClose={onClose}
+      title={`${isEditMode ? 'Edit' : 'New'} ${title}`}
+      size="500px"
+    >
+      <div className="p-6">
+        <FormTemplate 
+          fields={formFields} 
+          onSubmit={(formData) => {
+            // Merge original ID to ensure we update the correct record
+            onSubmit({ ...safeData, ...formData }); 
+          }} 
+        >
+            <div className="flex justify-end gap-2 mt-8 pt-4 border-t border-border">
+                <Button variant="outline" onClick={onClose} type="button">
+                  Cancel
+                </Button>
+                <Button type="submit" variant="primary">
+                  {isEditMode ? 'Save Changes' : 'Create Record'}
+                </Button>
+            </div>
+        </FormTemplate>
+      </div>
+    </Drawer>
+  );
+};