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

package/dist/blocks/composition-rules.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Composition Rules
+ *
+ * CP7: Rules defining valid block compositions
+ *
+ * @module @pwfabric/core/blocks/composition-rules
+ */
+import type { CompositionRule } from '@pwfabric/core';
+/**
+ * Maximum nesting depth rule
+ *
+ * Prevents blocks from being nested too deeply.
+ */
+export declare const maxDepthRule: CompositionRule;
+/**
+ * Form children rule
+ *
+ * Forms can contain all form input elements plus structural/content blocks.
+ */
+export declare const formChildrenRule: CompositionRule;
+/**
+ * Grid children rule
+ *
+ * Grids cannot have nested grids as direct children.
+ */
+export declare const gridChildrenRule: CompositionRule;
+/**
+ * Button no children rule
+ *
+ * Buttons cannot have children.
+ */
+export declare const buttonNoChildrenRule: CompositionRule;
+/**
+ * Text no children rule
+ *
+ * Text blocks cannot have children.
+ */
+export declare const textNoChildrenRule: CompositionRule;
+/**
+ * Heading no children rule
+ *
+ * Heading blocks cannot have children.
+ */
+export declare const headingNoChildrenRule: CompositionRule;
+/**
+ * Image no children rule
+ *
+ * Image blocks cannot have children.
+ */
+export declare const imageNoChildrenRule: CompositionRule;
+/**
+ * Input no children rule
+ *
+ * Input blocks cannot have children.
+ */
+export declare const inputNoChildrenRule: CompositionRule;
+/**
+ * Input required parent rule
+ *
+ * Inputs should be inside forms or containers.
+ */
+export declare const inputParentRule: CompositionRule;
+/**
+ * Link no children rule
+ *
+ * Link blocks cannot have children.
+ */
+export declare const linkNoChildrenRule: CompositionRule;
+/**
+ * Icon no children rule
+ *
+ * Icon blocks cannot have children.
+ */
+export declare const iconNoChildrenRule: CompositionRule;
+/**
+ * Badge no children rule
+ *
+ * Badge blocks cannot have children.
+ */
+export declare const badgeNoChildrenRule: CompositionRule;
+/**
+ * Code no children rule
+ *
+ * Code blocks cannot have children.
+ */
+export declare const codeNoChildrenRule: CompositionRule;
+/**
+ * Divider no children rule
+ *
+ * Divider blocks cannot have children.
+ */
+export declare const dividerNoChildrenRule: CompositionRule;
+/**
+ * List no children rule
+ *
+ * List blocks cannot have children.
+ */
+export declare const listNoChildrenRule: CompositionRule;
+/**
+ * Table no children rule
+ *
+ * Table blocks cannot have children.
+ */
+export declare const tableNoChildrenRule: CompositionRule;
+/**
+ * Accordion no children rule
+ *
+ * Accordion items are defined via props, not children.
+ */
+export declare const accordionNoChildrenRule: CompositionRule;
+/**
+ * Dropdown no children rule
+ *
+ * Dropdown items are defined via props, not children.
+ */
+export declare const dropdownNoChildrenRule: CompositionRule;
+/**
+ * Avatar no children rule
+ *
+ * Avatar is a leaf block with no children.
+ */
+export declare const avatarNoChildrenRule: CompositionRule;
+/**
+ * Tooltip children rule
+ *
+ * Tooltip can wrap specific inline/interactive blocks.
+ */
+export declare const tooltipChildrenRule: CompositionRule;
+/**
+ * Tabs children rule
+ *
+ * Tabs can contain containers as tab panels.
+ */
+export declare const tabsChildrenRule: CompositionRule;
+/**
+ * Modal children rule
+ *
+ * Modal can contain layout and content blocks.
+ */
+export declare const modalChildrenRule: CompositionRule;
+/**
+ * No self nesting rule
+ *
+ * Blocks cannot be nested inside themselves.
+ */
+export declare const noSelfNestingRule: CompositionRule;
+/**
+ * All composition rules
+ */
+export declare const compositionRules: readonly CompositionRule[];
+/**
+ * Get rules that apply to a specific block type
+ *
+ * @param blockType - Block type to get rules for
+ * @returns Array of applicable rules
+ */
+export declare function getRulesForBlockType(blockType: string): readonly CompositionRule[];
+/**
+ * Get rules by type
+ *
+ * @param ruleType - Rule type to filter by
+ * @returns Array of matching rules
+ */
+export declare function getRulesByType(ruleType: CompositionRule['type']): readonly CompositionRule[];
+/** Allowed direct children of a tabs block */
+export declare const TABS_ALLOWED_CHILDREN: Set<string>;
+/** Allowed direct children of a form block */
+export declare const FORM_ALLOWED_CHILDREN: Set<string>;
+//# sourceMappingURL=composition-rules.d.ts.map

