@pwfabric/runtime 0.0.0-stage → 1.0.0-rc.0

package/dist/render/entity-facade-context.js

@@ -0,0 +1,37 @@
+/**
+ * Entity Facade React Context
+ *
+ * Provides EntityFacade to the surface render tree via React
+ * context. Pattern mirrors SurfaceRoutingContext / useSurfaceRouting().
+ *
+ * Injection point: EntityFacadeContext.Provider wraps BehaviorSurfaceProvider
+ * inside SurfaceRenderer when entityFacade prop is supplied.
+ *
+ * @module @pwfabric/runtime/render/entity-facade-context
+ */
+import { createContext, useContext } from 'react';
+/**
+ * React context that carries an EntityFacade instance through the render tree.
+ * Defaults to null — blocks that require entity access check for null and
+ * gracefully handle the absent-facade case.
+ */
+export const EntityFacadeContext = createContext(null);
+/**
+ * Returns the EntityFacade from the nearest EntityFacadeContext.Provider.
+ * Returns null when no provider is present (entity support not configured).
+ *
+ * @example
+ * ```tsx
+ * import { useEntityFacade } from '@pwfabric/runtime/render'
+ *
+ * function MyBlock() {
+ *   const facade = useEntityFacade()
+ *   if (!facade) return null  // No entity support configured
+ *   const result = await facade.store.query('Employee', {})
+ * }
+ * ```
+ */
+export function useEntityFacade() {
+    return useContext(EntityFacadeContext);
+}
+//# sourceMappingURL=entity-facade-context.js.map

package/dist/render/entity-facade-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-facade-context.js","sourceRoot":"","sources":["../../src/render/entity-facade-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAGjD;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAsB,IAAI,CAAC,CAAA;AAE3E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,CAAC,mBAAmB,CAAC,CAAA;AACxC,CAAC"}

package/dist/render/group-states-css.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Group-hover scoped CSS generation (Tailwind `group` + `group-hover:`).
+ *
+ * A parent container marked `groupRoot: true` is a hover SOURCE: hovering it
+ * restyles descendants that declare `groupStates.hover`. `block.style` is inline
+ * and can express neither the ancestor `:hover` nor the descendant relationship,
+ * so the runtime emits a scoped descendant rule keyed by BOTH block ids:
+ *
+ *   `[data-pw-surface] [data-block-id="<rootId>"]:hover [data-block-id="<thisId>"]{ … }`
+ *
+ * The host element already rendered for every block (`data-block-id`) is
+ * sufficient on both ends — no extra attribute is needed. Keys are CSS camelCase
+ * property names (converted to kebab-case); declarations are emitted with
+ * `!important` because a block COMPONENT often applies the same property inline
+ * with its own default and inline beats any plain stylesheet rule. Scoped to the
+ * one descendant under the one root.
+ *
+ * Only the NEAREST ancestor with `groupRoot:true` drives a block's
+ * `groupStates`; a block with `groupStates.hover` but no `groupRoot` ancestor
+ * emits zero bytes. Surfaces using no `groupStates` emit zero bytes so existing
+ * surfaces are byte-identical.
+ *
+ * @module @pwfabric/runtime/render/group-states-css
+ */
+import type { Block } from '@pwfabric/core';
+/**
+ * Emit the scoped group-hover rule for a single descendant block, given the id
+ * of the nearest `groupRoot` ancestor. Targets
+ * `[data-block-id="<rootId>"]:hover [data-block-id="<thisId>"]` scoped under the
+ * surface root. Returns '' when the descendant declares no non-empty
+ * `groupStates.hover` record.
+ */
+export declare function blockGroupStatesCss(rootId: string, thisId: string, groupStates: NonNullable<Block['groupStates']>, surfaceId?: string): string;
+/**
+ * Walk a surface block tree tracking the nearest ancestor marked
+ * `groupRoot: true`; for each block declaring `groupStates.hover` UNDER such an
+ * ancestor, concatenate its scoped group-hover CSS. Blocks with `groupStates`
+ * but no `groupRoot` ancestor — and surfaces with no `groupStates` at all —
+ * emit zero bytes (existing surfaces byte-identical).
+ */
+export declare function collectGroupStatesCss(blocks: readonly Block[], surfaceId?: string): string;
+//# sourceMappingURL=group-states-css.d.ts.map

package/dist/render/group-states-css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-states-css.d.ts","sourceRoot":"","sources":["../../src/render/group-states-css.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAU3C;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,EAC9C,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAOR;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAe1F"}

package/dist/render/group-states-css.js

