@instructure/platform-block-content-editor 0.3.1 → 1.0.0

package/dist/registry/blockCatalogue.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Every block name this version of the package knows about — strings only, no component
+ * references, so a renderer can consult it without reaching for a block's implementation.
+ *
+ * Its job is to tell two failure modes apart when a saved document names a block the
+ * registry can't resolve: one the host deliberately left out, versus one nothing here has
+ * ever heard of (version skew, or corrupt content). A renderer reports those differently;
+ * see `UnresolvedBlockReason`.
+ */
+/** Grouping used by an authoring UI's block tray. */
+export declare const BlockCategory: {
+    readonly LAYOUT: "layout";
+    readonly ACTIVITY_CONTENT: "activityContent";
+    readonly INTERACTIVE_CONTENT: "interactiveContent";
+    readonly WIDGET: "widget";
+};
+export type BlockCategory = (typeof BlockCategory)[keyof typeof BlockCategory];
+export interface BlockCatalogueEntry {
+    category: BlockCategory;
+    acceptsChildren: boolean;
+}
+/**
+ * Keys are **wire format** — the `component` string in stored `TemplateLayout` — and are
+ * not always the component's name. `Header` renders `Banner`, `QuoteBlock` renders
+ * `Quote`, `KnowledgeCheckBlock` renders `KnowledgeCheck`. Renaming a key orphans every
+ * document that used it.
+ *
+ * No labels here: a label is user-facing text, so it arrives already translated when the
+ * host registers the block (`create<Name>Block({ label })`). An unresolved block has no
+ * label by definition.
+ */
+export declare const BLOCK_CATALOGUE: {
+    readonly LayoutContainer: {
+        readonly category: "layout";
+        readonly acceptsChildren: true;
+    };
+    readonly TwoColumn: {
+        readonly category: "layout";
+        readonly acceptsChildren: true;
+    };
+    readonly Header: {
+        readonly category: "activityContent";
+        readonly acceptsChildren: false;
+    };
+    readonly Text: {
+        readonly category: "activityContent";
+        readonly acceptsChildren: false;
+    };
+    readonly QuoteBlock: {
+        readonly category: "activityContent";
+        readonly acceptsChildren: false;
+    };
+    readonly CodeBlock: {
+        readonly category: "activityContent";
+        readonly acceptsChildren: false;
+    };
+    readonly ImageBlock: {
+        readonly category: "activityContent";
+        readonly acceptsChildren: false;
+    };
+    readonly VideoBlock: {
+        readonly category: "activityContent";
+        readonly acceptsChildren: false;
+    };
+    readonly Accordion: {
+        readonly category: "interactiveContent";
+        readonly acceptsChildren: false;
+    };
+    readonly TabsBlock: {
+        readonly category: "interactiveContent";
+        readonly acceptsChildren: false;
+    };
+    readonly KnowledgeCheckBlock: {
+        readonly category: "interactiveContent";
+        readonly acceptsChildren: false;
+    };
+    readonly FlashCards: {
+        readonly category: "interactiveContent";
+        readonly acceptsChildren: false;
+    };
+    readonly MixAndMatch: {
+        readonly category: "interactiveContent";
+        readonly acceptsChildren: false;
+    };
+    readonly WidgetBlock: {
+        readonly category: "widget";
+        readonly acceptsChildren: false;
+    };
+};
+/** Wire names of the blocks this package ships. */
+export type BlockName = keyof typeof BLOCK_CATALOGUE;
+export declare function isKnownBlock(name: string): name is BlockName;
+/**
+ * Why a renderer could not resolve a node.
+ *
+ * `not-registered` is a host configuration choice; `unknown` is closer to an incident.
+ * Neither ever mutates the document — the node and its content are left exactly as saved.
+ */
+export type UnresolvedBlockReason = 'not-registered' | 'unknown';
+export interface UnresolvedBlock {
+    /** Node id from the layout. */
+    id: string;
+    /** The unresolvable `component` string, verbatim. */
+    component: string;
+    reason: UnresolvedBlockReason;
+}
+export declare function unresolvedReason(component: string): UnresolvedBlockReason;
+//# sourceMappingURL=blockCatalogue.d.ts.map