package/dist/blocks/composition-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition-rules.d.ts","sourceRoot":"","sources":["../../src/blocks/composition-rules.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAOrD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,eAO1B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAuC9B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAO9B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,eAKlC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,eAKhC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,eAKnC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,eAKjC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,eAKjC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,eAQ7B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,eAKhC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,eAKhC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,eAKjC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,eAKhC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,eAKnC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,eAKhC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,eAKjC,CAAA;AAMD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,eAKrC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAKpC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,eAKlC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,eAOjC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,eAO9B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAqB/B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,eAK/B,CAAA;AAMD;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,eAAe,EA8B7C,CAAA;AAEV;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,eAAe,EAAE,CAElF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,SAAS,eAAe,EAAE,CAE5F;AAOD,8CAA8C;AAC9C,eAAO,MAAM,qBAAqB,aAA+D,CAAA;AAEjG,8CAA8C;AAC9C,eAAO,MAAM,qBAAqB,aAA+D,CAAA"}

package/dist/blocks/composition-rules.js

@@ -0,0 +1,391 @@
+/**
+ * Composition Rules
+ *
+ * CP7: Rules defining valid block compositions
+ *
+ * @module @pwfabric/core/blocks/composition-rules
+ */
+import { MAX_NESTING_DEPTH } from '@pwfabric/core';
+// ============================================================
+// BUILT-IN RULES
+// ============================================================
+/**
+ * Maximum nesting depth rule
+ *
+ * Prevents blocks from being nested too deeply.
+ */
+export const maxDepthRule = {
+    type: 'max_depth',
+    description: `Blocks cannot be nested more than ${MAX_NESTING_DEPTH} levels deep`,
+    appliesTo: '*',
+    config: {
+        maxDepth: MAX_NESTING_DEPTH,
+    },
+};
+/**
+ * Form children rule
+ *
+ * Forms can contain all form input elements plus structural/content blocks.
+ */
+export const formChildrenRule = {
+    type: 'allowed_children',
+    description: 'Forms can contain form input elements and structural/content blocks (text, heading, container, divider, button)',
+    appliesTo: 'form',
+    config: {
+        allowedChildren: [
+            // Form input elements — the form family of the first-party base pack as
+            // shipped, so every field a form pattern uses passes validation.
+            'input',
+            'textarea',
+            'select',
+            'checkbox',
+            'radio',
+            'toggle',
+            'slider',
+            'combobox',
+            'date-input',
+            'file-dropzone',
+            'number-stepper',
+            'otp-input',
+            'rich-text-editor',
+            'segmented-control',
+            'tag-input',
+            // legacy names kept so older documents keep validating
+            'switch',
+            'file-upload',
+            // Structural / content blocks valid inside forms
+            'button',
+            'text',
+            'heading',
+            'container',
+            'divider',
+            'badge',
+            'icon',
+            'link',
+            'alert',
+        ],
+    },
+};
+/**
+ * Grid children rule
+ *
+ * Grids cannot have nested grids as direct children.
+ */
+export const gridChildrenRule = {
+    type: 'allowed_children',
+    description: 'Grids cannot contain other grids as direct children',
+    appliesTo: 'grid',
+    config: {
+        disallowedChildren: ['grid'],
+    },
+};
+/**
+ * Button no children rule
+ *
+ * Buttons cannot have children.
+ */
+export const buttonNoChildrenRule = {
+    type: 'no_children',
+    description: 'Buttons cannot have children',
+    appliesTo: 'button',
+    config: {},
+};
+/**
+ * Text no children rule
+ *
+ * Text blocks cannot have children.
+ */
+export const textNoChildrenRule = {
+    type: 'no_children',
+    description: 'Text blocks cannot have children',
+    appliesTo: 'text',
+    config: {},
+};
+/**
+ * Heading no children rule
+ *
+ * Heading blocks cannot have children.
+ */
+export const headingNoChildrenRule = {
+    type: 'no_children',
+    description: 'Heading blocks cannot have children',
+    appliesTo: 'heading',
+    config: {},
+};
+/**
+ * Image no children rule
+ *
+ * Image blocks cannot have children.
+ */
+export const imageNoChildrenRule = {
+    type: 'no_children',
+    description: 'Image blocks cannot have children',
+    appliesTo: 'image',
+    config: {},
+};
+/**
+ * Input no children rule
+ *
+ * Input blocks cannot have children.
+ */
+export const inputNoChildrenRule = {
+    type: 'no_children',
+    description: 'Input blocks cannot have children',
+    appliesTo: 'input',
+    config: {},
+};
+/**
+ * Input required parent rule
+ *
+ * Inputs should be inside forms or containers.
+ */
+export const inputParentRule = {
+    type: 'allowed_parents',
+    description: 'Inputs should be placed inside forms or containers',
+    appliesTo: 'input',
+    config: {
+        allowedParents: ['form', 'container'],
+        severity: 'warning',
+    },
+};
+/**
+ * Link no children rule
+ *
+ * Link blocks cannot have children.
+ */
+export const linkNoChildrenRule = {
+    type: 'no_children',
+    description: 'Link blocks cannot have children',
+    appliesTo: 'link',
+    config: {},
+};
+/**
+ * Icon no children rule
+ *
+ * Icon blocks cannot have children.
+ */
+export const iconNoChildrenRule = {
+    type: 'no_children',
+    description: 'Icon blocks cannot have children',
+    appliesTo: 'icon',
+    config: {},
+};
+/**
+ * Badge no children rule
+ *
+ * Badge blocks cannot have children.
+ */
+export const badgeNoChildrenRule = {
+    type: 'no_children',
+    description: 'Badge blocks cannot have children',
+    appliesTo: 'badge',
+    config: {},
+};
+/**
+ * Code no children rule
+ *
+ * Code blocks cannot have children.
+ */
+export const codeNoChildrenRule = {
+    type: 'no_children',
+    description: 'Code blocks cannot have children',
+    appliesTo: 'code',
+    config: {},
+};
+/**
+ * Divider no children rule
+ *
+ * Divider blocks cannot have children.
+ */
+export const dividerNoChildrenRule = {
+    type: 'no_children',
+    description: 'Divider blocks cannot have children',
+    appliesTo: 'divider',
+    config: {},
+};
+/**
+ * List no children rule
+ *
+ * List blocks cannot have children.
+ */
+export const listNoChildrenRule = {
+    type: 'no_children',
+    description: 'List blocks cannot have children',
+    appliesTo: 'list',
+    config: {},
+};
+/**
+ * Table no children rule
+ *
+ * Table blocks cannot have children.
+ */
+export const tableNoChildrenRule = {
+    type: 'no_children',
+    description: 'Table blocks cannot have children',
+    appliesTo: 'table',
+    config: {},
+};
+// ============================================================
+// INTERACTIVE BLOCK RULES
+// ============================================================
+/**
+ * Accordion no children rule
+ *
+ * Accordion items are defined via props, not children.
+ */
+export const accordionNoChildrenRule = {
+    type: 'no_children',
+    description: 'Accordion items are defined via props, not as children blocks',
+    appliesTo: 'accordion',
+    config: {},
+};
+/**
+ * Dropdown no children rule
+ *
+ * Dropdown items are defined via props, not children.
+ */
+export const dropdownNoChildrenRule = {
+    type: 'no_children',
+    description: 'Dropdown items are defined via props, not as children blocks',
+    appliesTo: 'dropdown',
+    config: {},
+};
+/**
+ * Avatar no children rule
+ *
+ * Avatar is a leaf block with no children.
+ */
+export const avatarNoChildrenRule = {
+    type: 'no_children',
+    description: 'Avatar blocks cannot have children',
+    appliesTo: 'avatar',
+    config: {},
+};
+/**
+ * Tooltip children rule
+ *
+ * Tooltip can wrap specific inline/interactive blocks.
+ */
+export const tooltipChildrenRule = {
+    type: 'allowed_children',
+    description: 'Tooltips can only wrap text, buttons, icons, badges, and links',
+    appliesTo: 'tooltip',
+    config: {
+        allowedChildren: ['text', 'button', 'icon', 'badge', 'link'],
+    },
+};
+/**
+ * Tabs children rule
+ *
+ * Tabs can contain containers as tab panels.
+ */
+export const tabsChildrenRule = {
+    type: 'allowed_children',
+    description: 'Tabs can only contain containers as tab panel content',
+    appliesTo: 'tabs',
+    config: {
+        allowedChildren: ['container'],
+    },
+};
+/**
+ * Modal children rule
+ *
+ * Modal can contain layout and content blocks.
+ */
+export const modalChildrenRule = {
+    type: 'allowed_children',
+    description: 'Modals can contain layout and content blocks',
+    appliesTo: 'modal',
+    config: {
+        allowedChildren: [
+            'container',
+            'grid',
+            'text',
+            'heading',
+            'button',
+            'image',
+            'form',
+            'input',
+            'list',
+            'table',
+            'divider',
+            'icon',
+            'badge',
+        ],
+    },
+};
+/**
+ * No self nesting rule
+ *
+ * Blocks cannot be nested inside themselves.
+ */
+export const noSelfNestingRule = {
+    type: 'no_self_nesting',
+    description: 'Blocks cannot be nested inside themselves',
+    appliesTo: '*',
+    config: {},
+};
+// ============================================================
+// ALL RULES
+// ============================================================
+/**
+ * All composition rules
+ */
+export const compositionRules = [
+    maxDepthRule,
+    formChildrenRule,
+    gridChildrenRule,
+    // Content blocks - no children
+    buttonNoChildrenRule,
+    textNoChildrenRule,
+    headingNoChildrenRule,
+    linkNoChildrenRule,
+    iconNoChildrenRule,
+    badgeNoChildrenRule,
+    codeNoChildrenRule,
+    dividerNoChildrenRule,
+    // Layout blocks - no children (leaf)
+    listNoChildrenRule,
+    tableNoChildrenRule,
+    // Media blocks - no children
+    imageNoChildrenRule,
+    // Form blocks - no children
+    inputNoChildrenRule,
+    inputParentRule,
+    // Interactive blocks
+    accordionNoChildrenRule,
+    dropdownNoChildrenRule,
+    avatarNoChildrenRule,
+    tooltipChildrenRule,
+    tabsChildrenRule,
+    modalChildrenRule,
+    // Universal rules
+    noSelfNestingRule,
+];
+/**
+ * Get rules that apply to a specific block type
+ *
+ * @param blockType - Block type to get rules for
+ * @returns Array of applicable rules
+ */
+export function getRulesForBlockType(blockType) {
+    return compositionRules.filter((rule) => rule.appliesTo === '*' || rule.appliesTo === blockType);
+}
+/**
+ * Get rules by type
+ *
+ * @param ruleType - Rule type to filter by
+ * @returns Array of matching rules
+ */
+export function getRulesByType(ruleType) {
+    return compositionRules.filter((rule) => rule.type === ruleType);
+}
+// ============================================================
+// CANONICAL CHILD SETS (single source of truth)
+// Import these in API validator instead of redeclaring.
+// ============================================================
+/** Allowed direct children of a tabs block */
+export const TABS_ALLOWED_CHILDREN = new Set(tabsChildrenRule.config.allowedChildren);
+/** Allowed direct children of a form block */
+export const FORM_ALLOWED_CHILDREN = new Set(formChildrenRule.config.allowedChildren);
+//# sourceMappingURL=composition-rules.js.map