@@ -0,0 +1,73 @@
+/**
+ * Group-hover scoped CSS generation (Tailwind `group` + `group-hover:`).
+ *
+ * A parent container marked `groupRoot: true` is a hover SOURCE: hovering it
+ * restyles descendants that declare `groupStates.hover`. `block.style` is inline
+ * and can express neither the ancestor `:hover` nor the descendant relationship,
+ * so the runtime emits a scoped descendant rule keyed by BOTH block ids:
+ *
+ *   `[data-pw-surface] [data-block-id="<rootId>"]:hover [data-block-id="<thisId>"]{ … }`
+ *
+ * The host element already rendered for every block (`data-block-id`) is
+ * sufficient on both ends — no extra attribute is needed. Keys are CSS camelCase
+ * property names (converted to kebab-case); declarations are emitted with
+ * `!important` because a block COMPONENT often applies the same property inline
+ * with its own default and inline beats any plain stylesheet rule. Scoped to the
+ * one descendant under the one root.
+ *
+ * Only the NEAREST ancestor with `groupRoot:true` drives a block's
+ * `groupStates`; a block with `groupStates.hover` but no `groupRoot` ancestor
+ * emits zero bytes. Surfaces using no `groupStates` emit zero bytes so existing
+ * surfaces are byte-identical.
+ *
+ * @module @pwfabric/runtime/render/group-states-css
+ */
+import { blockIdAttr, blockSelector, camelToKebab } from './scoped-css.js';
+/** Serialize a camelCase decl record to `prop:value !important;…` (values pass through). */
+function declsToCss(decls) {
+    return Object.entries(decls)
+        .map(([prop, value]) => `${camelToKebab(prop)}:${value} !important`)
+        .join(';');
+}
+/**
+ * Emit the scoped group-hover rule for a single descendant block, given the id
+ * of the nearest `groupRoot` ancestor. Targets
+ * `[data-block-id="<rootId>"]:hover [data-block-id="<thisId>"]` scoped under the
+ * surface root. Returns '' when the descendant declares no non-empty
+ * `groupStates.hover` record.
+ */
+export function blockGroupStatesCss(rootId, thisId, groupStates, surfaceId) {
+    const decls = groupStates.hover;
+    if (!decls || Object.keys(decls).length === 0)
+        return '';
+    // `blockSelector(rootId)` already includes the `[data-pw-surface]` prefix; the
+    // descendant half is just the bare `[data-block-id]` attribute selector (the
+    // shared surface scope is carried by the root half).
+    return `${blockSelector(rootId, surfaceId)}:hover ${blockIdAttr(thisId)}{${declsToCss(decls)}}`;
+}
+/**
+ * Walk a surface block tree tracking the nearest ancestor marked
+ * `groupRoot: true`; for each block declaring `groupStates.hover` UNDER such an
+ * ancestor, concatenate its scoped group-hover CSS. Blocks with `groupStates`
+ * but no `groupRoot` ancestor — and surfaces with no `groupStates` at all —
+ * emit zero bytes (existing surfaces byte-identical).
+ */
+export function collectGroupStatesCss(blocks, surfaceId) {
+    let css = '';
+    const walk = (block, nearestRootId) => {
+        if (block.groupStates && nearestRootId !== undefined) {
+            css += blockGroupStatesCss(nearestRootId, block.id, block.groupStates, surfaceId);
+        }
+        // This block becomes the nearest root for its own descendants when it is a
+        // group root (innermost groupRoot wins).
+        const rootForChildren = block.groupRoot ? block.id : nearestRootId;
+        if (block.children) {
+            for (const child of block.children)
+                walk(child, rootForChildren);
+        }
+    };
+    for (const block of blocks)
+        walk(block, undefined);
+    return css;
+}
+//# sourceMappingURL=group-states-css.js.map

package/dist/render/group-states-css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-states-css.js","sourceRoot":"","sources":["../../src/render/group-states-css.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE1E,4FAA4F;AAC5F,SAAS,UAAU,CAAC,KAAuC;IACzD,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;SACzB,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC;SACnE,IAAI,CAAC,GAAG,CAAC,CAAA;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAc,EACd,MAAc,EACd,WAA8C,EAC9C,SAAkB;IAElB,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAA;IAC/B,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACxD,+EAA+E;IAC/E,6EAA6E;IAC7E,qDAAqD;IACrD,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,UAAU,WAAW,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,CAAA;AACjG,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAwB,EAAE,SAAkB;IAChF,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,MAAM,IAAI,GAAG,CAAC,KAAY,EAAE,aAAiC,EAAQ,EAAE;QACrE,IAAI,KAAK,CAAC,WAAW,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YACrD,GAAG,IAAI,mBAAmB,CAAC,aAAa,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;QACnF,CAAC;QACD,2EAA2E;QAC3E,yCAAyC;QACzC,MAAM,eAAe,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAA;QAClE,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,QAAQ;gBAAE,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,CAAA;QAClE,CAAC;IACH,CAAC,CAAA;IACD,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAA;IAClD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/render/hooks/useSurfaceEvents.d.ts

