symbiote-ui 0.3.0-alpha.4

package/manifest/graph-schema.js

@@ -0,0 +1,285 @@
+export let GRAPH_SCHEMA_VERSIONS = [
+  {
+    version: 'v1',
+    path: 'schemas/graph-v1.json',
+    description: 'JSON Schema for Symbiote Node graph/workflow documents.',
+  },
+  {
+    version: 'graph-model-v1',
+    path: 'schemas/graph-model-v1.json',
+    description: 'JSON Schema for universal graph models shared by UI, workflow, automation, and media projects.',
+  },
+];
+
+export let GRAPH_SCHEMAS = {
+  v1: {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    $id: 'https://rnd-pro.github.io/symbiote-node/schemas/graph-v1.json',
+    title: 'Symbiote Node Graph',
+    type: 'object',
+    additionalProperties: false,
+    required: ['version', 'nodes', 'connections'],
+    properties: {
+      version: { const: 'v1' },
+      metadata: {
+        type: 'object',
+        additionalProperties: true,
+        properties: {
+          name: { type: 'string' },
+          description: { type: 'string' },
+          createdAt: { type: 'string' },
+          updatedAt: { type: 'string' },
+        },
+      },
+      nodes: {
+        type: 'array',
+        items: { $ref: '#/$defs/node' },
+        uniqueItems: true,
+      },
+      connections: {
+        type: 'array',
+        items: { $ref: '#/$defs/connection' },
+        uniqueItems: true,
+      },
+      frames: {
+        type: 'array',
+        items: { $ref: '#/$defs/frame' },
+      },
+    },
+    $defs: {
+      point: {
+        type: 'object',
+        required: ['x', 'y'],
+        properties: {
+          x: { type: 'number' },
+          y: { type: 'number' },
+        },
+        additionalProperties: false,
+      },
+      node: {
+        type: 'object',
+        required: ['id', 'type'],
+        additionalProperties: true,
+        properties: {
+          id: { type: 'string', minLength: 1 },
+          type: { type: 'string', minLength: 1 },
+          label: { type: 'string' },
+          position: { $ref: '#/$defs/point' },
+          size: { $ref: '#/$defs/point' },
+          params: { type: 'object', additionalProperties: true },
+          inputs: { type: 'array', items: { type: 'string' } },
+          outputs: { type: 'array', items: { type: 'string' } },
+        },
+      },
+      connection: {
+        type: 'object',
+        required: ['id', 'source', 'target'],
+        additionalProperties: false,
+        properties: {
+          id: { type: 'string', minLength: 1 },
+          source: { $ref: '#/$defs/endpoint' },
+          target: { $ref: '#/$defs/endpoint' },
+          metadata: { type: 'object', additionalProperties: true },
+        },
+      },
+      endpoint: {
+        type: 'object',
+        required: ['nodeId', 'socket'],
+        additionalProperties: false,
+        properties: {
+          nodeId: { type: 'string', minLength: 1 },
+          socket: { type: 'string', minLength: 1 },
+        },
+      },
+      frame: {
+        type: 'object',
+        required: ['id'],
+        additionalProperties: true,
+        properties: {
+          id: { type: 'string', minLength: 1 },
+          label: { type: 'string' },
+          nodeIds: { type: 'array', items: { type: 'string' } },
+        },
+      },
+    },
+  },
+  'graph-model-v1': {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    $id: 'https://rnd-pro.github.io/symbiote-node/schemas/graph-model-v1.json',
+    title: 'Symbiote Graph Model',
+    type: 'object',
+    additionalProperties: false,
+    required: ['version', 'nodes'],
+    properties: {
+      version: { const: 'graph-model-v1' },
+      metadata: {
+        type: 'object',
+        additionalProperties: true,
+      },
+      nodes: {
+        type: 'array',
+        items: { $ref: '#/$defs/node' },
+        uniqueItems: true,
+      },
+      edges: {
+        type: 'array',
+        items: { $ref: '#/$defs/edge' },
+        uniqueItems: true,
+      },
+      views: {
+        type: 'object',
+        additionalProperties: { $ref: '#/$defs/view' },
+      },
+      theme: { $ref: '#/$defs/themeRef' },
+    },
+    $defs: {
+      layout: {
+        type: 'object',
+        additionalProperties: true,
+        properties: {
+          x: { type: 'number' },
+          y: { type: 'number' },
+          w: { type: 'number' },
+          h: { type: 'number' },
+          basis: { type: 'string' },
+        },
+      },
+      port: {
+        type: 'object',
+        required: ['name'],
+        additionalProperties: true,
+        properties: {
+          name: { type: 'string', minLength: 1 },
+          type: { type: 'string', minLength: 1 },
+          required: { type: 'boolean' },
+          label: { type: 'string' },
+        },
+      },
+      flow: {
+        type: 'object',
+        additionalProperties: true,
+        properties: {
+          inputs: {
+            type: 'array',
+            items: { $ref: '#/$defs/port' },
+          },
+          outputs: {
+            type: 'array',
+            items: { $ref: '#/$defs/port' },
+          },
+        },
+      },
+      design: {
+        type: 'object',
+        additionalProperties: true,
+        properties: {
+          component: { type: 'string', minLength: 1 },
+          variant: { type: 'string', minLength: 1 },
+          themeScope: { type: 'string', minLength: 1 },
+          layout: { $ref: '#/$defs/layout' },
+        },
+      },
+      node: {
+        type: 'object',
+        additionalProperties: true,
+        required: ['id', 'kind'],
+        properties: {
+          id: { type: 'string', minLength: 1 },
+          kind: { type: 'string', minLength: 1 },
+          label: { type: 'string' },
+          parentId: { type: 'string', minLength: 1 },
+          flow: { $ref: '#/$defs/flow' },
+          params: { type: 'object', additionalProperties: true },
+          design: { $ref: '#/$defs/design' },
+          children: {
+            type: 'array',
+            items: { type: 'string', minLength: 1 },
+          },
+          state: { type: 'object', additionalProperties: true },
+          themeScope: { type: 'string', minLength: 1 },
+          metadata: { type: 'object', additionalProperties: true },
+        },
+      },
+      endpoint: {
+        type: 'object',
+        required: ['nodeId', 'port'],
+        additionalProperties: true,
+        properties: {
+          nodeId: { type: 'string', minLength: 1 },
+          port: { type: 'string', minLength: 1 },
+        },
+      },
+      edge: {
+        type: 'object',
+        additionalProperties: true,
+        required: ['source', 'target'],
+        properties: {
+          id: { type: 'string', minLength: 1 },
+          kind: { type: 'string', minLength: 1 },
+          source: { $ref: '#/$defs/endpoint' },
+          target: { $ref: '#/$defs/endpoint' },
+          params: { type: 'object', additionalProperties: true },
+          metadata: { type: 'object', additionalProperties: true },
+        },
+      },
+      group: {
+        type: 'object',
+        required: ['id'],
+        additionalProperties: true,
+        properties: {
+          id: { type: 'string', minLength: 1 },
+          label: { type: 'string' },
+          nodeIds: {
+            type: 'array',
+            items: { type: 'string', minLength: 1 },
+          },
+          themeScope: { type: 'string', minLength: 1 },
+        },
+      },
+      view: {
+        type: 'object',
+        additionalProperties: true,
+        properties: {
+          kind: { type: 'string', minLength: 1 },
+          roots: {
+            type: 'array',
+            items: { type: 'string', minLength: 1 },
+          },
+          groups: {
+            type: 'array',
+            items: { $ref: '#/$defs/group' },
+          },
+        },
+      },
+      themeRef: {
+        type: 'object',
+        additionalProperties: true,
+        properties: {
+          scope: { type: 'string', minLength: 1 },
+          extends: { type: 'string', minLength: 1 },
+          modifiers: {
+            type: 'object',
+            additionalProperties: {
+              type: ['number', 'string', 'boolean'],
+            },
+          },
+        },
+      },
+    },
+  },
+};
+
+export function listGraphVersions() {
+  return GRAPH_SCHEMA_VERSIONS.map((schema) => schema.version);
+}
+
+export function getGraphSchema(version = 'v1') {
+  return GRAPH_SCHEMAS[version];
+}
+
+export function listGraphSchemas() {
+  return GRAPH_SCHEMA_VERSIONS.map((schema) => ({
+    ...schema,
+    ...getGraphSchema(schema.version),
+  }));
+}

