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

package/dist/blocks/__test-fixtures__/block-fixtures.js

@@ -0,0 +1,506 @@
+/**
+ * Block Fixtures
+ *
+ * Canonical test fixture for registry-dependent suites — supplies the
+ * `BlockRegistry` / `CompositionRuleEngine` / composer-prompt /
+ * introspection tests with a populated set of `BlockDefinition` stubs.
+ * Production code MUST NOT import from this module; production block
+ * metadata flows through the install pipeline (`useInstalledAtoms`
+ * browser-side, `installedBlocksOverride` server-side).
+ *
+ * The 45 stubs carry only the metadata the rule engine and composition
+ * validators consult: `type`, `name`, `category`, `schema`,
+ * `defaultProps`, `canHaveChildren`, optional `allowedChildren`/
+ * `allowedParents`. Component implementations live exclusively in
+ * `pwpack-source/<pack>/blocks/<cat>/<name>/component.tsx` and are
+ * loaded at runtime via `BlockModuleLoader` from the published CDN
+ * bundle. The stub `type` set + enum values mirror the historic
+ * first-party catalog because composer-prompt + introspection tests
+ * verify parity against that catalog.
+ *
+ * Usage in tests:
+ *   import { populateTestBlocks } from
+ *     '@pwfabric/runtime/blocks/__test-fixtures__/block-fixtures'
+ *   populateTestBlocks()
+ *
+ * @module @pwfabric/runtime/blocks/__test-fixtures__/block-fixtures
+ */
+import { z } from 'zod';
+import { blockRegistry } from '../registry.js';
+function makeDefinition(input) {
+    const schema = z.object(input.shape ?? {}).passthrough();
+    return {
+        type: input.type,
+        name: input.name,
+        category: input.category,
+        icon: 'block',
+        schema,
+        defaultProps: input.defaultProps ?? {},
+        canHaveChildren: input.canHaveChildren ?? false,
+        ...(input.allowedChildren !== undefined ? { allowedChildren: input.allowedChildren } : {}),
+        ...(input.allowedParents !== undefined ? { allowedParents: input.allowedParents } : {}),
+    };
+}
+// Common prop shapes used across stubs. Keys match the runtime block
+// authoring contracts so tests that read `schema.shape` for prop names
+// still see the expected keys.
+const stringProp = z.string().optional();
+const numberProp = z.number().optional();
+const booleanProp = z.boolean().optional();
+const anyArrayProp = z.array(z.unknown()).optional();
+const styleProp = z.record(z.unknown()).optional();
+// Helper for blocks whose schema would otherwise be empty — keeps tests
+// that walk `Object.keys(schema.shape)` from observing zero props.
+const baseShape = {
+    className: stringProp,
+    style: styleProp,
+};
+// ============================================================
+// 45 LEGACY BLOCK DEFINITION STUBS
+// ============================================================
+//
+// Order mirrors the historic publish order so any snapshot tests
+// observing definition iteration sequence stay stable.
+// ============================================================
+export const TEST_BLOCK_DEFINITIONS = [
+    // -------- LAYOUT --------
+    makeDefinition({
+        type: 'container',
+        name: 'Container',
+        category: 'layout',
+        canHaveChildren: true,
+        shape: {
+            ...baseShape,
+            direction: stringProp,
+            gap: numberProp,
+            padding: numberProp,
+        },
+    }),
+    makeDefinition({
+        type: 'grid',
+        name: 'Grid',
+        category: 'layout',
+        canHaveChildren: true,
+        // Historic grid restriction: only structural / content blocks are
+        // allowed as direct children. The legacy `gridDefinition` carried an
+        // explicit allowed-children list which the rule engine consults
+        // before falling back to the cross-block "no nested grids" policy.
+        allowedChildren: [
+            'container',
+            'card',
+            'section',
+            'image',
+            'video',
+            'text',
+            'heading',
+            'button',
+            'badge',
+            'icon',
+            'divider',
+            'list',
+            'table',
+            'stat',
+        ],
+        shape: {
+            ...baseShape,
+            columns: numberProp,
+            gap: numberProp,
+        },
+    }),
+    makeDefinition({
+        type: 'navbar',
+        name: 'Navbar',
+        category: 'layout',
+        canHaveChildren: true,
+        shape: { ...baseShape, items: anyArrayProp },
+    }),
+    makeDefinition({
+        type: 'section',
+        name: 'Section',
+        category: 'layout',
+        canHaveChildren: true,
+        shape: { ...baseShape, title: stringProp },
+    }),
+    // -------- PANEL --------
+    makeDefinition({
+        type: 'accordion',
+        name: 'Accordion',
+        category: 'panel',
+        canHaveChildren: false,
+        shape: { ...baseShape, items: anyArrayProp },
+    }),
+    makeDefinition({
+        type: 'card',
+        name: 'Card',
+        category: 'panel',
+        canHaveChildren: true,
+        shape: { ...baseShape, title: stringProp },
+    }),
+    makeDefinition({
+        type: 'drawer',
+        name: 'Drawer',
+        category: 'panel',
+        canHaveChildren: true,
+        shape: { ...baseShape, open: booleanProp, side: stringProp },
+    }),
+    makeDefinition({
+        type: 'modal',
+        name: 'Modal',
+        category: 'panel',
+        canHaveChildren: true,
+        allowedChildren: [
+            'container',
+            'grid',
+            'text',
+            'heading',
+            'button',
+            'image',
+            'form',
+            'input',
+            'list',
+            'table',
+            'divider',
+            'icon',
+            'badge',
+        ],
+        shape: { ...baseShape, open: booleanProp, title: stringProp },
+    }),
+    makeDefinition({
+        type: 'stepper',
+        name: 'Stepper',
+        category: 'panel',
+        canHaveChildren: false,
+        shape: { ...baseShape, steps: anyArrayProp, current: numberProp },
+    }),
+    makeDefinition({
+        type: 'tabs',
+        name: 'Tabs',
+        category: 'panel',
+        canHaveChildren: true,
+        allowedChildren: ['container'],
+        shape: { ...baseShape, tabs: anyArrayProp, defaultTab: stringProp },
+    }),
+    makeDefinition({
+        type: 'tooltip',
+        name: 'Tooltip',
+        category: 'panel',
+        canHaveChildren: true,
+        allowedChildren: ['text', 'button', 'icon', 'badge', 'link'],
+        shape: { ...baseShape, content: stringProp },
+    }),
+    // -------- TEXT --------
+    makeDefinition({
+        type: 'alert',
+        name: 'Alert',
+        category: 'text',
+        canHaveChildren: false,
+        shape: { ...baseShape, message: stringProp, severity: stringProp },
+    }),
+    makeDefinition({
+        type: 'callout',
+        name: 'Callout',
+        category: 'text',
+        canHaveChildren: false,
+        shape: { ...baseShape, title: stringProp, body: stringProp },
+    }),
+    makeDefinition({
+        type: 'code',
+        name: 'Code',
+        category: 'text',
+        canHaveChildren: false,
+        shape: { ...baseShape, code: stringProp, language: stringProp },
+    }),
+    makeDefinition({
+        type: 'heading',
+        name: 'Heading',
+        category: 'text',
+        canHaveChildren: false,
+        shape: { ...baseShape, text: stringProp, level: numberProp },
+    }),
+    makeDefinition({
+        type: 'text',
+        name: 'Text',
+        category: 'text',
+        canHaveChildren: false,
+        shape: { ...baseShape, content: stringProp },
+    }),
+    // -------- DATA --------
+    makeDefinition({
+        type: 'list',
+        name: 'List',
+        category: 'data',
+        canHaveChildren: false,
+        shape: { ...baseShape, items: anyArrayProp, style: stringProp },
+    }),
+    makeDefinition({
+        type: 'progress',
+        name: 'Progress',
+        category: 'data',
+        canHaveChildren: false,
+        shape: { ...baseShape, value: numberProp, max: numberProp },
+    }),
+    makeDefinition({
+        type: 'rating',
+        name: 'Rating',
+        category: 'data',
+        canHaveChildren: false,
+        shape: { ...baseShape, value: numberProp, max: numberProp },
+    }),
+    makeDefinition({
+        type: 'skeleton',
+        name: 'Skeleton',
+        category: 'data',
+        canHaveChildren: false,
+        shape: { ...baseShape, lines: numberProp },
+    }),
+    makeDefinition({
+        type: 'stat',
+        name: 'Stat',
+        category: 'data',
+        canHaveChildren: false,
+        shape: { ...baseShape, label: stringProp, value: stringProp },
+    }),
+    makeDefinition({
+        type: 'table',
+        name: 'Table',
+        category: 'data',
+        canHaveChildren: false,
+        shape: {
+            ...baseShape,
+            columns: anyArrayProp,
+            data: anyArrayProp,
+        },
+    }),
+    makeDefinition({
+        type: 'timeline',
+        name: 'Timeline',
+        category: 'data',
+        canHaveChildren: false,
+        shape: { ...baseShape, items: anyArrayProp },
+    }),
+    // -------- CONTROL --------
+    makeDefinition({
+        type: 'avatar',
+        name: 'Avatar',
+        category: 'control',
+        canHaveChildren: false,
+        shape: {
+            ...baseShape,
+            src: stringProp,
+            alt: stringProp,
+            shape: z.enum(['circle', 'rounded', 'square']).optional(),
+        },
+    }),
+    makeDefinition({
+        type: 'badge',
+        name: 'Badge',
+        category: 'control',
+        canHaveChildren: false,
+        shape: {
+            ...baseShape,
+            text: stringProp,
+            variant: z
+                .enum(['primary', 'secondary', 'success', 'warning', 'destructive', 'error', 'info'])
+                .optional(),
+        },
+    }),
+    makeDefinition({
+        type: 'breadcrumb',
+        name: 'Breadcrumb',
+        category: 'control',
+        canHaveChildren: false,
+        shape: { ...baseShape, items: anyArrayProp },
+    }),
+    makeDefinition({
+        type: 'button',
+        name: 'Button',
+        category: 'control',
+        canHaveChildren: false,
+        shape: {
+            ...baseShape,
+            label: stringProp,
+            variant: z.enum(['primary', 'secondary', 'outline', 'ghost', 'destructive']).optional(),
+            size: z.enum(['small', 'medium', 'large']).optional(),
+            href: stringProp,
+            disabled: booleanProp,
+        },
+    }),
+    makeDefinition({
+        type: 'divider',
+        name: 'Divider',
+        category: 'control',
+        canHaveChildren: false,
+        shape: { ...baseShape, orientation: stringProp },
+    }),
+    makeDefinition({
+        type: 'dropdown',
+        name: 'Dropdown',
+        category: 'control',
+        canHaveChildren: false,
+        shape: { ...baseShape, items: anyArrayProp, label: stringProp },
+    }),
+    makeDefinition({
+        type: 'icon',
+        name: 'Icon',
+        category: 'control',
+        canHaveChildren: false,
+        shape: { ...baseShape, name: stringProp, size: numberProp },
+    }),
+    makeDefinition({
+        type: 'link',
+        name: 'Link',
+        category: 'control',
+        canHaveChildren: false,
+        shape: { ...baseShape, href: stringProp, label: stringProp },
+    }),
+    makeDefinition({
+        type: 'pagination',
+        name: 'Pagination',
+        category: 'control',
+        canHaveChildren: false,
+        shape: { ...baseShape, page: numberProp, pages: numberProp },
+    }),
+    // -------- MEDIA --------
+    makeDefinition({
+        type: 'carousel',
+        name: 'Carousel',
+        category: 'media',
+        canHaveChildren: false,
+        shape: { ...baseShape, items: anyArrayProp },
+    }),
+    makeDefinition({
+        type: 'embed',
+        name: 'Embed',
+        category: 'media',
+        canHaveChildren: false,
+        shape: { ...baseShape, src: stringProp },
+    }),
+    makeDefinition({
+        type: 'image',
+        name: 'Image',
+        category: 'media',
+        canHaveChildren: false,
+        shape: { ...baseShape, src: stringProp, alt: stringProp },
+    }),
+    makeDefinition({
+        type: 'video',
+        name: 'Video',
+        category: 'media',
+        canHaveChildren: false,
+        shape: { ...baseShape, src: stringProp, autoplay: booleanProp },
+    }),
+    // -------- FORM --------
+    makeDefinition({
+        type: 'checkbox',
+        name: 'Checkbox',
+        category: 'form',
+        canHaveChildren: false,
+        shape: { ...baseShape, name: stringProp, label: stringProp, checked: booleanProp },
+    }),
+    makeDefinition({
+        type: 'date-input',
+        name: 'Date Input',
+        category: 'form',
+        canHaveChildren: false,
+        shape: { ...baseShape, name: stringProp, value: stringProp },
+    }),
+    makeDefinition({
+        type: 'form',
+        name: 'Form',
+        category: 'form',
+        canHaveChildren: true,
+        allowedChildren: [
+            'input',
+            'textarea',
+            'select',
+            'checkbox',
+            'radio',
+            'switch',
+            'slider',
+            'file-upload',
+            'button',
+            'text',
+            'heading',
+            'container',
+            'divider',
+        ],
+        shape: { ...baseShape, action: stringProp, method: stringProp },
+    }),
+    makeDefinition({
+        type: 'input',
+        name: 'Input',
+        category: 'form',
+        canHaveChildren: false,
+        allowedParents: ['form', 'container'],
+        shape: {
+            ...baseShape,
+            name: stringProp,
+            type: z
+                .enum([
+                'text',
+                'email',
+                'password',
+                'number',
+                'tel',
+                'url',
+                'date',
+                'time',
+                'datetime-local',
+                'search',
+            ])
+                .optional(),
+            label: stringProp,
+            placeholder: stringProp,
+        },
+    }),
+    makeDefinition({
+        type: 'radio',
+        name: 'Radio',
+        category: 'form',
+        canHaveChildren: false,
+        shape: { ...baseShape, name: stringProp, value: stringProp, label: stringProp },
+    }),
+    makeDefinition({
+        type: 'select',
+        name: 'Select',
+        category: 'form',
+        canHaveChildren: false,
+        shape: { ...baseShape, name: stringProp, options: anyArrayProp },
+    }),
+    makeDefinition({
+        type: 'tag-input',
+        name: 'Tag Input',
+        category: 'form',
+        canHaveChildren: false,
+        shape: { ...baseShape, name: stringProp, tags: anyArrayProp },
+    }),
+    makeDefinition({
+        type: 'textarea',
+        name: 'Textarea',
+        category: 'form',
+        canHaveChildren: false,
+        shape: { ...baseShape, name: stringProp, rows: numberProp, label: stringProp },
+    }),
+    makeDefinition({
+        type: 'toggle',
+        name: 'Toggle',
+        category: 'form',
+        canHaveChildren: false,
+        shape: { ...baseShape, name: stringProp, checked: booleanProp, label: stringProp },
+    }),
+];
+/**
+ * Register the 45 block definition stubs on the supplied registry
+ * (or the runtime singleton when omitted). Idempotent — skips
+ * definitions whose `type` is already registered.
+ *
+ * Tests that exercise registry-dependent behaviour call this once at
+ * module-load. Production code must use the install pipeline instead.
+ */
+export function populateTestBlocks(target = blockRegistry) {
+    for (const def of TEST_BLOCK_DEFINITIONS) {
+        if (!target.has(def.type))
+            target.register(def);
+    }
+}
+//# sourceMappingURL=block-fixtures.js.map

