symbiote-ui 0.3.0-alpha.4

package/manifest/ui-schema-catalog.js

@@ -0,0 +1,334 @@
+export let UI_SCHEMA_VERSIONS = [
+  {
+    version: 'component-descriptor-v1',
+    path: 'schemas/component-descriptor-v1.json',
+    description: 'JSON Schema for Symbiote Node component provider descriptors.',
+  },
+  {
+    version: 'component-descriptor-v2',
+    path: 'schemas/component-descriptor-v2.json',
+    description: 'JSON Schema for Symbiote UI component descriptors with SSR and WebMCP metadata.',
+  },
+  {
+    version: 'runtime-ui-v1',
+    path: 'schemas/runtime-ui-v1.json',
+    description: 'JSON Schema for runtime UI trees assembled from provider component descriptors.',
+  },
+  {
+    version: 'theme-rule-block-v1',
+    path: 'schemas/theme-rule-block-v1.json',
+    description: 'JSON Schema for composable theme source, cascade, semantic, and component alias blocks.',
+  },
+];
+
+export let UI_SCHEMAS = {
+  'component-descriptor-v1': {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    $id: 'https://rnd-pro.github.io/symbiote-node/schemas/component-descriptor-v1.json',
+    title: 'Symbiote Node Component Descriptor',
+    type: 'object',
+    additionalProperties: false,
+    required: ['tagName', 'className', 'module', 'specifier', 'importKind', 'category', 'description'],
+    properties: {
+      tagName: { type: 'string', pattern: '^[a-z][a-z0-9]*(-[a-z0-9]+)+$' },
+      className: { type: 'string', minLength: 1 },
+      module: { type: 'string', minLength: 1 },
+      specifier: { type: 'string', minLength: 1 },
+      exportName: { type: ['string', 'null'] },
+      importKind: { enum: ['named', 'side-effect'] },
+      category: { type: 'string', minLength: 1 },
+      description: { type: 'string', minLength: 1 },
+      internal: { type: 'boolean' },
+      contract: { $ref: '#/$defs/componentContract' },
+    },
+    $defs: {
+      componentContract: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          status: { enum: ['draft', 'stable'] },
+          schemaVersion: { const: 'component-descriptor-v1' },
+          dataSchema: { type: 'string' },
+          capabilities: {
+            type: 'array',
+            items: { type: 'string', minLength: 1 },
+            uniqueItems: true,
+          },
+          properties: {
+            type: 'array',
+            items: { $ref: '#/$defs/member' },
+          },
+          attributes: {
+            type: 'array',
+            items: { $ref: '#/$defs/member' },
+          },
+          methods: {
+            type: 'array',
+            items: { $ref: '#/$defs/member' },
+          },
+          events: {
+            type: 'array',
+            items: { $ref: '#/$defs/event' },
+          },
+          slots: {
+            type: 'array',
+            items: { $ref: '#/$defs/member' },
+          },
+          cssParts: {
+            type: 'array',
+            items: { $ref: '#/$defs/member' },
+          },
+          themeAliases: {
+            type: 'array',
+            items: { type: 'string', minLength: 1 },
+            uniqueItems: true,
+          },
+          notes: { type: 'string' },
+        },
+      },
+      member: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['name'],
+        properties: {
+          name: { type: 'string', minLength: 1 },
+          type: { type: 'string' },
+          description: { type: 'string' },
+          required: { type: 'boolean' },
+          readonly: { type: 'boolean' },
+        },
+      },
+      event: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['name'],
+        properties: {
+          name: { type: 'string', minLength: 1 },
+          description: { type: 'string' },
+          detail: {
+            type: 'array',
+            items: { $ref: '#/$defs/member' },
+          },
+        },
+      },
+    },
+  },
+  'runtime-ui-v1': {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    $id: 'https://rnd-pro.github.io/symbiote-node/schemas/runtime-ui-v1.json',
+    title: 'Symbiote Node Runtime UI Tree',
+    type: 'object',
+    additionalProperties: false,
+    required: ['version', 'root'],
+    properties: {
+      version: { const: 'runtime-ui-v1' },
+      metadata: { type: 'object', additionalProperties: true },
+      componentRegistries: {
+        type: 'array',
+        items: { $ref: '#/$defs/componentRegistry' },
+        uniqueItems: true,
+      },
+      theme: { $ref: '#/$defs/themeRef' },
+      root: { $ref: '#/$defs/node' },
+    },
+    $defs: {
+      componentRegistry: {
+        type: 'object',
+        additionalProperties: true,
+        required: ['id'],
+        properties: {
+          id: { type: 'string', minLength: 1 },
+          provider: { type: 'string', minLength: 1 },
+          schema: { type: 'string', minLength: 1 },
+        },
+      },
+      themeRef: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          name: { type: 'string' },
+          overrides: { type: 'object', additionalProperties: { type: 'string' } },
+        },
+      },
+      node: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['component'],
+        properties: {
+          id: { type: 'string' },
+          component: { type: 'string', minLength: 1 },
+          componentRegistry: { type: 'string', minLength: 1 },
+          props: { type: 'object', additionalProperties: true },
+          attrs: { type: 'object', additionalProperties: { type: ['string', 'number', 'boolean'] } },
+          layout: { $ref: '#/$defs/layout' },
+          bindings: { type: 'object', additionalProperties: { type: 'string' } },
+          events: { type: 'object', additionalProperties: { type: 'string' } },
+          theme: { $ref: '#/$defs/themeRef' },
+          children: {
+            type: 'array',
+            items: { $ref: '#/$defs/node' },
+          },
+        },
+      },
+      layout: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          direction: { enum: ['horizontal', 'vertical'] },
+          weight: { type: 'number', minimum: 0 },
+          rect: { $ref: '#/$defs/relativeRect' },
+          area: { type: 'string', minLength: 1 },
+        },
+      },
+      relativeRect: {
+        type: 'object',
+        additionalProperties: false,
+        required: ['x', 'y', 'width', 'height'],
+        properties: {
+          x: { type: 'number', minimum: 0, maximum: 1 },
+          y: { type: 'number', minimum: 0, maximum: 1 },
+          width: { type: 'number', minimum: 0, maximum: 1 },
+          height: { type: 'number', minimum: 0, maximum: 1 },
+        },
+      },
+    },
+  },
+  'theme-rule-block-v1': {
+    $schema: 'https://json-schema.org/draft/2020-12/schema',
+    $id: 'https://rnd-pro.github.io/symbiote-node/schemas/theme-rule-block-v1.json',
+    title: 'Symbiote Node Theme Rule Block',
+    type: 'object',
+    additionalProperties: false,
+    required: ['name', 'kind', 'description'],
+    properties: {
+      name: { type: 'string', minLength: 1 },
+      theme: { type: 'string', minLength: 1 },
+      kind: {
+        enum: [
+          'source-accent',
+          'color-cascade',
+          'geometry-cascade',
+          'typography-cascade',
+          'motion-effects',
+          'semantic-alias',
+          'component-alias',
+        ],
+      },
+      description: { type: 'string', minLength: 1 },
+      parameters: {
+        type: 'array',
+        items: {
+          type: 'object',
+          additionalProperties: false,
+          required: ['name', 'type', 'description'],
+          properties: {
+            name: { type: 'string', minLength: 1 },
+            type: { type: 'string', minLength: 1 },
+            description: { type: 'string', minLength: 1 },
+            default: { type: 'string' },
+            unit: { type: 'string' },
+          },
+        },
+      },
+      inputs: {
+        type: 'array',
+        items: { type: 'string', minLength: 1 },
+        uniqueItems: true,
+      },
+      outputs: {
+        type: 'array',
+        items: { type: 'string', minLength: 1 },
+        uniqueItems: true,
+      },
+      formula: { type: 'string' },
+      derivations: {
+        type: 'array',
+        items: {
+          type: 'object',
+          additionalProperties: false,
+          required: ['output', 'expression'],
+          properties: {
+            output: { type: 'string', minLength: 1 },
+            inputs: {
+              type: 'array',
+              items: { type: 'string', minLength: 1 },
+              uniqueItems: true,
+            },
+            expression: { type: 'string', minLength: 1 },
+            description: { type: 'string' },
+          },
+        },
+      },
+      appliesTo: {
+        type: 'array',
+        items: { type: 'string', minLength: 1 },
+        uniqueItems: true,
+      },
+    },
+  },
+};
+
+UI_SCHEMAS['component-descriptor-v2'] = JSON.parse(JSON.stringify(UI_SCHEMAS['component-descriptor-v1']));
+UI_SCHEMAS['component-descriptor-v2'].$id = 'https://rnd-pro.github.io/symbiote-ui/schemas/component-descriptor-v2.json';
+UI_SCHEMAS['component-descriptor-v2'].title = 'Symbiote UI Component Descriptor';
+UI_SCHEMAS['component-descriptor-v2'].$defs.componentContract.properties.schemaVersion = { const: 'component-descriptor-v2' };
+UI_SCHEMAS['component-descriptor-v2'].$defs.componentContract.properties.ssr = { $ref: '#/$defs/ssrContract' };
+UI_SCHEMAS['component-descriptor-v2'].$defs.componentContract.properties.webmcp = { $ref: '#/$defs/webMcpContract' };
+UI_SCHEMAS['component-descriptor-v2'].$defs.ssrContract = {
+  type: 'object',
+  additionalProperties: false,
+  required: ['mode'],
+  properties: {
+    mode: { enum: ['node-safe', 'ssr-entry-safe', 'jsda-ssr-renderable', 'hydrate-only', 'client-only'] },
+    importSafe: { type: 'boolean' },
+    jsdaRenderable: { type: 'boolean' },
+    requiresDom: { type: 'boolean' },
+    browserApis: {
+      type: 'array',
+      items: { type: 'string', minLength: 1 },
+      uniqueItems: true,
+    },
+    notes: { type: 'string' },
+  },
+};
+UI_SCHEMAS['component-descriptor-v2'].$defs.webMcpContract = {
+  type: 'object',
+  additionalProperties: false,
+  properties: {
+    documentation: { type: 'string' },
+    tools: {
+      type: 'array',
+      items: { $ref: '#/$defs/webMcpTool' },
+      uniqueItems: true,
+    },
+  },
+};
+UI_SCHEMAS['component-descriptor-v2'].$defs.webMcpTool = {
+  type: 'object',
+  additionalProperties: false,
+  required: ['name', 'description', 'inputSchema'],
+  properties: {
+    name: { type: 'string', minLength: 1 },
+    description: { type: 'string', minLength: 1 },
+    inputSchema: { type: 'object', additionalProperties: true },
+    annotations: { type: 'object', additionalProperties: true },
+    exposedTo: {
+      type: 'array',
+      items: { enum: ['agent', 'assistant', 'host'] },
+      uniqueItems: true,
+    },
+    visibilityDeps: {
+      type: 'array',
+      items: { type: 'string', minLength: 1 },
+      uniqueItems: true,
+    },
+  },
+};
+
+export function listUiSchemaVersions() {
+  return UI_SCHEMA_VERSIONS.map((schema) => schema.version);
+}
+
+export function getUiSchema(version) {
+  return UI_SCHEMAS[version];
+}