package/manifest/index.js

@@ -0,0 +1,6 @@
+export * from './component-registry.js';
+export * from './theme-catalog.js';
+export * from './rule-catalog.js';
+export * from './graph-schema.js';
+export * from './project-schema-catalog.js';
+export * from './ui-schema-catalog.js';

package/manifest/project-schema-catalog.js

@@ -0,0 +1,246 @@
+export let PROJECT_SCHEMA_VERSIONS = [
+  {
+    version: 'project-package-v1',
+    path: 'schemas/project-package-v1.json',
+    description: 'JSON Schema for portable Symbiote project packages that assemble graphs, layouts, themes, packs, and agent rules.',
+  },
+  {
+    version: 'project-transaction-v1',
+    path: 'schemas/project-transaction-v1.json',
+    description: 'JSON Schema for safe agent-authored project graph, layout, and theme mutations.',
+  },
+];
+
+export let PROJECT_SCHEMAS = {
+  'project-package-v1': {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    $id: 'https://rnd-pro.github.io/symbiote-node/schemas/project-package-v1.json',
+    title: 'Symbiote Project Package',
+    type: 'object',
+    additionalProperties: false,
+    required: ['version', 'id', 'entry', 'graphs', 'layouts', 'themes'],
+    properties: {
+      version: { const: 'project-package-v1' },
+      id: { type: 'string', minLength: 1 },
+      name: { type: 'string' },
+      entry: { $ref: '#/$defs/entry' },
+      packs: {
+        type: 'array',
+        items: { $ref: '#/$defs/pack' },
+        uniqueItems: true,
+      },
+      graphs: {
+        type: 'object',
+        minProperties: 1,
+        additionalProperties: { $ref: 'graph-model-v1.json' },
+      },
+      layouts: {
+        type: 'object',
+        minProperties: 1,
+        additionalProperties: { $ref: 'runtime-ui-v1.json' },
+      },
+      themes: {
+        type: 'object',
+        minProperties: 1,
+        additionalProperties: { $ref: '#/$defs/themeRef' },
+      },
+      dataSources: {
+        type: 'object',
+        additionalProperties: { $ref: '#/$defs/dataSource' },
+      },
+      agents: { $ref: '#/$defs/agents' },
+    },
+    $defs: {
+      entry: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['graph', 'layout', 'theme'],
+        properties: {
+          graph: { type: 'string', minLength: 1 },
+          layout: { type: 'string', minLength: 1 },
+          theme: { type: 'string', minLength: 1 },
+        },
+      },
+      pack: {
+        type: 'object',
+        additionalProperties: true,
+        required: ['id'],
+        properties: {
+          id: { type: 'string', minLength: 1 },
+          kind: {
+            enum: ['provider', 'domain-pack', 'data-provider', 'automation-pack', 'theme-pack'],
+          },
+          version: { type: 'string' },
+        },
+      },
+      themeRef: {
+        type: 'object',
+        additionalProperties: true,
+        properties: {
+          extends: { type: 'string', minLength: 1 },
+          modifiers: {
+            type: 'object',
+            additionalProperties: {
+              type: ['number', 'string', 'boolean'],
+            },
+          },
+        },
+      },
+      dataSource: {
+        type: 'object',
+        additionalProperties: true,
+        required: ['kind'],
+        properties: {
+          kind: { type: 'string', minLength: 1 },
+          graph: { type: 'string', minLength: 1 },
+          schema: { type: 'string', minLength: 1 },
+        },
+      },
+      agents: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          rules: {
+            type: 'array',
+            items: { type: 'string', minLength: 1 },
+            uniqueItems: true,
+          },
+          allowedTransactions: {
+            type: 'array',
+            items: { type: 'string', minLength: 1 },
+            uniqueItems: true,
+          },
+        },
+      },
+    },
+  },
+  'project-transaction-v1': {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    $id: 'https://rnd-pro.github.io/symbiote-node/schemas/project-transaction-v1.json',
+    title: 'Symbiote Project Transaction',
+    type: 'object',
+    additionalProperties: false,
+    required: ['version', 'id', 'operations'],
+    properties: {
+      version: { const: 'project-transaction-v1' },
+      id: { type: 'string', minLength: 1 },
+      targetProject: { type: 'string' },
+      operations: {
+        type: 'array',
+        items: { $ref: '#/$defs/operation' },
+        minItems: 1,
+      },
+      metadata: {
+        type: 'object',
+        additionalProperties: true,
+      },
+    },
+    $defs: {
+      operation: {
+        oneOf: [
+          { $ref: '#/$defs/graphAddNodeOperation' },
+          { $ref: '#/$defs/graphAddEdgeOperation' },
+          { $ref: '#/$defs/layoutAddPanelOperation' },
+          { $ref: '#/$defs/layoutSetRootOperation' },
+          { $ref: '#/$defs/layoutUpdateNodeOperation' },
+          { $ref: '#/$defs/themeSetModifierOperation' },
+        ],
+      },
+      graphAddNodeOperation: {
+        type: 'object',
+        additionalProperties: true,
+        required: ['type', 'graph', 'node'],
+        properties: {
+          type: { const: 'graph.addNode' },
+          graph: { type: 'string', minLength: 1 },
+          node: { $ref: 'graph-model-v1.json#/$defs/node' },
+        },
+      },
+      graphAddEdgeOperation: {
+        type: 'object',
+        additionalProperties: true,
+        required: ['type', 'graph', 'edge'],
+        properties: {
+          type: { const: 'graph.addEdge' },
+          graph: { type: 'string', minLength: 1 },
+          edge: { $ref: 'graph-model-v1.json#/$defs/edge' },
+        },
+      },
+      layoutAddPanelOperation: {
+        type: 'object',
+        additionalProperties: true,
+        required: ['type', 'layout', 'panel'],
+        properties: {
+          type: { const: 'layout.addPanel' },
+          layout: { type: 'string', minLength: 1 },
+          parentId: { type: 'string', minLength: 1 },
+          panel: { $ref: 'runtime-ui-v1.json#/$defs/node' },
+        },
+      },
+      layoutSetRootOperation: {
+        type: 'object',
+        additionalProperties: true,
+        required: ['type', 'layout', 'root'],
+        properties: {
+          type: { const: 'layout.setRoot' },
+          layout: { type: 'string', minLength: 1 },
+          root: { $ref: 'runtime-ui-v1.json#/$defs/node' },
+        },
+      },
+      layoutUpdateNodeOperation: {
+        type: 'object',
+        additionalProperties: true,
+        required: ['type', 'layout', 'nodeId', 'patch'],
+        properties: {
+          type: { const: 'layout.updateNode' },
+          layout: { type: 'string', minLength: 1 },
+          nodeId: { type: 'string', minLength: 1 },
+          patch: {
+            type: 'object',
+            additionalProperties: false,
+            minProperties: 1,
+            properties: {
+              layout: {
+                type: 'object',
+                additionalProperties: false,
+                minProperties: 1,
+                properties: {
+                  rect: { type: 'object', additionalProperties: true },
+                  weight: { type: 'number' },
+                },
+              },
+              props: { type: 'object', additionalProperties: true },
+              attrs: { type: 'object', additionalProperties: true },
+            },
+          },
+        },
+      },
+      themeSetModifierOperation: {
+        type: 'object',
+        additionalProperties: true,
+        required: ['type', 'theme', 'name', 'value'],
+        properties: {
+          type: { const: 'theme.setModifier' },
+          theme: { type: 'string', minLength: 1 },
+          name: { type: 'string', minLength: 1 },
+          value: { type: ['number', 'string', 'boolean'] },
+        },
+      },
+    },
+  },
+};
+
+export function listProjectSchemaVersions() {
+  return PROJECT_SCHEMA_VERSIONS.map((schema) => schema.version);
+}
+
+export function getProjectSchema(version = 'project-package-v1') {
+  return PROJECT_SCHEMAS[version];
+}
+
+export function listProjectSchemas() {
+  return PROJECT_SCHEMA_VERSIONS.map((schema) => ({
+    ...schema,
+    ...getProjectSchema(schema.version),
+  }));
+}