@ccslabs/xtend 0.1.0-rc.1 → 0.1.2

package/xtendrmt/rmt-core.esm.js

@@ -12410,11 +12410,25 @@ __XTENDRMT_GLOBAL__.AppModules = __XTENDRMT_GLOBAL__.AppModules || {};
         };
     }
 
+    function resolveSurfaceRuntimeType(type, kind = '') {
+        const candidate = clampString(type, '').toLowerCase();
+        const semanticKind = clampString(kind, '').toLowerCase();
+        const semantic = semanticKind || candidate;
+        if (['root', 'workspace', 'page', 'card', 'list', 'region', 'overlay-host'].includes(semantic)) return 'region';
+        if (['panel', 'side-panel', 'sidepanel'].includes(semantic)) return 'side-panel';
+        if (['modal', 'dialog', 'drawer', 'popover', 'tooltip', 'toast', 'lightbox', 'menu'].includes(semantic)) return semantic;
+        if (['root', 'workspace', 'page', 'card', 'list', 'region', 'overlay-host'].includes(candidate)) return 'region';
+        if (['panel', 'side-panel', 'sidepanel'].includes(candidate)) return 'side-panel';
+        if (['modal', 'dialog', 'drawer', 'popover', 'tooltip', 'toast', 'lightbox', 'menu'].includes(candidate)) return candidate;
+        return candidate || 'window';
+    }
+
     function normalizeSurfaceAdapterEntry(surfaceEntry = {}, indexes = {}, options = {}) {
         const entry = toPlainObject(surfaceEntry);
         const record = toPlainObject(entry.record || entry);
         const id = clampString(entry.id || record.id, '');
-        const type = clampString(entry.type || record.type, 'window');
+        const kind = clampString(entry.kind || record.kind, '');
+        const type = resolveSurfaceRuntimeType(entry.type || record.type || kind || 'window', kind);
         const schedule = normalizeScheduleReference(entry.scheduleRef || record.schedule);
         const componentRef = clampString(entry.componentId || record.component, '');
         const managerRef = clampString(entry.managerId || record.manager, '');
@@ -12432,6 +12446,7 @@ __XTENDRMT_GLOBAL__.AppModules = __XTENDRMT_GLOBAL__.AppModules || {};
             surfaceId: id,
             schema: clampString(record.schema, 'xtend.surface.record.v1'),
             type,
+            kind: kind || type,
             adapter: clampString(entry.adapterId || record.adapter, SURFACE_ADAPTER_ID),
             manager: managerRef,
             component: componentRef,
@@ -12520,7 +12535,7 @@ __XTENDRMT_GLOBAL__.AppModules = __XTENDRMT_GLOBAL__.AppModules || {};
             sourceDiagnostics: Object.freeze(cloneSerializable(documentRecord.diagnostics, [])),
             surfaceCount: surfaces.length,
             scheduleRefs: uniqueValues(surfaces.map((surface) => surface.scheduleRef)),
-            modelFields: Object.freeze(['surfaceId', 'type', 'manager', 'component', 'route', 'scheduleRef', 'stateKey', 'bounds', 'placement', 'mode', 'capabilities', 'a11y', 'persistence', 'metadata', 'remoteSurface', 'remotePolicy'])
+            modelFields: Object.freeze(['surfaceId', 'type', 'kind', 'manager', 'component', 'route', 'scheduleRef', 'stateKey', 'bounds', 'placement', 'mode', 'capabilities', 'a11y', 'persistence', 'metadata', 'remoteSurface', 'remotePolicy'])
         });
     }
 
@@ -12592,6 +12607,7 @@ __XTENDRMT_GLOBAL__.AppModules = __XTENDRMT_GLOBAL__.AppModules || {};
             schema: surface.schema,
             id: surface.id,
             type: surface.type,
+            kind: surface.kind || surface.type,
             manager: managerId,
             stateKey: surface.stateKey,
             defaultOpen: surface.defaultOpen,
@@ -12659,20 +12675,29 @@ __XTENDRMT_GLOBAL__.AppModules = __XTENDRMT_GLOBAL__.AppModules || {};
         const metadata = toPlainObject(surface.metadata);
         const explicitTag = clampString(metadata.surfaceTag || metadata.surfaceComponentTag || metadata.xtendSurfaceTag, '');
         if (explicitTag) return explicitTag;