package/menu/ContextMenu/ContextMenu.css.js

@@ -0,0 +1,61 @@
+/**
+ * ContextMenu styles
+ * @module symbiote-node/menu/ContextMenu.css
+ */
+import { css } from '@symbiotejs/symbiote';
+
+export let styles = css`
+  context-menu {
+    position: absolute;
+    inset: 0;
+    z-index: var(--sn-ctx-z, var(--sn-overlay-z-base, 20000));
+    pointer-events: none;
+
+    &[hidden] {
+      display: none;
+    }
+
+    & .sn-ctx-backdrop {
+      position: absolute;
+      inset: 0;
+      pointer-events: all;
+    }
+
+    & .sn-ctx-menu {
+      position: absolute;
+      pointer-events: all;
+      min-width: 160px;
+      background: var(--sn-ctx-bg);
+      border: 1px solid var(--sn-ctx-border);
+      border-radius: 8px;
+      box-shadow: 0 8px 24px var(--sn-shadow-color);
+      padding: 4px;
+      overflow: hidden;
+    }
+  }
+
+  .sn-ctx-btn {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    width: 100%;
+    padding: 8px 12px;
+    border: none;
+    background: transparent;
+    color: var(--sn-ctx-color);
+    font-family: var(--sn-font);
+    font-size: 13px;
+    cursor: pointer;
+    border-radius: 4px;
+    transition: background 0.1s;
+
+    &:hover {
+      background: var(--sn-ctx-hover);
+    }
+  }
+
+  .sn-ctx-icon {
+    font-size: 18px;
+    opacity: 0.7;
+  }
+`;