@@ -0,0 +1,9 @@
+/**
+ * useSurfaceEvents hook
+ *
+ * Re-exports from `@pwfabric/runtime/blocks` (its canonical home).
+ *
+ * @module @pwfabric/runtime/render/hooks/useSurfaceEvents
+ */
+export { useSurfaceEvents } from '../../blocks/index.js';
+//# sourceMappingURL=useSurfaceEvents.d.ts.map

package/dist/render/hooks/useSurfaceEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSurfaceEvents.d.ts","sourceRoot":"","sources":["../../../src/render/hooks/useSurfaceEvents.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/render/hooks/useSurfaceEvents.js

@@ -0,0 +1,9 @@
+/**
+ * useSurfaceEvents hook
+ *
+ * Re-exports from `@pwfabric/runtime/blocks` (its canonical home).
+ *
+ * @module @pwfabric/runtime/render/hooks/useSurfaceEvents
+ */
+export { useSurfaceEvents } from '../../blocks/index.js';
+//# sourceMappingURL=useSurfaceEvents.js.map

package/dist/render/hooks/useSurfaceEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSurfaceEvents.js","sourceRoot":"","sources":["../../../src/render/hooks/useSurfaceEvents.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/render/hooks/useSurfaceId.d.ts

@@ -0,0 +1,9 @@
+/**
+ * useSurfaceId hook
+ *
+ * Re-exports from `@pwfabric/runtime/blocks` (its canonical home).
+ *
+ * @module @pwfabric/runtime/render/hooks/useSurfaceId
+ */
+export { useSurfaceId } from '../../blocks/index.js';
+//# sourceMappingURL=useSurfaceId.d.ts.map

package/dist/render/hooks/useSurfaceId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSurfaceId.d.ts","sourceRoot":"","sources":["../../../src/render/hooks/useSurfaceId.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/render/hooks/useSurfaceId.js

@@ -0,0 +1,9 @@
+/**
+ * useSurfaceId hook
+ *
+ * Re-exports from `@pwfabric/runtime/blocks` (its canonical home).
+ *
+ * @module @pwfabric/runtime/render/hooks/useSurfaceId
+ */
+export { useSurfaceId } from '../../blocks/index.js';
+//# sourceMappingURL=useSurfaceId.js.map