-        const type = clampString(surface.type, 'window').toLowerCase();
+        const kind = clampString(surface.kind || metadata.surfaceKind, '').toLowerCase();
+        const type = clampString(surface.type, kind || 'window').toLowerCase();
+        const semantic = kind || type;
+        if (['root', 'workspace', 'page', 'card', 'list', 'region', 'overlay-host'].includes(semantic) || type === 'region') return 'x-surface-region';
         if (type === 'side-panel' || type === 'sidepanel' || type === 'panel') return 'x-side-panel';
         if (type === 'modal') return 'x-modal';
         if (type === 'dialog') return 'x-dialog';
         if (type === 'drawer') return 'x-drawer';
         if (type === 'popover') return 'x-popover';
         if (type === 'tooltip') return 'x-tooltip';
+        if (type === 'toast') return 'x-toast';
+        if (type === 'lightbox') return 'x-lightbox';
+        if (type === 'menu') return 'x-menu';
         return 'x-surface-window';
     }
 
     function resolveSurfaceMaterializedSlot(surface = {}) {
-        const type = clampString(surface.type, 'window').toLowerCase();
+        const kind = clampString(surface.kind, '').toLowerCase();
+        const type = clampString(surface.type, kind || 'window').toLowerCase();
+        const semantic = kind || type;
         if (type === 'side-panel' || type === 'sidepanel' || type === 'panel') return 'panels';
-        if (type === 'modal' || type === 'dialog' || type === 'drawer' || type === 'popover' || type === 'tooltip') return 'overlays';
+        if (type === 'modal' || type === 'dialog' || type === 'drawer' || type === 'popover' || type === 'tooltip' || type === 'toast' || type === 'lightbox' || type === 'menu') return 'overlays';
+        if (['root', 'workspace', 'page', 'card', 'list', 'region', 'overlay-host'].includes(semantic) || type === 'region') return '';
         return 'windows';
     }
 
@@ -12859,7 +12884,7 @@ __XTENDRMT_GLOBAL__.AppModules = __XTENDRMT_GLOBAL__.AppModules || {};
         setSurfaceElementAttribute(surfaceElement, 'id', surface.id);
         setSurfaceElementAttribute(surfaceElement, 'surface-id', surface.id);
         setSurfaceElementAttribute(surfaceElement, 'label', label);
-        setSurfaceElementAttribute(surfaceElement, 'slot', slotName);
+        if (slotName) setSurfaceElementAttribute(surfaceElement, 'slot', slotName);
         setSurfaceElementAttribute(surfaceElement, 'data-rmt-surface', surface.id);
         setSurfaceElementAttribute(surfaceElement, 'data-rmt-surface-adapter', SURFACE_ADAPTER_ID);
         setSurfaceElementAttribute(surfaceElement, 'data-rmt-native-surface', 'true');
@@ -12869,6 +12894,7 @@ __XTENDRMT_GLOBAL__.AppModules = __XTENDRMT_GLOBAL__.AppModules || {};
         setSurfaceElementAttribute(surfaceElement, 'data-rmt-route', surface.route);
         setSurfaceElementAttribute(surfaceElement, 'data-rmt-schedule', surface.scheduleRef);
         setSurfaceElementAttribute(surfaceElement, 'data-surface-type', surface.type);
+        setSurfaceElementAttribute(surfaceElement, 'data-surface-kind', surface.kind);
         setSurfaceElementAttribute(surfaceElement, 'data-surface-layer', surface.layer);
         setSurfaceElementAttribute(surfaceElement, 'data-surface-state-key', surface.stateKey);
         setSurfaceElementAttribute(surfaceElement, 'data-surface-hydration-policy', resolveSurfaceHydrationPolicy(surface));

package/xtendrmt/rmt-dom-descriptor-renderer.d.ts