package/menu/ContextMenu/ContextMenu.js

@@ -0,0 +1,82 @@
+/**
+ * ContextMenu — right-click menu for graph editor
+ *
+ * Shows contextual actions for canvas, nodes, and connections.
+ * Triple-file component: .js + .tpl.js + .css.js
+ *
+ * @module symbiote-node/components/ContextMenu
+ */
+
+import Symbiote from '@symbiotejs/symbiote';
+import { ensureMaterialSymbols } from '../../icons/MaterialSymbols.js';
+import { bringOverlayToFront } from '../../ui/overlay-stack.js';
+import { template, ctxItemTemplate } from './ContextMenu.tpl.js';
+import { styles } from './ContextMenu.css.js';
+
+class CtxItem extends Symbiote {
+  init$ = {
+    label: '',
+    icon: '',
+    onclick: () => {
+      this.$['^onItemClick'](this.$.label);
+    },
+  };
+}
+
+CtxItem.template = ctxItemTemplate;
+CtxItem.reg('ctx-item');
+
+export class ContextMenu extends Symbiote {
+  /** @type {Map<string, function>} */
+  _actions = new Map();
+
+  init$ = {
+    items: [],
+    visible: false,
+    onBackdropClick: () => this.hide(),
+    onItemClick: (label) => {
+      let action = this._actions.get(label);
+      if (action) action();
+      this.hide();
+    },
+  };
+
+  /**
+   * Show the menu at screen coordinates
+   * @param {number} x - Screen X
+   * @param {number} y - Screen Y
+   * @param {Array<{label: string, icon: string, action: function}>} items
+   */
+  show(x, y, items) {
+    ensureMaterialSymbols(items.map((item) => item.icon));
+    this._actions.clear();
+    for (const item of items) {
+      this._actions.set(item.label, item.action);
+    }
+    this.$.items = items.map((i) => ({ label: i.label, icon: i.icon }));
+    let menu = this.querySelector('.sn-ctx-menu');
+    if (menu) {
+      menu.style.left = `${x}px`;
+      menu.style.top = `${y}px`;
+    }
+    bringOverlayToFront(this);
+    this.$.visible = true;
+  }
+
+  /** Hide menu */
+  hide() {
+    this.$.visible = false;
+    this.$.items = [];
+    this._actions.clear();
+  }
+
+  renderCallback() {
+    this.sub('visible', (val) => {
+      this.toggleAttribute('hidden', !val);
+    });
+  }
+}
+
+ContextMenu.template = template;
+ContextMenu.rootStyles = styles;
+ContextMenu.reg('context-menu');