package/dist/render/hooks/useSurfaceId.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSurfaceId.js","sourceRoot":"","sources":["../../../src/render/hooks/useSurfaceId.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/render/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Surface Renderer Module
+ *
+ * Phase 2A.1: Surface-to-React rendering infrastructure
+ *
+ * @module @pwfabric/runtime/render
+ */
+export type { BlockComponentProps, BlockComponent, BlockComponentRegistry, CapabilityProvider, BlockContext, SurfaceEventType, SurfaceEvent, SurfaceRendererProps, BlockRendererProps, RenderResult, RenderableSurface, CapabilityType, ImageAdapter, ImageAdapterProps, BlockWrapperProps, BlockWrapperRenderArgs, BlockInteractionMode, } from './types.js';
+export { SurfaceRenderer, BlockRenderer, getBlockIds, findBlockById, updateBlockById, } from './renderer.js';
+export { surfaceThemeToCSS } from './theme-utils.js';
+export { deriveDarkTheme } from './derive-dark-theme.js';
+export { resolveResponsiveValue, resolveSpanAtBreakpoint, getColumnsAtBreakpoint, getBreakpointForWidth, resolveBlockLayout, resolveMeasureStyle, resolveSurfaceRootStyle, useViewport, } from './responsive.js';
+export { collectVisibilityCss, blockVisibilityCss, resolveHiddenBreakpoints, } from './visibility-css.js';
+export { collectStatesCss, blockStatesCss } from './states-css.js';
+export { collectConditionalStatesCss, blockConditionalStatesCss, } from './conditional-states-css.js';
+export { buildKeyframesCss } from './keyframes-css.js';
+export { collectResponsiveStyleCss, blockResponsiveStyleCss, } from './responsive-style-css.js';
+export { collectGroupStatesCss, blockGroupStatesCss } from './group-states-css.js';
+export { cssEscapeId, camelToKebab, blockIdAttr, blockSelector, collectScopedCss, } from './scoped-css.js';
+export { buildDarkThemeCss } from './dark-theme-css.js';
+export { resolveAppearanceDarkVars, resolveAppearanceKeyframes } from './appearance-resolver.js';
+export type { SurfaceDataSourceKind, SurfaceDataSourceDefinition, SurfaceActionType, SurfaceAction, BlockActionProp, DataBoundSurface, DataBoundSurfaceRendererProps, } from './data-binding-types.js';
+export { DataBoundSurfaceRenderer, surfaceNeedsDataBinding, blockActionsOf } from './DataBoundSurfaceRenderer.js';
+export { resolveEndpoint, encodeEndpointValue } from './endpoint.js';
+export { dataSourceCacheKey } from './data-cache.js';
+export type { SurfaceDataCache } from './data-cache.js';
+export { resolveBlockExpressions, resolveString } from './resolve-expressions.js';
+export { BlockErrorBoundary } from './BlockErrorBoundary.js';
+export type { EntitlementContextValue, EntitlementProviderProps, GatedBlockPlaceholderProps, } from './capability-gate.js';
+export { EntitlementProvider, useEntitlements, GatedBlockPlaceholder } from './capability-gate.js';
+export { BlockModuleLoader } from './dynamic-block-loader.js';
+export type { DynamicBlockWrapperProps } from './DynamicBlockWrapper.js';
+export { DynamicBlockWrapper } from './DynamicBlockWrapper.js';
+export type { DynamicArtifactContextValue, DynamicArtifactProviderProps, } from './dynamic-artifact-context.js';
+export { DynamicArtifactProvider, preloadDynamicBlocks, useDynamicBlocks, useDynamicStarters, } from './dynamic-artifact-context.js';
+export { createSurfaceEventBus } from './surface-event-bus.js';
+export { SurfaceEventContext } from './surface-event-context.js';
+export { useSurfaceEvents } from './hooks/useSurfaceEvents.js';
+export type { BehaviorSurfaceProviderProps } from './BehaviorSurfaceProvider.js';
+export { BehaviorSurfaceProvider } from './BehaviorSurfaceProvider.js';
+export { SurfaceIdContext } from './surface-id-context.js';
+export { useSurfaceId } from './hooks/useSurfaceId.js';
+export { EntityFacadeContext, useEntityFacade } from './entity-facade-context.js';
+export { SurfaceDataContext, useSurfaceData } from './surface-data-context.js';
+export type { SurfaceData } from './surface-data-context.js';
+export { SurfaceConnectionsContext, useSurfaceConnections } from './connections-context.js';
+export type { ShellSelectionStore, ShellSelectionOptions, ShellSelectionProviderProps } from './shell-selection.js';
+export { ShellSelectionContext, ShellSelectionProvider, createShellSelectionStore, useShellSelection, } from './shell-selection.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/render/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"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"}

package/dist/render/index.js