package/dist/blocks/__test-fixtures__/block-fixtures.js.map

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

package/dist/blocks/component-types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Block Component Types
+ *
+ * Minimal type definitions for block React components.
+ * These types are structurally compatible with @pwfabric/runtime's
+ * BlockComponent and BlockComponentRegistry types.
+ *
+ * @module @pwfabric/runtime/blocks/component-types
+ */
+import type { ReactNode } from 'react';
+import type { Block } from '@pwfabric/contracts';
+import type { BreakpointName } from '@pwfabric/core';
+/**
+ * Surface event types emitted by block components
+ */
+export type BlockSurfaceEventType = 'click' | 'submit' | 'change' | 'navigate' | 'custom';
+/**
+ * Surface event emitted by block components
+ */
+export interface BlockSurfaceEvent {
+    /** Event type */
+    readonly type: BlockSurfaceEventType;
+    /** Block ID that triggered the event */
+    readonly blockId: string;
+    /** Event payload */
+    readonly payload?: unknown;
+    /** Original DOM event (if applicable) */
+    readonly originalEvent?: Event;
+}
+/**
+ * Minimal block rendering context available to block components.
+ * Structurally compatible with @pwfabric/runtime's BlockContext.
+ */
+export interface BlockComponentContext {
+    /** Event handler for block events */
+    readonly onEvent?: ((event: BlockSurfaceEvent) => void) | undefined;
+    /** Current viewport breakpoint */
+    readonly viewport?: BreakpointName;
+    /** Image adapter (optional, runtime-provided) */
+    readonly imageAdapter?: unknown;
+    /** Capabilities (optional, runtime-provided) */
+    readonly capabilities?: Map<string, unknown>;
+}
+/**
+ * Props passed to block components
+ */
+export interface BlockComponentProps<T = Record<string, unknown>> {
+    /** Block instance */
+    readonly block: Block;
+    /** Resolved props (validated and defaulted) */
+    readonly props: T;
+    /** Rendered children (for container blocks) */
+    readonly children?: ReactNode;
+    /** Block context */
+    readonly context: BlockComponentContext;
+}
+/**
+ * Block component type
+ */
+export type BlockComponent<T = Record<string, unknown>> = ((props: BlockComponentProps<T>) => ReactNode) & {
+    /**
+     * How the block wants to be sized when it sits in a flex ROW.
+     *
+     * The engine's default for a row child is an equal share (`flex: 1 1 0`) —
+     * right for two content columns, wrong for an avatar, a badge, a button: an
+     * intrinsic thing stretched to half a row is the single most measured layout
+     * defect of the 2026-09 surface audit (127 hand-written `flex: 0 0 auto`
+     * overrides across 14 receipts). A block whose natural width is its content
+     * declares `sizing: 'intrinsic'` — as a static on the component, the same
+     * way `displayName` travels — and the engine gives it `flex: 0 0 auto`.
+     * An authored flex hint on the instance still wins. The engine memorises no
+     * block names: the block declares, the engine obeys.
+     */
+    sizing?: BlockSizing;
+};
+/** The only sizing word the engine knows besides its default (fluid share). */
+export type BlockSizing = 'intrinsic';
+/**
+ * Block component registry — maps block type strings to React component implementations
+ */
+export type BlockComponentRegistry = Record<string, BlockComponent>;
+//# sourceMappingURL=component-types.d.ts.map