package/dist/registry/blockCatalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockCatalogue.d.ts","sourceRoot":"","sources":["../../src/registry/blockCatalogue.ts"],"names":[],"mappings":"AAkBA;;;;;;;;GAQG;AAEH,qDAAqD;AACrD,eAAO,MAAM,aAAa;;;;;CAKhB,CAAA;AAEV,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAA;AAE9E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,aAAa,CAAA;IACvB,eAAe,EAAE,OAAO,CAAA;CACzB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkB4B,CAAA;AAExD,mDAAmD;AACnD,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,eAAe,CAAA;AAEpD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,SAAS,CAI5D;AAED;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG,SAAS,CAAA;AAEhE,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,qBAAqB,CAAA;CAC9B;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB,CAEzE"}

package/dist/registry/blockRegistry.d.ts

@@ -0,0 +1,67 @@
+import { ComponentType, ReactNode } from 'react';
+import { RegisteredComponentSchema } from '../schema/registeredSchema';
+/**
+ * Everything a renderer needs to resolve one block.
+ *
+ * The host composes the registry itself — this package ships entry *factories*
+ * (`create<Name>Block`) rather than a default registry, so which blocks a document may
+ * contain is the host's decision, and no host is asked for the strings or the label of a
+ * block it does not offer.
+ */
+export interface BlockRegistryEntry<TProps = unknown> {
+    component: ComponentType<TProps>;
+    schema: RegisteredComponentSchema<TProps>;
+    defaultProps: Partial<TProps>;
+    /** Already translated by the host — see `create<Name>Block`. */
+    label: string;
+    /**
+     * Whether a `TemplateLayout` node of this block may carry `children`. Read by the
+     * renderers instead of a hardcoded name list, which is what makes a host-defined
+     * container possible at all.
+     */
+    acceptsChildren?: boolean;
+    /**
+     * Wrap each child in its own div positioned by `gridColumn`, rather than rendering
+     * children straight into the block.
+     *
+     * TwoColumn needs this: its stylesheet collapses and reorders the columns via `> *` and
+     * `> div:nth-of-type(1|2)`, so the per-child div is load-bearing. Expressed as a flag on
+     * the entry rather than a block name hardcoded in the renderer, so the wire name stays
+     * the host's choice and a host's own two-column block can opt in.
+     */
+    wrapsChildrenInGridCells?: boolean;
+    /** Lightweight stand-in for drag operations, where mounting the real block is too costly. */
+    renderDragPreview?: (props: Partial<TProps>) => ReactNode;
+}
+/**
+ * A host-composed map of wire name → entry.
+ *
+ * This is the **constraint**, not an annotation to write on a registry — see
+ * `defineRegistry`.
+ *
+ * `any` rather than `unknown` is deliberate: entries are heterogeneous, and a
+ * `BlockRegistryEntry<unknown>` constraint would reject every concretely-typed entry
+ * because `ComponentType<TProps>` is contravariant in its props.
+ */
+export type BlockRegistry = Record<string, BlockRegistryEntry<any>>;
+/**
+ * Identity at runtime; its whole job is to check a registry against `BlockRegistry`
+ * **without widening it**.
+ *
+ * `const registry: BlockRegistry = {…}` type-checks and then silently destroys every
+ * derived type: `keyof R & string` becomes `string` and `PropsOf` becomes `any`, so
+ * `TemplateLayoutFor` accepts any `component` and any `props` — with no diagnostic
+ * anywhere, in the annotated file or in the host code downstream. `satisfies` avoids that,
+ * but nothing stops a host reaching for the annotation, and the failure is invisible.
+ *
+ * Inferring `R` from the argument makes the widening unrepresentable:
+ *
+ * ```ts
+ * const registry = defineRegistry({ Text: createTextBlock({ … }) })
+ * type AppLayout = TemplateLayoutFor<typeof registry>  // component: 'Text'
+ * ```
+ */
+export declare function defineRegistry<R extends BlockRegistry>(registry: R): R;
+/** Recovers a block's props type from its registry entry. */
+export type PropsOf<E> = E extends BlockRegistryEntry<infer P> ? P : never;
+//# sourceMappingURL=blockRegistry.d.ts.map