@@ -0,0 +1,107 @@
+export const RMT_DOM_DESCRIPTOR_RENDERER_DIAGNOSTIC_SCHEMA: 'xtend.epic18.rmt-dom-renderer-diagnostic.v1';
+export const RMT_DOM_DESCRIPTOR_RENDERER_SCHEMA: 'xtend.epic18.rmt-dom-descriptor-renderer.v1';
+export const TRUSTED_DOM_BOUNDARY: 'xtend.rmt.trusted-dom-boundary.explicit';
+
+export interface RmtDomDescriptorSource {
+  documentId?: string;
+  templateId?: string;
+  nodeId?: string;
+  pointer?: string;
+  line?: number | null;
+  column?: number | null;
+}
+
+export interface RmtDomDescriptorDiagnostic {
+  schema: typeof RMT_DOM_DESCRIPTOR_RENDERER_DIAGNOSTIC_SCHEMA;
+  code: string;
+  message: string;
+  severity: 'info' | 'warning' | 'error';
+  source?: RmtDomDescriptorSource;
+  sink?: string;
+  filePath?: string;
+}
+
+export interface RmtDomDescriptorRendererOptions {
+  documentTarget?: Document;
+  diagnosticsHub?: {
+    publish(channel: string, payload: unknown, meta?: Record<string, unknown>): unknown;
+  };
+  diagnosticChannel?: string;
+}
+
+export interface RmtComponentRegistryLike {
+  resolveComponentCapability?(tag: string): unknown;
+  buildComponentDescriptor?(input: Record<string, unknown>, options?: Record<string, unknown>): unknown;
+  bindComponentInstance?(element: Element, binding?: Record<string, unknown>, options?: Record<string, unknown>): unknown;
+}
+
+export interface RmtDomDescriptorRenderOptions {
+  model?: Record<string, unknown>;
+  selectorValues?: Record<string, unknown>;
+  components?: Map<string, unknown> | unknown[];
+  templates?: Map<string, unknown> | unknown[];
+  slots?: Map<string, unknown> | unknown[];
+  selectors?: Map<string, unknown> | unknown[];
+  componentRegistry?: RmtComponentRegistryLike;
+  registry?: RmtComponentRegistryLike;
+  componentBindingOptions?: Record<string, unknown>;
+  stateBridge?: {
+    read?: (key: string) => unknown;
+    write?: (key: string, value: unknown) => void;
+  };
+  refs?: Map<string, Element>;
+  source?: RmtDomDescriptorSource;
+  dispatchEvent?: (event: unknown) => void;
+  trustedDomRenderer?: (descriptor: unknown, context: unknown) => Node | Node[];
+}
+
+export interface RmtDomDescriptorTransformExpression {
+  op?: 'path' | 'map' | 'filter' | 'reduce' | 'countBy' | 'slice' | 'contains' | 'uppercase' | 'lowercase' | 'replace' | 'concat' | 'interpolate' | 'formatBytes' | 'formatDateShort' | 'formatDuration' | 'fallback' | string;
+  operator?: string;
+  kind?: string;
+  format?: string;
+  value?: unknown;
+  from?: unknown;
+  source?: unknown;
+  path?: string;
+  expression?: unknown;
+  where?: unknown[] | unknown;
+  filter?: unknown[] | unknown;
+  rules?: unknown[] | unknown;
+  values?: unknown[];
+  parts?: unknown[];
+  separator?: string;
+  start?: unknown;
+  end?: unknown;
+  search?: unknown;
+  replacement?: unknown;
+  flags?: string;
+  fallback?: unknown;
+  key?: unknown;
+  mode?: string;
+}
+
+export interface RmtNoManualHtmlGate {
+  schema: 'xtend.epic18.no-manual-html-gate.v1';
+  scanText(sourceText: string, options?: { filePath?: string }): RmtDomDescriptorDiagnostic[];
+  scanFiles(files: Record<string, string>): RmtDomDescriptorDiagnostic[];
+}
+
+export interface RmtDomDescriptorRenderer {
+  schema: typeof RMT_DOM_DESCRIPTOR_RENDERER_SCHEMA;
+  trustedDomBoundary: typeof TRUSTED_DOM_BOUNDARY;
+  render(root: Element, descriptor: unknown, options?: RmtDomDescriptorRenderOptions): {
+    schema: 'xtend.epic18.rmt-dom-render-result.v1';
+    root: Element;
+    nodeCount: number;
+    diagnostics: RmtDomDescriptorDiagnostic[];
+  };
+  renderNode(descriptor: unknown, options?: RmtDomDescriptorRenderOptions): Node | Node[];
+  renderKeyed(root: Element, descriptors: unknown[], options?: RmtDomDescriptorRenderOptions): Node[];
+  resolveValue(value: unknown, options?: RmtDomDescriptorRenderOptions & { item?: unknown }): unknown;
+  createNoManualHtmlGate(options?: unknown): RmtNoManualHtmlGate;
+  listDiagnostics(): RmtDomDescriptorDiagnostic[];
+}
+
+export function createNoManualHtmlGate(options?: unknown): RmtNoManualHtmlGate;
+export function createRmtDomDescriptorRenderer(options?: RmtDomDescriptorRendererOptions): RmtDomDescriptorRenderer;