@ccslabs/xtend 0.1.0-rc.1 → 0.1.2

package/xtendrmt/rmt-runtime.browser.js

@@ -12830,11 +12830,25 @@
         };
     }
 
+    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, '');
@@ -12852,6 +12866,7 @@
             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,
@@ -12940,7 +12955,7 @@
             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'])
         });
     }
 
@@ -13012,6 +13027,7 @@
             schema: surface.schema,
             id: surface.id,
             type: surface.type,
+            kind: surface.kind || surface.type,
             manager: managerId,
             stateKey: surface.stateKey,
             defaultOpen: surface.defaultOpen,
@@ -13079,20 +13095,29 @@
         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';
     }
 
@@ -13279,7 +13304,7 @@
         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');
@@ -13289,6 +13314,7 @@
         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-runtime.esm.js

@@ -12831,11 +12831,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, '');
@@ -12853,6 +12867,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,
@@ -12941,7 +12956,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'])
         });
     }
 
@@ -13013,6 +13028,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,
@@ -13080,20 +13096,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';
     }
 
@@ -13280,7 +13305,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');
@@ -13290,6 +13315,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-state-selector-runtime.d.ts

@@ -0,0 +1,166 @@
+export const RMT_STATE_SELECTOR_DIAGNOSTIC_SCHEMA: 'xtend.epic18.rmt-state-selector-diagnostic.v1';
+export const RMT_STATE_SELECTOR_RUNTIME_SCHEMA: 'xtend.epic18.rmt-state-selector-runtime.v1';
+
+export type RmtStateType = 'collection' | 'array' | 'object' | 'string' | 'number' | 'boolean' | 'nullable' | string;
+
+export interface RmtStateDefinition {
+  id: string;
+  type: RmtStateType;
+  schema?: string;
+  initial?: unknown;
+  preserve?: 'attribute-sync' | 'component-state' | string;
+  xstateKey?: string;
+}
+
+export interface RmtSelectorDefinition {
+  id: string;
+  from: string;
+  path?: string;
+  where?: unknown[] | unknown;
+  filter?: unknown[] | unknown;
+  find?: unknown[] | unknown;
+  sort?: { by?: string; path?: string; direction?: 'asc' | 'desc' };
+  slice?: { start?: unknown; end?: unknown };
+  map?: string | { path?: string; expression?: unknown; value?: unknown };
+  transform?: RmtTransformExpression;
+  countBy?: string;
+  key?: string;
+  compute?: 'count' | 'countBy' | 'count-by' | 'not-empty' | 'empty' | 'first' | 'boolean' | string;
+  structural?: boolean;
+  output?: string;
+}
+
+export interface RmtDerivedDefinition {
+  id: string;
+  from: string;
+  path?: string;
+  expression?: unknown;
+  transform?: RmtTransformExpression;
+  countBy?: string;
+  compute?: 'count' | 'countBy' | 'count-by' | 'not-empty' | 'empty' | 'boolean' | string;
+  structural?: boolean;
+  output?: string;
+}
+
+export interface RmtTransformExpression {
+  op?: 'path' | 'map' | 'filter' | 'reduce' | 'countBy' | 'slice' | 'contains' | 'uppercase' | 'lowercase' | 'replace' | 'concat' | 'interpolate' | 'formatBytes' | 'formatDateShort' | 'formatDuration' | 'fallback' | string;
+  operator?: string;
+  kind?: string;
+  compute?: 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 RmtReducerDefinition {
+  id: string;
+  command?: string;
+  state: string;
+  set?: string;
+  patch?: Record<string, unknown>;
+  toggle?: string;
+}
+
+export interface RmtStateSelectorSnapshot {
+  schema: 'xtend.epic18.rmt-state-selector-snapshot.v1';
+  states: Record<string, unknown>;
+  selectors: Record<string, unknown>;
+  derived: Record<string, unknown>;
+  model: Record<string, unknown>;
+}
+
+export interface RmtStatePatchPlan {
+  schema: 'xtend.epic18.rmt-state-patch-plan.v1';
+  strategy: 'attribute-sync' | 'rerender';
+  preserveDom: boolean;
+  structural: boolean;
+  changedStates: string[];
+  changedSelectors: string[];
+  changedDerived: string[];
+  structuralStates: string[];
+  structuralSelectors: string[];
+  structuralDerived: string[];
+}
+
+export interface RmtXStateBridge {
+  schema: typeof RMT_STATE_SELECTOR_RUNTIME_SCHEMA;
+  external: boolean;
+  set(key: string, value: unknown, metadata?: Record<string, unknown>): boolean;
+  get<T = unknown>(key: string, fallbackValue?: T): T;
+  mirrorSnapshot(snapshot: RmtStateSelectorSnapshot, metadata?: Record<string, unknown>): void;
+  subscribe(listener: (event: unknown) => void): () => void;
+  listWrites(): Array<{ key: string; value: unknown; mirrored: boolean; metadata: Record<string, unknown> }>;
+  listReads(): Array<{ key: string; hit: boolean }>;
+}
+
+export interface RmtStateSelectorRuntime {
+  schema: typeof RMT_STATE_SELECTOR_RUNTIME_SCHEMA;
+  stateDefinitions: RmtStateDefinition[];
+  selectorDefinitions: RmtSelectorDefinition[];
+  derivedDefinitions: RmtDerivedDefinition[];
+  reducers: RmtReducerDefinition[];
+  getState<T = unknown>(id: string): T;
+  setState(id: string, value: unknown, metadata?: Record<string, unknown>): { patchPlan: RmtStatePatchPlan };
+  patchState(id: string, patch: Record<string, unknown>, metadata?: Record<string, unknown>): { patchPlan: RmtStatePatchPlan };
+  dispatch(commandId: string, payload?: Record<string, unknown>, metadata?: Record<string, unknown>): { patchPlan: RmtStatePatchPlan };
+  select<T = unknown>(selectorId: string, params?: Record<string, unknown>): T;
+  getSelectorValues(): Record<string, unknown>;
+  getDerivedValues(): Record<string, unknown>;
+  getRenderModel(): Record<string, unknown>;
+  createRenderContext(extra?: Record<string, unknown>): Record<string, unknown>;
+  resolve(expression: unknown, item?: unknown, payload?: Record<string, unknown>, params?: Record<string, unknown>): unknown;
+  snapshot(): RmtStateSelectorSnapshot;
+  planPatch(previousSnapshot: RmtStateSelectorSnapshot, nextSnapshot: RmtStateSelectorSnapshot): RmtStatePatchPlan;
+  subscribe(listener: (event: { previous: RmtStateSelectorSnapshot; next: RmtStateSelectorSnapshot; patchPlan: RmtStatePatchPlan }) => void): () => void;
+  connectXState(target: unknown): RmtXStateBridge;
+  xstateBridge: RmtXStateBridge;
+  listDiagnostics(): unknown[];
+}
+
+export interface RmtStateSelectorRuntimeOptions {
+  states?: RmtStateDefinition[];
+  state?: RmtStateDefinition[];
+  selectors?: RmtSelectorDefinition[];
+  derive?: RmtDerivedDefinition[];
+  derived?: RmtDerivedDefinition[];
+  reducers?: RmtReducerDefinition[];
+  commands?: RmtReducerDefinition[];
+  initialState?: Record<string, unknown>;
+  xstate?: unknown;
+  diagnosticsHub?: { publish(channel: string, payload: unknown, meta?: Record<string, unknown>): unknown };
+  diagnosticChannel?: string;
+}
+
+export interface RmtStateBindingApplication {
+  schema: 'xtend.epic18.rmt-state-binding-application.v1';
+  strategy: 'attribute-sync' | string;
+  replacedRoot: false;
+  operationCount: number;
+  operations: Array<Record<string, unknown>>;
+}
+
+export function createRmtXStateBridge(options?: { xstate?: unknown }): RmtXStateBridge;
+export function createRmtStateSelectorRuntime(options?: RmtStateSelectorRuntimeOptions): RmtStateSelectorRuntime;
+export function planRmtStatePatch(previousSnapshot: RmtStateSelectorSnapshot, nextSnapshot: RmtStateSelectorSnapshot, options?: Record<string, unknown>): RmtStatePatchPlan;
+export function applyRmtStateBindings(root: Element, bindings: unknown[], runtime: RmtStateSelectorRuntime, options?: Record<string, unknown>): RmtStateBindingApplication;
+export function createRmtStateBindingAdapter(options?: Record<string, unknown>): {
+  schema: typeof RMT_STATE_SELECTOR_RUNTIME_SCHEMA;
+  apply(root: Element, bindings: unknown[], runtime: RmtStateSelectorRuntime): RmtStateBindingApplication;
+};