package/dist/blocks/component-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-types.d.ts","sourceRoot":"","sources":["../../src/blocks/component-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAMpD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAA;AAEzF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAA;IACpC,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,oBAAoB;IACpB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,CAAA;CAC/B;AAMD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;IACnE,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAA;IAClC,iDAAiD;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;IAC/B,gDAAgD;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC7C;AAMD;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9D,qBAAqB;IACrB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;IACjB,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;IAC7B,oBAAoB;IACpB,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAA;CACxC;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CACzD,KAAK,EAAE,mBAAmB,CAAC,CAAC,CAAC,KAC1B,SAAS,CAAC,GAAG;IAChB;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,CAAA;AAED,+EAA+E;AAC/E,MAAM,MAAM,WAAW,GAAG,WAAW,CAAA;AAErC;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA"}

package/dist/blocks/component-types.js

@@ -0,0 +1,11 @@
+/**
+ * Block Component Types
+ *
+ * Minimal type definitions for block React components.
+ * These types are structurally compatible with @pwfabric/runtime's
+ * BlockComponent and BlockComponentRegistry types.
+ *
+ * @module @pwfabric/runtime/blocks/component-types
+ */
+export {};
+//# sourceMappingURL=component-types.js.map

package/dist/blocks/component-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-types.js","sourceRoot":"","sources":["../../src/blocks/component-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}