package/menu/ContextMenu/ContextMenu.tpl.js

@@ -0,0 +1,19 @@
+/**
+ * ContextMenu template
+ * @module symbiote-node/menu/ContextMenu.tpl
+ */
+import { html } from '@symbiotejs/symbiote';
+
+export let template = html`
+  <div class="sn-ctx-backdrop" ${{ onclick: 'onBackdropClick' }}></div>
+  <div class="sn-ctx-menu">
+    <div class="ctx-items" ${{ itemize: 'items', 'item-tag': 'ctx-item' }}></div>
+  </div>
+`;
+
+export let ctxItemTemplate = html`
+  <button class="sn-ctx-btn" ${{ onclick: 'onclick' }}>
+    <span class="material-symbols-outlined sn-ctx-icon">{{icon}}</span>
+    <span>{{label}}</span>
+  </button>
+`;

package/navigation/QuickOpen/QuickOpen.css.js

@@ -0,0 +1,92 @@
+export default `
+:host,
+quick-open {
+  display: block;
+}
+
+  :host { position: fixed; inset: 0; z-index: 9999; pointer-events: none; },
+  quick-open { position: fixed; inset: 0; z-index: 9999; pointer-events: none; }
+  .qo-overlay {
+    position: fixed; inset: 0; z-index: 9999;
+    background: var(--sn-bg-overlay);
+    display: flex; justify-content: center; padding-top: 15vh;
+    pointer-events: all;
+    animation: qo-fadein 100ms ease;
+  }
+  .qo-overlay[hidden] { display: none !important; }
+  .qo-hidden { display: none !important; pointer-events: none; }
+  .qo-dialog {
+    width: 520px;
+    max-height: 420px;
+    background: var(--sn-panel-bg);
+    border: 1px solid var(--sn-node-border);
+    border-radius: 10px;
+    box-shadow: 0 20px 60px var(--sn-bg-overlay);
+    overflow: hidden;
+    display: flex;
+    flex-direction: column;
+  }
+  .qo-input-wrap {
+    display: flex;
+    align-items: center;
+    padding: 8px 12px;
+    gap: 8px;
+    border-bottom: 1px solid var(--sn-node-border);
+  }
+  .qo-icon { color: var(--sn-text-dim); font-size: 20px; }
+  .qo-input {
+    flex: 1;
+    background: transparent;
+    border: none;
+    color: var(--sn-text);
+    font-size: 15px;
+    font-family: inherit;
+    outline: none;
+    padding: 6px 0;
+  }
+  .qo-input::placeholder { color: var(--sn-text-dim); }
+  .qo-kbd {
+    font-size: 10px;
+    padding: 2px 6px;
+    border-radius: 4px;
+    background: var(--sn-node-bg);
+    border: 1px solid var(--sn-node-border);
+    color: var(--sn-text-dim);
+    font-family: monospace;
+  }
+  .qo-results {
+    overflow-y: auto;
+    padding: 4px 0;
+    max-height: 350px;
+  }
+  .qo-item {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    padding: 8px 16px;
+    cursor: pointer;
+    transition: background 80ms ease;
+  }
+  .qo-item:hover { background: var(--sn-node-hover); }
+  .qo-item.qo-selected {
+    background: var(--sn-accent-bg);
+  }
+  .qo-name {
+    font-size: 13px;
+    color: var(--sn-text);
+    font-weight: 500;
+  }
+  .qo-path {
+    font-size: 11px;
+    color: var(--sn-text-dim);
+    margin-left: auto;
+    font-family: var(--sn-font-mono);
+  }
+  .qo-empty {
+    padding: 20px;
+    text-align: center;
+    color: var(--sn-text-dim);
+    font-style: italic;
+  }
+  @keyframes qo-fadein { from { opacity: 0; } to { opacity: 1; } }
+`;