@@ -0,0 +1,61 @@
+/**
+ * Surface Renderer Module
+ *
+ * Phase 2A.1: Surface-to-React rendering infrastructure
+ *
+ * @module @pwfabric/runtime/render
+ */
+// Components
+export { SurfaceRenderer, BlockRenderer, getBlockIds, findBlockById, updateBlockById, } from './renderer.js';
+// legacy first-party `*Block` component re-exports +
+// `defaultBlockComponents` retired. Components flow through the install
+// pipeline (pwpack publish → CDN bundle → BlockModuleLoader); the static
+// re-exports that lived here are gone.
+// Theme utilities
+export { surfaceThemeToCSS } from './theme-utils.js';
+export { deriveDarkTheme } from './derive-dark-theme.js';
+// Responsive utilities
+export { resolveResponsiveValue, resolveSpanAtBreakpoint, getColumnsAtBreakpoint, getBreakpointForWidth, resolveBlockLayout, resolveMeasureStyle, resolveSurfaceRootStyle, useViewport, } from './responsive.js';
+// Per-breakpoint visibility (hideOn/showOn) CSS generation
+export { collectVisibilityCss, blockVisibilityCss, resolveHiddenBreakpoints, } from './visibility-css.js';
+// Interaction-state (hover/active/focus) CSS generation
+export { collectStatesCss, blockStatesCss } from './states-css.js';
+// Conditional-state (aria/data/disabled/checked/:has) CSS generation
+export { collectConditionalStatesCss, blockConditionalStatesCss, } from './conditional-states-css.js';
+// Surface keyframe registry (appearance.config.keyframes) CSS generation
+export { buildKeyframesCss } from './keyframes-css.js';
+// Per-prop responsive style (block.style breakpoint maps) CSS generation
+export { collectResponsiveStyleCss, blockResponsiveStyleCss, } from './responsive-style-css.js';
+// Group-hover (block.groupRoot + descendant block.groupStates) CSS generation
+export { collectGroupStatesCss, blockGroupStatesCss } from './group-states-css.js';
+// Shared scoped-CSS helpers (used by the per-block collectors above)
+export { cssEscapeId, camelToKebab, blockIdAttr, blockSelector, collectScopedCss, } from './scoped-css.js';
+// Dark theme variant CSS generation + resolver
+export { buildDarkThemeCss } from './dark-theme-css.js';
+export { resolveAppearanceDarkVars, resolveAppearanceKeyframes } from './appearance-resolver.js';
+export { DataBoundSurfaceRenderer, surfaceNeedsDataBinding, blockActionsOf } from './DataBoundSurfaceRenderer.js';
+export { resolveEndpoint, encodeEndpointValue } from './endpoint.js';
+export { dataSourceCacheKey } from './data-cache.js';
+export { resolveBlockExpressions, resolveString } from './resolve-expressions.js';
+// Block Error Boundary (crash isolation)
+export { BlockErrorBoundary } from './BlockErrorBoundary.js';
+export { EntitlementProvider, useEntitlements, GatedBlockPlaceholder } from './capability-gate.js';
+// Dynamic Artifact Loading
+export { BlockModuleLoader } from './dynamic-block-loader.js';
+export { DynamicBlockWrapper } from './DynamicBlockWrapper.js';
+export { DynamicArtifactProvider, preloadDynamicBlocks, useDynamicBlocks, useDynamicStarters, } from './dynamic-artifact-context.js';
+// Surface event protocol
+export { createSurfaceEventBus } from './surface-event-bus.js';
+export { SurfaceEventContext } from './surface-event-context.js';
+export { useSurfaceEvents } from './hooks/useSurfaceEvents.js';
+export { BehaviorSurfaceProvider } from './BehaviorSurfaceProvider.js';
+export { SurfaceIdContext } from './surface-id-context.js';
+export { useSurfaceId } from './hooks/useSurfaceId.js';
+// EntityFacade → Surface Renderer integration
+export { EntityFacadeContext, useEntityFacade } from './entity-facade-context.js';
+// What the data-bound path has currently bound, by source id (form writer reads it)
+export { SurfaceDataContext, useSurfaceData } from './surface-data-context.js';
+// Connections context (world connections + engine registry)
+export { SurfaceConnectionsContext, useSurfaceConnections } from './connections-context.js';
+export { ShellSelectionContext, ShellSelectionProvider, createShellSelectionStore, useShellSelection, } from './shell-selection.js';
+//# sourceMappingURL=index.js.map

package/dist/render/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"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"}

package/dist/render/interaction-rule-engine.d.ts

@@ -0,0 +1,13 @@
+import type { InteractionRule, InteractionRuleEngine, SurfaceEventTrigger, SurfaceEventDescriptor } from '@pwfabric/contracts';
+export type { InteractionRule, InteractionRuleEngine, SurfaceEventTrigger };
+export declare class DefaultInteractionRuleEngine implements InteractionRuleEngine {
+    private readonly rules;
+    register(rule: InteractionRule): void;
+    unregister(ruleId: string): boolean;
+    attach(bus: {
+        on(pattern: string, handler: (e: SurfaceEventDescriptor) => void): () => void;
+    }): () => void;
+    clear(): void;
+}
+export declare function createInteractionRuleEngine(): InteractionRuleEngine;
+//# sourceMappingURL=interaction-rule-engine.d.ts.map

package/dist/render/interaction-rule-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-rule-engine.d.ts","sourceRoot":"","sources":["../../src/render/interaction-rule-engine.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,qBAAqB,CAAA;AAE5B,YAAY,EAAE,eAAe,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,CAAA;AAE3E,qBAAa,4BAA6B,YAAW,qBAAqB;IACxE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAE3D,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAIrC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAInC,MAAM,CAAC,GAAG,EAAE;QACV,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,sBAAsB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;KAC9E,GAAG,MAAM,IAAI;IA+Bd,KAAK,IAAI,IAAI;CAGd;AAED,wBAAgB,2BAA2B,IAAI,qBAAqB,CAEnE"}