package/dist/registry/blockRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/blockRegistry.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACrD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAA;AAE3E;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB,CAAC,MAAM,GAAG,OAAO;IAClD,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAChC,MAAM,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAA;IACzC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7B,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;;;;;OAQG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAA;IAClC,6FAA6F;IAC7F,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,SAAS,CAAA;CAC1D;AAED;;;;;;;;;GASG;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAA;AAEnE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,aAAa,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAEtE;AAED,6DAA6D;AAC7D,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA"}

package/dist/registry/defineBlock.d.ts

@@ -0,0 +1,55 @@
+import { ComponentType, ReactNode } from 'react';
+import { AllStringValues } from '../contexts/BlockTranslationsContext';
+import { RegisteredComponentSchema } from '../schema/registeredSchema';
+import { BlockName } from './blockCatalogue';
+import { BlockRegistryEntry } from './blockRegistry';
+/** The parts of an entry that are fixed by the block itself. */
+export interface BlockDefinition<TProps> {
+    /**
+     * The `component` string stored documents use for this block — not always the component's
+     * name (`Header` is Banner).
+     *
+     * Any string is accepted so a host can define its own blocks with this helper; the
+     * `BlockName` union is there for autocomplete on the ones this package ships. For those,
+     * `acceptsChildren` is taken from `BLOCK_CATALOGUE` so the two can't drift, and the
+     * option below is ignored.
+     */
+    wireName: BlockName | (string & {});
+    component: ComponentType<TProps>;
+    schema: RegisteredComponentSchema<TProps>;
+    defaultProps: Partial<TProps>;
+    /** Host blocks only — catalogued blocks take this from `BLOCK_CATALOGUE`. */
+    acceptsChildren?: boolean;
+    renderDragPreview?: (props: Partial<TProps>) => ReactNode;
+    wrapsChildrenInGridCells?: boolean;
+}
+/** What the host supplies for a block that owns strings. */
+export interface BlockFactoryOptions<TTranslations> {
+    /** Already translated. Shown wherever an authoring UI lists this block. */
+    label: string;
+    /** Already translated. `<Name>English` holds the source strings. */
+    translations: TTranslations;
+}
+/** What the host supplies for a block with no strings of its own. */
+export interface UntranslatedBlockFactoryOptions {
+    /** Already translated. Shown wherever an authoring UI lists this block. */
+    label: string;
+}
+/**
+ * Builds a block's `create<Name>Block` factory.
+ *
+ * `english` is the type witness: passing a block's English slice is what pins the
+ * `translations` the resulting factory demands, so a host gets exactly that block's keys —
+ * no more, none missing. Omit it and the factory takes only a `label`.
+ *
+ * **Build the registry once.** Each call returns a fresh component identity, so a registry
+ * rebuilt on every render remounts every block — a flipped flashcard, an answered quiz or
+ * an open accordion all reset. Hoist it to module scope, or memoise it.
+ */
+export declare function defineBlock<TProps, TEnglish extends AllStringValues<TEnglish>>(definition: BlockDefinition<TProps> & {
+    english: TEnglish;
+}): (options: BlockFactoryOptions<TEnglish>) => BlockRegistryEntry<TProps>;
+export declare function defineBlock<TProps>(definition: BlockDefinition<TProps> & {
+    english?: never;
+}): (options: UntranslatedBlockFactoryOptions) => BlockRegistryEntry<TProps>;
+//# sourceMappingURL=defineBlock.d.ts.map

package/dist/registry/defineBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineBlock.d.ts","sourceRoot":"","sources":["../../src/registry/defineBlock.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,aAAa,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACzE,OAAO,EACL,KAAK,eAAe,EAErB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAA;AAC3E,OAAO,EAAmB,KAAK,SAAS,EAAgB,MAAM,kBAAkB,CAAA;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAYzD,gEAAgE;AAChE,MAAM,WAAW,eAAe,CAAC,MAAM;IACrC;;;;;;;;OAQG;IACH,QAAQ,EAAE,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;IACnC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAChC,MAAM,EAAE,yBAAyB,CAAC,MAAM,CAAC,CAAA;IACzC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IAC7B,6EAA6E;IAC7E,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,SAAS,CAAA;IACzD,wBAAwB,CAAC,EAAE,OAAO,CAAA;CACnC;AAED,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB,CAAC,aAAa;IAChD,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,YAAY,EAAE,aAAa,CAAA;CAC5B;AAED,qEAAqE;AACrE,MAAM,WAAW,+BAA+B;IAC9C,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,QAAQ,SAAS,eAAe,CAAC,QAAQ,CAAC,EAC5E,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG;IAAE,OAAO,EAAE,QAAQ,CAAA;CAAE,GAC1D,CAAC,OAAO,EAAE,mBAAmB,CAAC,QAAQ,CAAC,KAAK,kBAAkB,CAAC,MAAM,CAAC,CAAA;AACzE,wBAAgB,WAAW,CAAC,MAAM,EAChC,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,KAAK,CAAA;CAAE,GACxD,CAAC,OAAO,EAAE,+BAA+B,KAAK,kBAAkB,CAAC,MAAM,CAAC,CAAA"}