package/dist/blocks/composition-rules.js.map

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

package/dist/blocks/hooks.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Block Component Hooks
+ *
+ * React hooks used by block components for event emission and surface ID access.
+ *
+ * @module @pwfabric/runtime/blocks/hooks
+ */
+import type { SurfaceEventDescriptor } from '@pwfabric/contracts';
+/**
+ * Hook for block components to emit surface events.
+ *
+ * When the context is absent (no bus provided by the surface renderer)
+ * the hook returns a no-op `emit` so callers need no guard code.
+ *
+ * @example
+ * ```tsx
+ * const { emit } = useSurfaceEvents()
+ *
+ * const handleClick = () => {
+ *   emit({ type: SURFACE_EVENTS.BLOCK_CLICK, surfaceId, blockId: block.id })
+ * }
+ * ```
+ */
+export declare function useSurfaceEvents(): {
+    emit: (partial: Omit<SurfaceEventDescriptor, 'timestamp'>) => void;
+};
+/**
+ * Hook that returns the current surface ID from `SurfaceIdContext`.
+ * Returns an empty string when no `BehaviorSurfaceProvider` is in the tree.
+ */
+export declare function useSurfaceId(): string;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/blocks/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/blocks/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAIjE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,IAAI;IAClC,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,WAAW,CAAC,KAAK,IAAI,CAAA;CACnE,CASA;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/blocks/hooks.js