package/dist/render/interaction-rule-engine.js

@@ -0,0 +1,47 @@
+// packages/runtime/src/render/interaction-rule-engine.ts
+// DefaultInteractionRuleEngine (formerly DefaultSurfaceBehaviorEngine)
+export class DefaultInteractionRuleEngine {
+    rules = new Map();
+    register(rule) {
+        this.rules.set(rule.id, rule);
+    }
+    unregister(ruleId) {
+        return this.rules.delete(ruleId);
+    }
+    attach(bus) {
+        const unsubscribers = [];
+        // Group rules by trigger, subscribe once per trigger
+        const byTrigger = new Map();
+        for (const rule of this.rules.values()) {
+            const existing = byTrigger.get(rule.trigger) ?? [];
+            existing.push(rule);
+            byTrigger.set(rule.trigger, existing);
+        }
+        for (const [trigger, triggerRules] of byTrigger) {
+            const unsub = bus.on(trigger, async (event) => {
+                // Sort by priority (higher = first)
+                const sorted = [...triggerRules].sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+                for (const rule of sorted) {
+                    try {
+                        if (rule.guard && !rule.guard(event))
+                            continue;
+                        await rule.action(event);
+                    }
+                    catch (err) {
+                        // Fail-safe: log but don't break other rules
+                        console.warn(`[InteractionRuleEngine] Rule '${rule.id}' failed:`, err);
+                    }
+                }
+            });
+            unsubscribers.push(unsub);
+        }
+        return () => unsubscribers.forEach((u) => u());
+    }
+    clear() {
+        this.rules.clear();
+    }
+}
+export function createInteractionRuleEngine() {
+    return new DefaultInteractionRuleEngine();
+}
+//# sourceMappingURL=interaction-rule-engine.js.map

package/dist/render/interaction-rule-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-rule-engine.js","sourceRoot":"","sources":["../../src/render/interaction-rule-engine.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,uEAAuE;AAWvE,MAAM,OAAO,4BAA4B;IACtB,KAAK,GAAG,IAAI,GAAG,EAA2B,CAAA;IAE3D,QAAQ,CAAC,IAAqB;QAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED,UAAU,CAAC,MAAc;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAClC,CAAC;IAED,MAAM,CAAC,GAEN;QACC,MAAM,aAAa,GAAmB,EAAE,CAAA;QAExC,qDAAqD;QACrD,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAA;QACtD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAA;YAClD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACnB,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;QACvC,CAAC;QAED,KAAK,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,IAAI,SAAS,EAAE,CAAC;YAChD,MAAM,KAAK,GAAG,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,KAA6B,EAAE,EAAE;gBACpE,oCAAoC;gBACpC,MAAM,MAAM,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAA;gBACtF,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;oBAC1B,IAAI,CAAC;wBACH,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;4BAAE,SAAQ;wBAC9C,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;oBAC1B,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,6CAA6C;wBAC7C,OAAO,CAAC,IAAI,CAAC,iCAAiC,IAAI,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,CAAA;oBACxE,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAA;YACF,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC3B,CAAC;QAED,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAA;IAChD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACpB,CAAC;CACF;AAED,MAAM,UAAU,2BAA2B;IACzC,OAAO,IAAI,4BAA4B,EAAE,CAAA;AAC3C,CAAC"}

package/dist/render/keyframes-css.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Surface keyframe registry CSS generation (arbitrary `@keyframes`).
+ *
+ * The runtime ships a fixed set of `pw-*` keyframes in `SURFACE_BASE_CSS`
+ * (pulse / fade-in / marquee / slide-up / slide-down / scale-in / spin /
+ * bounce / spring-in), so `block.style.animation` could only reference those. A surface can
+ * now declare arbitrary named keyframes via `appearance.config.keyframes`
+ * (name → keyframe body); this module emits one `@keyframes <name>{<body>}` per
+ * entry so a block can drive custom motion offline.
+ *
+ * Each name is PREFIXED with `pw-kf-` to avoid colliding with host-page or
+ * runtime-shipped keyframes — so a surface declaring `{ wiggle: '…' }` makes the
+ * animation available as `pw-kf-wiggle`, and a block references it via
+ * `block.style.animation: 'pw-kf-wiggle 0.4s ease'`.
+ *
+ * The keyframe BODY passes through untouched (authors supply standard
+ * `@keyframes` selector blocks, e.g. `0%{…}50%{…}100%{…}`). An empty/absent
+ * registry emits zero bytes. The existing `prefers-reduced-motion` gate in
+ * `SURFACE_BASE_CSS` neutralises these animations for users who opt out (it
+ * matches by animation, not by keyframe name), so no extra gating is needed
+ * here.
+ *
+ * @module @pwfabric/runtime/render/keyframes-css
+ */
+/**
+ * Build the surface keyframe CSS from the appearance `keyframes` registry
+ * (name → keyframe body). Emits `@keyframes pw-kf-<name>{<body>}` for each
+ * entry. Entries with an empty name or empty body are skipped. Returns '' when
+ * the registry is empty/undefined (zero bytes emitted).
+ */
+export declare function buildKeyframesCss(keyframes: Readonly<Record<string, string>> | undefined): string;
+//# sourceMappingURL=keyframes-css.d.ts.map