package/dist/registry/getMergedProps.d.ts

@@ -0,0 +1,18 @@
+import { LayoutNode, TemplateData } from './templateTypes';
+/**
+ * Resolves the props one node renders with: **layout props, then template data**. That
+ * ordering is what lets content be revised (data) without touching structure (layout).
+ *
+ * Registry `defaultProps` are deliberately **not** layered underneath. They are the seed
+ * an editor writes into a *new* block — for several blocks that means three or four blank
+ * items (`KnowledgeCheckDefaultProps.answers`, `FlashCardsDefaultProps.cards`, …), not
+ * value defaults. Merging them here would turn a node with missing or partial content into
+ * a rendered blank activity: a learner would get three unlabelled checkboxes and a working
+ * "Check answer" button where the block should render nothing. Blocks default their own
+ * scalar props at the parameter list, which is the right mechanism for that.
+ *
+ * Layout props pass through as-is, grid positioning included; blocks ignore props they
+ * don't declare.
+ */
+export declare function getMergedProps(node: Pick<LayoutNode, 'id' | 'props'>, templateData?: TemplateData): Record<string, unknown>;
+//# sourceMappingURL=getMergedProps.d.ts.map

package/dist/registry/getMergedProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getMergedProps.d.ts","sourceRoot":"","sources":["../../src/registry/getMergedProps.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAE/D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,OAAO,CAAC,EACtC,YAAY,CAAC,EAAE,YAAY,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB"}

package/dist/registry/index.d.ts

@@ -0,0 +1,7 @@
+export { type BlockRegistry, type BlockRegistryEntry, defineRegistry, type PropsOf, } from './blockRegistry';
+export { BLOCK_CATALOGUE, BlockCategory, type BlockCatalogueEntry, type BlockName, isKnownBlock, type UnresolvedBlock, type UnresolvedBlockReason, unresolvedReason, } from './blockCatalogue';
+export { type BlockDefinition, type BlockFactoryOptions, defineBlock, type UntranslatedBlockFactoryOptions, } from './defineBlock';
+export { getMergedProps } from './getMergedProps';
+export { resolveBlockEntry } from './resolveBlockEntry';
+export type { GridPositionProps, LayoutNode, TemplateData, TemplateDataFor, TemplateLayoutFor, } from './templateTypes';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,cAAc,EACd,KAAK,OAAO,GACb,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,eAAe,EACf,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,gBAAgB,GACjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,WAAW,EACX,KAAK,+BAA+B,GACrC,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,iBAAiB,GAClB,MAAM,iBAAiB,CAAA"}

package/dist/registry/registryTypes.test.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=registryTypes.test.d.ts.map

package/dist/registry/registryTypes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registryTypes.test.d.ts","sourceRoot":"","sources":["../../src/registry/registryTypes.test.ts"],"names":[],"mappings":"AAuCA,OAAO,yBAAyB,CAAA"}

package/dist/registry/resolveBlockEntry.d.ts

@@ -0,0 +1,16 @@
+import { BlockRegistry } from './blockRegistry';
+/**
+ * Looks up the entry for a node's `component`. **Use this rather than
+ * `registry[node.component]`** — anywhere, including a host's own editor renderer.
+ *
+ * A bare index reads through `Object.prototype`, so a `component` of `toString`,
+ * `constructor` or `valueOf` resolves to a function and reads as *registered*. The caller
+ * then hands React `entry.component` — `undefined` — and React throws, taking down the
+ * whole tree rather than skipping one block. Stored documents are the least trusted input
+ * this package has, so that is a real path, and it is the one failure mode here that costs
+ * a reader their entire page.
+ *
+ * `hasOwnProperty.call` rather than `Object.hasOwn`, which needs the ES2022 lib.
+ */
+export declare function resolveBlockEntry<R extends BlockRegistry>(registry: R, component: string): R[keyof R] | undefined;
+//# sourceMappingURL=resolveBlockEntry.d.ts.map

