@ramme-io/create-app 1.1.1 → 1.1.2

package/template/src/components/AppHeader.tsx

@@ -22,7 +22,7 @@ import {
 import { useAuth } from '../contexts/AuthContext';
 
 // --- STRATEGIC IMPORTS ---
-import { appManifest } from '../config/app.manifest';
+import { appManifest } from '../config/navigation';
 import type { ManifestLink } from '../core/manifest-types';
 import TemplateSwitcher from './TemplateSwitcher';
 import rammeLogo from '../assets/orange.png'; // <-- 1. IMPORT THE LOGO

package/template/src/config/app.manifest.ts

@@ -1,86 +1,55 @@
+import type { AppSpecification } from '../types/schema';
+
 /**
- * @file app.manifest.ts
- * @repository ramme-app-starter
- * @description
- * This is the central manifest for all GLOBAL, shared navigation elements.
- * Corrected paths to point within the /settings layout.
+ * ------------------------------------------------------------------
+ * THE APP MANIFEST (The "Brain")
+ * ------------------------------------------------------------------
+ * This file is the Single Source of Truth for the application's
+ * domain logic. It defines the signals (data), entities (things),
+ * and global configuration.
+ * * In the "App Builder" workflow, this file is programmatically 
+ * generated by the AI Assistant.
  */
-import type { ManifestLink } from '../core/manifest-types';
 
-interface AppManifest {
-  userMenu: ManifestLink[];
-  settingsMenu: ManifestLink[];
-  footerLinks: ManifestLink[];
-}
+export const appManifest: AppSpecification = {
+  meta: {
+    name: "My Ramme App",
+    version: "0.1.0",
+    description: "A prototype application generated by Ramme.",
+    author: "Ramme User",
+    createdAt: new Date().toISOString(),
+  },
 
-export const appManifest: AppManifest = {
-  /**
-   * Used for the user dropdown menu in the AppHeader.
-   * NOTE: Logout is handled by the onClick={logout} in AppHeader,
-   * so it's removed from this manifest.
-   */
-  userMenu: [
-    {
-      id: 'user.profile',
-      // --- FIX: Point to the settings layout ---
-      path: '/settings/profile', // Correct path
-      title: 'Your Profile',
-      icon: 'user',
-    },
-    {
-      id: 'user.settings',
-      // --- FIX: Point to the settings layout base ---
-      path: '/settings', // Correct path
-      title: 'Settings',
-      icon: 'settings',
-    },
-    // --- REMOVED: Logout link is redundant ---
-    // {
-    //   id: 'user.logout',
-    //   path: '/login', // Was pointing here, but onClick is better
-    //   title: 'Log Out',
-    //   icon: 'logOut',
-    // },
-  ],
+  // The Data Layer
+  domain: {
+    // 1. Signals: The raw data points (Sensors, Statuses, Commands)
+    signals: [
+      // Example placeholder:
+      // {
+      //   id: 'temp_01',
+      //   label: 'Living Room Temp',
+      //   kind: 'sensor',
+      //   source: 'mock',
+      //   unit: '°C',
+      //   defaultValue: 22
+      // }
+    ],
 
-  /**
-   * Used for a dedicated settings page (e.g., /settings/...)
-   * These paths were already correct.
-   */
-  settingsMenu: [
-    {
-      id: 'settings.account',
-      path: '/settings/profile',
-      title: 'Account',
-      icon: 'user',
-    },
-    {
-      id: 'settings.billing',
-      path: '/settings/billing',
-      title: 'Billing',
-      icon: 'creditCard',
-    },
-    {
-      id: 'settings.team',
-      path: '/settings/team',
-      title: 'Team Members',
-      icon: 'users',
-    },
-  ],
+    // 2. Entities: The logical groupings (Devices, Rooms, Systems)
+    entities: [
+      // Example placeholder:
+      // {
+      //   id: 'dev_thermostat',
+      //   name: 'Smart Thermostat',
+      //   type: 'device',
+      //   signals: ['temp_01']
+      // }
+    ],
+  },
 
-  /**
-   * Used in the AppFooter. (Placeholders)
-   */
-  footerLinks: [
-    {
-      id: 'footer.help',
-      path: '/help',
-      title: 'Help Center',
-    },
-    {
-      id: 'footer.terms',
-      path: '/terms',
-      title: 'Terms of Service',
-    },
-  ],
+  // Global Config
+  config: {
+    theme: 'system',
+    mockMode: true, // Default to "Mock Mode" for instant prototyping
+  },
 };

package/template/src/config/navigation.ts

@@ -0,0 +1,86 @@
+/**
+ * @file navigation.ts
+ * @repository ramme-app-starter
+ * @description
+ * This is the central manifest for all GLOBAL, shared navigation elements.
+ * Corrected paths to point within the /settings layout.
+ */
+import type { ManifestLink } from '../core/manifest-types';
+
+interface AppManifest {
+  userMenu: ManifestLink[];
+  settingsMenu: ManifestLink[];
+  footerLinks: ManifestLink[];
+}
+
+export const appManifest: AppManifest = {
+  /**
+   * Used for the user dropdown menu in the AppHeader.
+   * NOTE: Logout is handled by the onClick={logout} in AppHeader,
+   * so it's removed from this manifest.
+   */
+  userMenu: [
+    {
+      id: 'user.profile',
+      // --- FIX: Point to the settings layout ---
+      path: '/settings/profile', // Correct path
+      title: 'Your Profile',
+      icon: 'user',
+    },
+    {
+      id: 'user.settings',
+      // --- FIX: Point to the settings layout base ---
+      path: '/settings', // Correct path
+      title: 'Settings',
+      icon: 'settings',
+    },
+    // --- REMOVED: Logout link is redundant ---
+    // {
+    //   id: 'user.logout',
+    //   path: '/login', // Was pointing here, but onClick is better
+    //   title: 'Log Out',
+    //   icon: 'logOut',
+    // },
+  ],
+
+  /**
+   * Used for a dedicated settings page (e.g., /settings/...)
+   * These paths were already correct.
+   */
+  settingsMenu: [
+    {
+      id: 'settings.account',
+      path: '/settings/profile',
+      title: 'Account',
+      icon: 'user',
+    },
+    {
+      id: 'settings.billing',
+      path: '/settings/billing',
+      title: 'Billing',
+      icon: 'creditCard',
+    },
+    {
+      id: 'settings.team',
+      path: '/settings/team',
+      title: 'Team Members',
+      icon: 'users',
+    },
+  ],
+
+  /**
+   * Used in the AppFooter. (Placeholders)
+   */
+  footerLinks: [
+    {
+      id: 'footer.help',
+      path: '/help',
+      title: 'Help Center',
+    },
+    {
+      id: 'footer.terms',
+      path: '/terms',
+      title: 'Terms of Service',
+    },
+  ],
+};

package/template/src/templates/settings/SettingsLayout.tsx

@@ -29,7 +29,7 @@ import {
 import { settingsSitemap } from './settings.sitemap';
 import rammeLogo from '../../assets/orange.png';
 import { useAuth } from '../../contexts/AuthContext';
-import { appManifest } from '../../config/app.manifest';
+import { appManifest } from '../../config/navigation';
 import type { ManifestLink } from '../../core/manifest-types';
 import { SitemapProvider } from '../../contexts/SitemapContext';
 import PageTitleUpdater from '../../components/PageTitleUpdater';

package/template/src/types/schema.ts

@@ -1,26 +1,88 @@
-// src/types/schema.ts
 import { z } from 'zod';
 
-// 1. Define what a "Signal" looks like in the config (Static definition)
+// ------------------------------------------------------------------
+// 1. Signal Schema (The "Nerve")
+// Defines a single data point (e.g., "Living Room Temp", "Light Switch")
+// ------------------------------------------------------------------
 export const SignalSchema = z.object({
-  id: z.string(),
+  id: z.string().min(1, "Signal ID is required"),
   label: z.string(),
-  kind: z.enum(['sensor', 'setpoint', 'state']),
-  unit: z.string().optional(),
+  description: z.string().optional(),
+  
+  // Classification
+  kind: z.enum(['sensor', 'actuator', 'setpoint', 'metric', 'status']),
+  
+  // Data Source Configuration (CRITICAL for the Adapter Factory)
+  source: z.enum(['mock', 'mqtt', 'http', 'derived', 'local']),
+  
+  // Source-Specific Config 
+  topic: z.string().optional(),      // For MQTT (e.g., "home/living/temp")
+  endpoint: z.string().optional(),   // For HTTP (e.g., "/api/v1/weather")
+  refreshRate: z.number().default(1000), 
+  
+  // Value Configuration
+  defaultValue: z.any().optional(),
+  unit: z.string().optional(),       
+  
+  // Validation
   min: z.number().optional(),
   max: z.number().optional(),
 });
 
-// 2. Define the Application Specification
-export const AppSpecificationSchema = z.object({
+export type SignalDefinition = z.infer<typeof SignalSchema>;
+
+
+// ------------------------------------------------------------------
+// 2. Entity Schema (The "Atom")
+// Defines a grouping of signals into a logical object (e.g., "Smart Thermostat")
+// ------------------------------------------------------------------
+export const EntitySchema = z.object({
+  id: z.string(),
   name: z.string(),
   description: z.string().optional(),
-  version: z.string().default("1.0.0"),
-  theme: z.enum(['light', 'dark', 'system']).default('system'),
-  // We will add 'pages' and 'navigation' here later
-  signals: z.array(SignalSchema).default([]),
+  
+  // Taxonomy
+  type: z.string(), // e.g., 'device', 'room', 'service'
+  category: z.enum(['hardware', 'software', 'logical']).default('logical'),
+
+  // The Signals that belong to this entity (References Signal IDs)
+  signals: z.array(z.string()), 
+  
+  // UI Hints (How should this entity look?)
+  ui: z.object({
+    icon: z.string().optional(), // IconName
+    color: z.string().optional(),
+    dashboardComponent: z.string().optional(), // e.g., 'DeviceCard'
+  }).optional(),
+});
+
+export type EntityDefinition = z.infer<typeof EntitySchema>;
+
+
+// ------------------------------------------------------------------
+// 3. App Specification (The "Master Plan")
+// This is the JSON structure the App Builder will generate.
+// ------------------------------------------------------------------
+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(),
+  }),
+  
+  // The Data Layer
+  domain: z.object({
+    signals: z.array(SignalSchema),
+    entities: z.array(EntitySchema),
+  }),
+
+  // Global Config
+  config: z.object({
+    theme: z.enum(['light', 'dark', 'system']).default('system'),
+    mockMode: z.boolean().default(true), 
+  }),
 });
 
-// Export the Types
-export type SignalDef = z.infer<typeof SignalSchema>;
 export type AppSpecification = z.infer<typeof AppSpecificationSchema>;