package/dist/render/keyframes-css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyframes-css.d.ts","sourceRoot":"","sources":["../../src/render/keyframes-css.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GACtD,MAAM,CAQR"}

package/dist/render/keyframes-css.js

@@ -0,0 +1,44 @@
+/**
+ * Surface keyframe registry CSS generation (arbitrary `@keyframes`).
+ *
+ * The runtime ships a fixed set of `pw-*` keyframes in `SURFACE_BASE_CSS`
+ * (pulse / fade-in / marquee / slide-up / slide-down / scale-in / spin /
+ * bounce / spring-in), so `block.style.animation` could only reference those. A surface can
+ * now declare arbitrary named keyframes via `appearance.config.keyframes`
+ * (name → keyframe body); this module emits one `@keyframes <name>{<body>}` per
+ * entry so a block can drive custom motion offline.
+ *
+ * Each name is PREFIXED with `pw-kf-` to avoid colliding with host-page or
+ * runtime-shipped keyframes — so a surface declaring `{ wiggle: '…' }` makes the
+ * animation available as `pw-kf-wiggle`, and a block references it via
+ * `block.style.animation: 'pw-kf-wiggle 0.4s ease'`.
+ *
+ * The keyframe BODY passes through untouched (authors supply standard
+ * `@keyframes` selector blocks, e.g. `0%{…}50%{…}100%{…}`). An empty/absent
+ * registry emits zero bytes. The existing `prefers-reduced-motion` gate in
+ * `SURFACE_BASE_CSS` neutralises these animations for users who opt out (it
+ * matches by animation, not by keyframe name), so no extra gating is needed
+ * here.
+ *
+ * @module @pwfabric/runtime/render/keyframes-css
+ */
+/** Prefix applied to every surface-declared keyframe name (collision guard). */
+const KEYFRAME_PREFIX = 'pw-kf-';
+/**
+ * Build the surface keyframe CSS from the appearance `keyframes` registry
+ * (name → keyframe body). Emits `@keyframes pw-kf-<name>{<body>}` for each
+ * entry. Entries with an empty name or empty body are skipped. Returns '' when
+ * the registry is empty/undefined (zero bytes emitted).
+ */
+export function buildKeyframesCss(keyframes) {
+    if (!keyframes)
+        return '';
+    let css = '';
+    for (const [name, body] of Object.entries(keyframes)) {
+        if (!name || typeof body !== 'string' || body.trim().length === 0)
+            continue;
+        css += `@keyframes ${KEYFRAME_PREFIX}${name}{${body}}`;
+    }
+    return css;
+}
+//# sourceMappingURL=keyframes-css.js.map

package/dist/render/keyframes-css.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyframes-css.js","sourceRoot":"","sources":["../../src/render/keyframes-css.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,gFAAgF;AAChF,MAAM,eAAe,GAAG,QAAQ,CAAA;AAEhC;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAuD;IAEvD,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAA;IACzB,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;YAAE,SAAQ;QAC3E,GAAG,IAAI,cAAc,eAAe,GAAG,IAAI,IAAI,IAAI,GAAG,CAAA;IACxD,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/render/query-state.d.ts

@@ -0,0 +1,4 @@
+export declare function resolveQueryState<T>(query: T, state: Readonly<Record<string, unknown>>): T;
+/** True when any string inside the query carries an expression. */
+export declare function queryHasState(query: unknown): boolean;
+//# sourceMappingURL=query-state.d.ts.map

package/dist/render/query-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-state.d.ts","sourceRoot":"","sources":["../../src/render/query-state.ts"],"names":[],"mappings":"AAoBA,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAmC1F;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKrD"}

package/dist/render/query-state.js