package/dist/registry/resolveBlockEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveBlockEntry.d.ts","sourceRoot":"","sources":["../../src/registry/resolveBlockEntry.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,aAAa,EACvD,QAAQ,EAAE,CAAC,EACX,SAAS,EAAE,MAAM,GAChB,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAMxB"}

package/dist/registry/templateTypes.d.ts

@@ -0,0 +1,61 @@
+import { BlockRegistry, PropsOf } from './blockRegistry';
+/**
+ * Where a node sits in the designer's grid. Structure, never content — see the
+ * TemplateLayout/TemplateData split below.
+ */
+export interface GridPositionProps {
+    gridColumn?: number;
+    gridRow?: number;
+    columnSpan?: number;
+    rowSpan?: number;
+    order?: number;
+}
+/**
+ * The structural minimum every layout node satisfies, and what this package's own code
+ * works against.
+ *
+ * `props?: object`, not `Record<string, unknown>`: a host block whose props are declared
+ * as an `interface` gets no implicit index signature and would fail to assign, while a
+ * `z.infer`'d type alias would pass — an arbitrary distinction to inflict on a host.
+ */
+export interface LayoutNode {
+    component: string;
+    id: string;
+    props?: object;
+    children?: LayoutNode[];
+}
+/**
+ * Content props keyed by node id: `{ 'text-1': { content: '…' } }`.
+ *
+ * A map, not the array-of-single-key-objects the canvas-horizon viewer took. Callers
+ * holding the old shape flatten at their own boundary.
+ */
+export type TemplateData = Record<string, object>;
+/**
+ * A layout tree typed against a specific registry: `component` is narrowed to that
+ * registry's keys and `props` to the matching block's props.
+ *
+ * Instantiate once per host and alias it — the tree helpers are generic over
+ * `T extends LayoutNode`, so inference carries this type through a call without anyone
+ * writing a type argument:
+ *
+ * ```ts
+ * const registry = { Text: createTextBlock({ … }) } satisfies BlockRegistry
+ * type AppLayout = TemplateLayoutFor<typeof registry>
+ * ```
+ */
+export type TemplateLayoutFor<R extends BlockRegistry> = {
+    [K in keyof R & string]: {
+        component: K;
+        id: string;
+        props?: Partial<PropsOf<R[K]>> & GridPositionProps;
+        children?: TemplateLayoutFor<R>[];
+    };
+}[keyof R & string];
+/** `TemplateData` narrowed to the props of the blocks in `R`. */
+export type TemplateDataFor<R extends BlockRegistry> = {
+    [instanceId: string]: {
+        [K in keyof R]: Partial<PropsOf<R[K]>>;
+    }[keyof R];
+};
+//# sourceMappingURL=templateTypes.d.ts.map

package/dist/registry/templateTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templateTypes.d.ts","sourceRoot":"","sources":["../../src/registry/templateTypes.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAE7D;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAA;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAA;CACxB;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEjD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,aAAa,IAAI;KACtD,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG;QACvB,SAAS,EAAE,CAAC,CAAA;QACZ,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAA;QAClD,QAAQ,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAA;KAClC;CACF,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAA;AAEnB,iEAAiE;AACjE,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,aAAa,IAAI;IACrD,CAAC,UAAU,EAAE,MAAM,GAAG;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC,MAAM,CAAC,CAAC,CAAA;CAC1E,CAAA"}

package/dist/schema/zodExtensions.d.ts