@@ -0,0 +1,42 @@
+/**
+ * Block Component Hooks
+ *
+ * React hooks used by block components for event emission and surface ID access.
+ *
+ * @module @pwfabric/runtime/blocks/hooks
+ */
+import { useContext } from 'react';
+import { SurfaceEventContext } from './surface-event-context.js';
+import { SurfaceIdContext } from './surface-id-context.js';
+/**
+ * Hook for block components to emit surface events.
+ *
+ * When the context is absent (no bus provided by the surface renderer)
+ * the hook returns a no-op `emit` so callers need no guard code.
+ *
+ * @example
+ * ```tsx
+ * const { emit } = useSurfaceEvents()
+ *
+ * const handleClick = () => {
+ *   emit({ type: SURFACE_EVENTS.BLOCK_CLICK, surfaceId, blockId: block.id })
+ * }
+ * ```
+ */
+export function useSurfaceEvents() {
+    const bus = useContext(SurfaceEventContext);
+    const emit = (partial) => {
+        if (!bus)
+            return;
+        bus.emit({ ...partial, timestamp: Date.now() });
+    };
+    return { emit };
+}
+/**
+ * Hook that returns the current surface ID from `SurfaceIdContext`.
+ * Returns an empty string when no `BehaviorSurfaceProvider` is in the tree.
+ */
+export function useSurfaceId() {
+    return useContext(SurfaceIdContext);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/blocks/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/blocks/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAElC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE1D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB;IAG9B,MAAM,GAAG,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAA;IAE3C,MAAM,IAAI,GAAG,CAAC,OAAkD,EAAQ,EAAE;QACxE,IAAI,CAAC,GAAG;YAAE,OAAM;QAChB,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;IACjD,CAAC,CAAA;IAED,OAAO,EAAE,IAAI,EAAE,CAAA;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC,gBAAgB,CAAC,CAAA;AACrC,CAAC"}

package/dist/blocks/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @pwfabric/runtime/blocks
+ *
+ * Core UI block schemas, definitions, and React components for the PWFabric platform.
+ *
+ * @module @pwfabric/runtime/blocks
+ */
+export * from './registry.js';
+export * from './composition-rules.js';
+export * from './rule-engine.js';
+export * from './component-types.js';
+export { SurfaceEventContext } from './surface-event-context.js';
+export { SurfaceIdContext } from './surface-id-context.js';
+export { useSurfaceEvents, useSurfaceId } from './hooks.js';
+export { populateTestBlocks, TEST_BLOCK_DEFINITIONS } from './__test-fixtures__/block-fixtures.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/blocks/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,cAAc,eAAe,CAAA;AAC7B,cAAc,wBAAwB,CAAA;AACtC,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAO3D,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAA"}