@@ -0,0 +1,70 @@
+/**
+ * resolveQueryState — substitute `{{state.x}}` (and any expression) inside a
+ * data-source `query` object before it reaches the connector.
+ *
+ * Without it state would be interpolated ONLY in REST `endpoint` strings and
+ * connector/entity sources would pass `source.query` to the engine raw, so a
+ * pagination block writing `state.page` and a segmented-control writing
+ * `state.severity` could never reach `query.pagination.offset` or
+ * `query.filter.value`. This walks the query deeply and resolves every string
+ * that contains `{{ }}`.
+ *
+ * A string that is EXACTLY one expression (`"{{state.page}}"`) resolves to
+ * the raw value (number stays number, array stays array) so
+ * `pagination.limit: "{{state.pageSize}}"` yields a number, not "20".
+ * Mixed strings (`"prefix-{{state.x}}"`) resolve to a string.
+ */
+import { createExpressionContext, evaluate, interpolate } from '../surface/expression.js';
+const WHOLE = /^\s*\{\{\s*([^{}]+?)\s*\}\}\s*$/;
+export function resolveQueryState(query, state) {
+    const ctx = createExpressionContext({ state });
+    const walk = (v) => {
+        if (typeof v === 'string') {
+            if (!v.includes('{{'))
+                return v;
+            const whole = WHOLE.exec(v);
+            if (whole && whole[1] !== undefined) {
+                const r = evaluate(whole[1], ctx);
+                if (!r.success)
+                    return undefined;
+                // An "All" segment and an empty search box both write '' (or null) into
+                // state. Read literally that is `field eq ''`, which matches no row —
+                // the control that was meant to WIDEN the list emptied it. A whole
+                // expression resolving to nothing is no constraint, so the key drops.
+                // A literal '' written into the query by an author is untouched: only
+                // an expression can resolve away.
+                if (r.value === '' || r.value === null)
+                    return undefined;
+                return r.value;
+            }
+            const r = interpolate(v, ctx);
+            return r.success ? r.value : v;
+        }
+        if (Array.isArray(v))
+            return v.map(walk);
+        if (v && typeof v === 'object') {
+            const out = {};
+            for (const [k, val] of Object.entries(v)) {
+                const w = walk(val);
+                // an unresolved whole-expression drops the key so the connector sees
+                // "no constraint", not `undefined` as a literal filter value
+                if (w !== undefined)
+                    out[k] = w;
+            }
+            return out;
+        }
+        return v;
+    };
+    return walk(query);
+}
+/** True when any string inside the query carries an expression. */
+export function queryHasState(query) {
+    if (typeof query === 'string')
+        return query.includes('{{');
+    if (Array.isArray(query))
+        return query.some(queryHasState);
+    if (query && typeof query === 'object')
+        return Object.values(query).some(queryHasState);
+    return false;
+}
+//# sourceMappingURL=query-state.js.map

package/dist/render/query-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-state.js","sourceRoot":"","sources":["../../src/render/query-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAEzF,MAAM,KAAK,GAAG,iCAAiC,CAAA;AAE/C,MAAM,UAAU,iBAAiB,CAAI,KAAQ,EAAE,KAAwC;IACrF,MAAM,GAAG,GAAG,uBAAuB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;IAC9C,MAAM,IAAI,GAAG,CAAC,CAAU,EAAW,EAAE;QACnC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC1B,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,CAAA;YAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAC3B,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;gBACpC,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;gBACjC,IAAI,CAAC,CAAC,CAAC,OAAO;oBAAE,OAAO,SAAS,CAAA;gBAChC,wEAAwE;gBACxE,sEAAsE;gBACtE,mEAAmE;gBACnE,sEAAsE;gBACtE,sEAAsE;gBACtE,kCAAkC;gBAClC,IAAI,CAAC,CAAC,KAAK,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI;oBAAE,OAAO,SAAS,CAAA;gBACxD,OAAO,CAAC,CAAC,KAAK,CAAA;YAChB,CAAC;YACD,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;YAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAChC,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACxC,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,GAAG,GAA4B,EAAE,CAAA;YACvC,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAA4B,CAAC,EAAE,CAAC;gBACpE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAA;gBACnB,qEAAqE;gBACrE,6DAA6D;gBAC7D,IAAI,CAAC,KAAK,SAAS;oBAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;YACjC,CAAC;YACD,OAAO,GAAG,CAAA;QACZ,CAAC;QACD,OAAO,CAAC,CAAA;IACV,CAAC,CAAA;IACD,OAAO,IAAI,CAAC,KAAK,CAAM,CAAA;AACzB,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;IAC1D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IAC1D,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,KAAgC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IAClH,OAAO,KAAK,CAAA;AACd,CAAC"}