@@ -7,6 +7,20 @@ export interface ZodRangeConfig {
     max: number;
     step?: number;
     formatValue?: string;
+    /**
+     * Label for the value itself. Set alongside `complementLabel` when the slider
+     * splits a whole between two named sides (a column-width ratio), so the host can
+     * render both ends rather than a single number.
+     */
+    valueLabel?: string;
+    /**
+     * Label for the *remainder of the whole* the slider divides — for a percentage range,
+     * `100 - value`, not `max - value`: `min`/`max` bound how lopsided the split may get,
+     * they do not shrink what is being split. A host computing `max + min - value` agrees
+     * only where the bounds are symmetric about the whole, as TwoColumn's 20–80 are.
+     * Only meaningful together with `valueLabel`.
+     */
+    complementLabel?: string;
 }
 export interface ZodHiddenWhenConfig {
     field: string;
@@ -79,6 +93,7 @@ declare module 'zod' {
         /**
          * Mark number field as a range slider input
          * @example z.number().zodRange({ min: 0, max: 100, step: 25, formatValue: '%' }).zodLabel('Size')
+         * @example z.number().zodRange({ min: 20, max: 80, step: 5, formatValue: '%', valueLabel: 'Left', complementLabel: 'Right' })
          */
         zodRange(config: ZodRangeConfig): this;
         /**

package/dist/schema/zodExtensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zodExtensions.d.ts","sourceRoot":"","sources":["../../src/schema/zodExtensions.ts"],"names":[],"mappings":"AAkBA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,CAAA;IACxD,YAAY,CAAC,EAAE,qBAAqB,GAAG,qBAAqB,EAAE,CAAA;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,cAAc,CAAA;IACtB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,CAiBtE;AASD;;GAEG;AACH,OAAO,QAAQ,KAAK,CAAC;IACnB,UAAU,OAAO,CAEf,MAAM,GAAG,GAAG,EACZ,GAAG,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,EACvC,KAAK,GAAG,MAAM;QAEd;;;WAGG;QACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;QAE7B;;;WAGG;QACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;QAEzC;;;WAGG;QACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;QAE3B;;;;WAIG;QACH,SAAS,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;QAEjC;;;WAGG;QACH,WAAW,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;QAErC;;;WAGG;QACH,WAAW,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;QAErC;;;WAGG;QACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAA;QACtC;;;WAGG;QACH,aAAa,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;QAEzC;;;WAGG;QACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;QAE/B;;;WAGG;QACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;QAE/B;;;WAGG;QACH,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAA;QAEhD;;;WAGG;QACH,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAA;QAEpD;;;WAGG;QACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;QAErC;;;WAGG;QACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;QAE/B;;;;WAIG;QACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;QAEzC;;;WAGG;QACH,UAAU,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;QAEnC;;;WAGG;QACH,UAAU,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;KACpC;CACF"}
+{"version":3,"file":"zodExtensions.d.ts","sourceRoot":"","sources":["../../src/schema/zodExtensions.ts"],"names":[],"mappings":"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"}

package/dist/utils/shuffleCards.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Fisher–Yates over a copy: the input is a host-owned prop array, which a block must
+ * never reorder in place.
+ */
+export declare function shuffleCards<T>(items: readonly T[]): T[];
+//# sourceMappingURL=shuffleCards.d.ts.map

package/dist/utils/shuffleCards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shuffleCards.d.ts","sourceRoot":"","sources":["../../src/utils/shuffleCards.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAOxD"}

package/dist/utils/useMotionEnabled.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Whether a block may animate. A host zeroing `transitions.duration` — the token that
+ * already means "no motion" to every InstUI component — switches the block's motion off.
+ * It is only a switch: the timings themselves belong to the block, a designed motion
+ * rather than the generic UI transition that token sizes.
+ *
+ * The reader's `prefers-reduced-motion` is the other switch, and belongs in each block's
+ * CSS as a media query, so it needs no listener here.
+ */
+export declare function useMotionEnabled(): boolean;
+//# sourceMappingURL=useMotionEnabled.d.ts.map

package/dist/utils/useMotionEnabled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMotionEnabled.d.ts","sourceRoot":"","sources":["../../src/utils/useMotionEnabled.ts"],"names":[],"mappings":"AA0BA;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C"}

package/dist/viewer/Viewer.d.ts

@@ -0,0 +1,27 @@
+import { BlockRegistry } from '../registry/blockRegistry';
+import { UnresolvedBlock } from '../registry/blockCatalogue';
+import { LayoutNode, TemplateData } from '../registry/templateTypes';
+export interface ViewerProps {
+    /** Structure: which block, where, and what nests inside what. */
+    templateLayout: LayoutNode[];
+    /** Content, keyed by node id. Overrides matching layout props. */
+    templateData?: TemplateData;
+    /** Composed by the host — see `create<Name>Block`. */
+    componentRegistry: BlockRegistry;
+    /**
+     * Called once per node the registry could not resolve. The node is still left exactly
+     * as saved; this is for telemetry, not for repair. Nothing is shown to the reader —
+     * a diagnostic is not a learner's problem.
+     */
+    onUnresolvedBlock?: (block: UnresolvedBlock) => void;
+}
+/**
+ * Renders saved block content read-only.
+ *
+ * Emits no wrapper of its own — the blocks are direct layout children of whatever the
+ * host puts them in, so the host's own container keeps full control of layout, and any
+ * host-specific typography (Canvas, for one, needs rules to beat its own element-level
+ * heading styles) belongs on that container rather than in here.
+ */
+export declare function Viewer({ templateLayout, templateData, componentRegistry, onUnresolvedBlock, }: ViewerProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=Viewer.d.ts.map

package/dist/viewer/Viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Viewer.d.ts","sourceRoot":"","sources":["../../src/viewer/Viewer.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAE,KAAK,eAAe,EAAoB,MAAM,4BAA4B,CAAA;AAGnF,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAEzE,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,cAAc,EAAE,UAAU,EAAE,CAAA;IAC5B,kEAAkE;IAClE,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,sDAAsD;IACtD,iBAAiB,EAAE,aAAa,CAAA;IAChC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;CACrD;AAmID;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,EACrB,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,GAClB,EAAE,WAAW,kDA6Bb"}

package/dist/viewer/index.d.ts

@@ -0,0 +1,2 @@
+export { Viewer, type ViewerProps } from './Viewer';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/viewer/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAA"}

package/locales/en.json

@@ -17,5 +17,48 @@
   "videoBlockTitle": "Video",
   "accordionPlaceholder": "Add accordion...",
   "accordionItemPlaceholderTitle": "Accordion %{index}",
-  "accordionItemPlaceholderContent": "Your content here..."
+  "accordionItemPlaceholderContent": "Your content here...",
+  "tabsBlockItemPlaceholderTitle": "Tab %{index}",
+  "tabsBlockItemPlaceholderContent": "Your content here...",
+  "flashCardsTitle": "Flashcards",
+  "flashCardsPlaceholder": "Add flashcards...",
+  "flashCardsFrontLabel": "Front",
+  "flashCardsBackLabel": "Back",
+  "flashCardsFlipHint": "Click to flip",
+  "flashCardsCounter": "%{current} of %{total}",
+  "flashCardsCardAnnouncement": "Card %{current} of %{total}: %{question}",
+  "flashCardsPreviousCard": "Previous card",
+  "flashCardsNextCard": "Next card",
+  "flashCardsFrontAriaLabel": "Front: %{question}. Click to see answer.",
+  "flashCardsBackAriaLabel": "Back: %{answer}. Click to see question.",
+  "mixAndMatchTitle": "Mix and match",
+  "mixAndMatchPlaceholder": "Add mix and match...",
+  "mixAndMatchInstructions": "Click a card from the left and then right to pair.",
+  "mixAndMatchCompleteTitle": "Nice work!",
+  "mixAndMatchCompleteSubtitle": "You matched all the cards.",
+  "mixAndMatchPracticeAgain": "Practice again",
+  "mixAndMatchReset": "Reset",
+  "mixAndMatchCorrect": "Correct match!",
+  "mixAndMatchIncorrect": "Incorrect match, try again.",
+  "mixAndMatchCloseFeedback": "Close match feedback message",
+  "mixAndMatchTermAriaLabel": "Term: %{text}",
+  "mixAndMatchDefinitionAriaLabel": "Definition: %{text}",
+  "mixAndMatchProgress": "%{matched} of %{total} matched",
+  "mixAndMatchProgressShort": "%{matched}/%{total}",
+  "knowledgeCheckTitle": "Knowledge check",
+  "knowledgeCheckPlaceholder": "Add knowledge check...",
+  "knowledgeCheckQuestionPlaceholder": "Your question here",
+  "knowledgeCheckAnswerPlaceholder": "Answer %{index}",
+  "knowledgeCheckSelectOne": "Select one answer.",
+  "knowledgeCheckSelectAll": "Select all that apply.",
+  "knowledgeCheckCheckAnswer": "Check answer",
+  "knowledgeCheckTryAgain": "Try again",
+  "knowledgeCheckPracticeAgain": "Practice again",
+  "knowledgeCheckCorrect": "Nice work! You got the correct answer!",
+  "knowledgeCheckIncorrect": "Oops, that's incorrect.",
+  "knowledgeCheckAnswerCorrectLabel": "Correct",
+  "knowledgeCheckAnswerIncorrectLabel": "Incorrect",
+  "widgetBlockPlaceholder": "Add widget...",
+  "widgetBlockLoading": "Loading widget...",
+  "widgetBlockError": "Failed to load widget"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@instructure/platform-block-content-editor",
-  "version": "0.3.1",
+  "version": "1.0.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -19,42 +19,46 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "vite build",
-    "dev": "vite build --watch",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "lint": "oxlint -c ../../oxlint.json && ast-grep scan . --report-style=short",
-    "lint:fix": "oxlint -c ../../oxlint.json --fix && biome format --write .",
-    "type-check": "tsc -p tsconfig.check.json",
-    "pack:tarball": "pnpm build && pnpm pack"
-  },
   "peerDependencies": {
+    "@instructure/emotion": "^11.0.0",
+    "@instructure/ui-a11y-content": "^11.0.0",
+    "@instructure/ui-alerts": "^11.0.0",
+    "@instructure/ui-buttons": "^11.0.0",
+    "@instructure/ui-checkbox": "^11.0.0",
     "@instructure/ui-flex": "^11.0.0",
     "@instructure/ui-heading": "^11.0.0",
     "@instructure/ui-icons": "^11.0.0",
     "@instructure/ui-img": "^11.0.0",
+    "@instructure/ui-progress": "^11.0.0",
+    "@instructure/ui-radio-input": "^11.0.0",
     "@instructure/ui-spinner": "^11.0.0",
     "@instructure/ui-text": "^11.0.0",
     "@instructure/ui-toggle-details": "^11.0.0",
     "@instructure/ui-view": "^11.0.0",
-    "react": "^18.0.0",
-    "react-dom": "^18.0.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
     "zod": "^3.23.8"
   },
   "dependencies": {
-    "@instructure/platform-sanitize": "workspace:*"
+    "@instructure/platform-sanitize": "^0.7.0"
   },
   "devDependencies": {
-    "@instructure/ui-flex": "11.6.0",
-    "@instructure/ui-heading": "11.6.0",
-    "@instructure/ui-icons": "11.6.0",
-    "@instructure/ui-img": "11.6.0",
-    "@instructure/ui-spinner": "11.6.0",
-    "@instructure/ui-text": "11.6.0",
-    "@instructure/ui-toggle-details": "11.6.0",
-    "@instructure/ui-view": "11.6.0",
+    "@instructure/emotion": "11.7.4",
+    "@instructure/ui-a11y-content": "11.7.4",
+    "@instructure/ui-alerts": "11.7.4",
+    "@instructure/ui-buttons": "11.7.4",
+    "@instructure/ui-checkbox": "11.7.4",
+    "@instructure/ui-flex": "11.7.4",
+    "@instructure/ui-heading": "11.7.4",
+    "@instructure/ui-icons": "11.7.4",
+    "@instructure/ui-img": "11.7.4",
+    "@instructure/ui-progress": "11.7.4",
+    "@instructure/ui-radio-input": "11.7.4",
+    "@instructure/ui-spinner": "11.7.4",
+    "@instructure/ui-text": "11.7.4",
+    "@instructure/ui-themes": "11.7.4",
+    "@instructure/ui-toggle-details": "11.7.4",
+    "@instructure/ui-view": "11.7.4",
     "@storybook/react": "^10.0.8",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.0",
@@ -69,5 +73,16 @@
     "vite-plugin-dts": "^4.0.0",
     "vitest": "^4.0.0",
     "zod": "^3.23.8"
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev": "vite build --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "oxlint -c ../../oxlint.json && ast-grep scan . --report-style=short",
+    "lint:fix": "oxlint -c ../../oxlint.json --fix && biome format --write .",
+    "type-check": "tsc -p tsconfig.check.json",
+    "pack:tarball": "pnpm build && pnpm pack"
   }
-}
+}