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

package/dist/components/blocks/TwoColumn/getTwoColumnViewProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTwoColumnViewProps.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/TwoColumn/getTwoColumnViewProps.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EAEnB,KAAK,UAAU,EAGhB,MAAM,wBAAwB,CAAA;AA6B/B;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACnC,yFAAyF;IACzF,YAAY,EAAE,aAAa,CAAA;CAC5B;AAED,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,UAAU,EACtB,cAAc,EAAE,cAAc,EAC9B,WAAW,EAAE,WAAW,EACxB,eAAe,EAAE,eAAe,EAChC,UAAU,CAAC,EAAE,MAAM,GAClB,kBAAkB,CAkCpB"}

package/dist/components/blocks/TwoColumn/index.d.ts

@@ -0,0 +1,5 @@
+export { TwoColumn } from './TwoColumn';
+export { RegisteredTwoColumnPropsSchema, TwoColumnDefaultProps } from './twoColumnPropsSchema';
+export type { TwoColumnProps } from './twoColumnPropsSchema';
+export { createTwoColumnBlock } from './createTwoColumnBlock';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/TwoColumn/index.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,OAAO,EAAE,8BAA8B,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAI9F,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAG5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/components/blocks/TwoColumn/twoColumnPropsSchema.d.ts

@@ -0,0 +1,60 @@
+import { ReactNode } from 'react';
+import { z } from 'zod';
+export declare const MIN_LEFT_COLUMN_WIDTH = 20;
+export declare const MAX_LEFT_COLUMN_WIDTH = 80;
+export declare const DEFAULT_LEFT_COLUMN_WIDTH = 50;
+export declare const GapSpacingSchema: z.ZodEnum<["none", "small", "medium", "large"]>;
+export type GapSpacing = z.infer<typeof GapSpacingSchema>;
+export declare const MobileStackingOrderSchema: z.ZodEnum<["left-first", "right-first"]>;
+export type MobileStackingOrder = z.infer<typeof MobileStackingOrderSchema>;
+export declare const ContainerStyleSchema: z.ZodEnum<["none", "outline", "solid"]>;
+export type ContainerStyle = z.infer<typeof ContainerStyleSchema>;
+/**
+ * The same three tones as `ColorThemeSchema` plus a transparent `none`, but only this
+ * block uses the set, so it stays local rather than moving to `commonSchemas`.
+ */
+export declare const BackgroundColorSchema: z.ZodEnum<["none", "light", "dark", "neutral"]>;
+export type BackgroundColor = z.infer<typeof BackgroundColorSchema>;
+export declare const TwoColumnPropsSchema: z.ZodObject<{
+    children: z.ZodAny;
+    leftColumnWidth: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    mobileStackingOrder: z.ZodOptional<z.ZodDefault<z.ZodEnum<["left-first", "right-first"]>>>;
+    gapSpacing: z.ZodOptional<z.ZodDefault<z.ZodEnum<["none", "small", "medium", "large"]>>>;
+    containerStyle: z.ZodOptional<z.ZodDefault<z.ZodEnum<["none", "outline", "solid"]>>>;
+    cornerStyle: z.ZodOptional<z.ZodDefault<z.ZodEnum<["rounded", "square"]>>>;
+    backgroundColor: z.ZodOptional<z.ZodDefault<z.ZodEnum<["none", "light", "dark", "neutral"]>>>;
+}, "strip", z.ZodTypeAny, {
+    children?: any;
+    cornerStyle?: "rounded" | "square" | undefined;
+    leftColumnWidth?: number | undefined;
+    mobileStackingOrder?: "left-first" | "right-first" | undefined;
+    gapSpacing?: "small" | "none" | "medium" | "large" | undefined;
+    containerStyle?: "none" | "outline" | "solid" | undefined;
+    backgroundColor?: "light" | "dark" | "neutral" | "none" | undefined;
+}, {
+    children?: any;
+    cornerStyle?: "rounded" | "square" | undefined;
+    leftColumnWidth?: number | undefined;
+    mobileStackingOrder?: "left-first" | "right-first" | undefined;
+    gapSpacing?: "small" | "none" | "medium" | "large" | undefined;
+    containerStyle?: "none" | "outline" | "solid" | undefined;
+    backgroundColor?: "light" | "dark" | "neutral" | "none" | undefined;
+}>;
+/**
+ * `children` is retyped off the schema's `z.any()`: the host passes React nodes, and the
+ * declaration emitter needs a public name for the resulting intersection.
+ */
+export type TwoColumnProps = Omit<z.infer<typeof TwoColumnPropsSchema>, 'children'> & {
+    children?: ReactNode;
+};
+export declare const TwoColumnDefaultProps: Omit<TwoColumnProps, 'children'>;
+export declare const RegisteredTwoColumnPropsSchema: import('../../..').RegisteredComponentSchema<{
+    children?: any;
+    cornerStyle?: "rounded" | "square" | undefined;
+    leftColumnWidth?: number | undefined;
+    mobileStackingOrder?: "left-first" | "right-first" | undefined;
+    gapSpacing?: "small" | "none" | "medium" | "large" | undefined;
+    containerStyle?: "none" | "outline" | "solid" | undefined;
+    backgroundColor?: "light" | "dark" | "neutral" | "none" | undefined;
+}>;
+//# sourceMappingURL=twoColumnPropsSchema.d.ts.map

package/dist/components/blocks/TwoColumn/twoColumnPropsSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twoColumnPropsSchema.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/TwoColumn/twoColumnPropsSchema.ts"],"names":[],"mappings":"AAmBA,OAAO,+BAA+B,CAAA;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,qBAAqB,KAAK,CAAA;AACvC,eAAO,MAAM,qBAAqB,KAAK,CAAA;AACvC,eAAO,MAAM,yBAAyB,KAAK,CAAA;AAE3C,eAAO,MAAM,gBAAgB,iDAA+C,CAAA;AAC5E,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEzD,eAAO,MAAM,yBAAyB,0CAAwC,CAAA;AAC9E,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAE3E,eAAO,MAAM,oBAAoB,yCAAuC,CAAA;AACxE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE;;;GAGG;AACH,eAAO,MAAM,qBAAqB,iDAA+C,CAAA;AACjF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;EAiD/B,CAAA;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,EAAE,UAAU,CAAC,GAAG;IACpF,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,qBAAqB,EAAE,IAAI,CAAC,cAAc,EAAE,UAAU,CAOlE,CAAA;AAID,eAAO,MAAM,8BAA8B;;;;;;;;EAG1C,CAAA"}

package/dist/components/blocks/TwoColumn/twoColumnStyles.d.ts

@@ -0,0 +1,13 @@
+export declare const TWO_COLUMN_CLASS: {
+    /**
+     * The outermost element. It carries `container-type`, so it is also the ancestor the
+     * `@container` rule resolves against — which is why the grid has to be a separate
+     * element inside it rather than this one.
+     */
+    readonly root: "bce-block-twocolumn";
+    readonly grid: "bce-twocolumn-grid";
+    readonly gridReverse: "bce-twocolumn-grid-reverse";
+};
+/** Injects the block's CSS. Rendered by the block; emotion inserts it once. */
+export declare function TwoColumnStyles(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=twoColumnStyles.d.ts.map

package/dist/components/blocks/TwoColumn/twoColumnStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twoColumnStyles.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/TwoColumn/twoColumnStyles.tsx"],"names":[],"mappings":"AAiCA,eAAO,MAAM,gBAAgB;IAC3B;;;;OAIG;;;;CAIK,CAAA;AAqDV,+EAA+E;AAC/E,wBAAgB,eAAe,4CAE9B"}

package/dist/components/blocks/VideoBlock/VideoBlock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VideoBlock.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/VideoBlock/VideoBlock.tsx"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAY9D,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUtD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAe,EACf,QAAQ,EACR,SAAS,EACT,GAAG,EACH,IAAU,EACV,KAAgB,EAChB,WAAuB,GACxB,EAAE,eAAe,2CAoHjB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,IAAU,EACV,KAAgB,EAChB,WAAuB,GACxB,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,CAAC,CAAC,2CA4BlE"}
+{"version":3,"file":"VideoBlock.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/VideoBlock/VideoBlock.tsx"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAY9D,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUtD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAe,EACf,QAAQ,EACR,SAAS,EACT,GAAG,EACH,IAAU,EACV,KAAgB,EAChB,WAAuB,GACxB,EAAE,eAAe,2CAoHjB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,IAAU,EACV,KAAgB,EAChB,WAAuB,GACxB,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,GAAG,aAAa,CAAC,CAAC,2CA4BlE"}

package/dist/components/blocks/VideoBlock/createVideoBlock.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Registry entry factory for VideoBlock, registered under the wire name `VideoBlock` — that string is
+ * what stored documents contain, and renaming it orphans them. It owns strings, so the host supplies its
+ * `VideoBlockTranslations` here; anything omitted falls back to bundled English.
+ */
+export declare const createVideoBlock: (options: import('../../..').BlockFactoryOptions<import('./videoBlockTranslations').VideoBlockTranslations>) => import('../../..').BlockRegistryEntry<{
+    alt: string;
+    size: number;
+    source: "link" | "file";
+    align: "left" | "center" | "right";
+    asset_id: string;
+    cornerStyle?: "rounded" | "square" | undefined;
+    video_url?: string | undefined;
+}>;
+//# sourceMappingURL=createVideoBlock.d.ts.map

package/dist/components/blocks/VideoBlock/createVideoBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createVideoBlock.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/VideoBlock/createVideoBlock.ts"],"names":[],"mappings":"AAuBA;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;EAO3B,CAAA"}

package/dist/components/blocks/VideoBlock/index.d.ts

@@ -1,3 +1,5 @@
 export { VideoBlock, VideoBlockDragPreview } from './VideoBlock';
-export { RegisteredVideoBlockPropsSchema, VideoBlockDefaultProps } from './videoBlockPropsSchema';
+export { RegisteredVideoBlockPropsSchema, VideoBlockDefaultProps, type VideoSource, VideoSourceSchema, } from './videoBlockPropsSchema';
+export { createVideoBlock } from './createVideoBlock';
+export { VideoBlockEnglish, type VideoBlockTranslations } from './videoBlockTranslations';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/VideoBlock/index.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,+BAA+B,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/VideoBlock/index.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EACL,+BAA+B,EAC/B,sBAAsB,EACtB,KAAK,WAAW,EAChB,iBAAiB,GAClB,MAAM,yBAAyB,CAAA;AAGhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/components/blocks/VideoBlock/videoBlockTranslations.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Strings owned by the VideoBlock block. The host supplies these when it registers the
+ * block; anything it omits falls back to the English below.
+ */
+export interface VideoBlockTranslations {
+    /** Placeholder shown when a VideoBlock has no video (designer / empty link). */
+    videoBlockPlaceholder: string;
+    /** Announced while a VideoBlock's file is loading. */
+    videoBlockLoading: string;
+    /** Shown when a VideoBlock's video fails to load. */
+    videoBlockError: string;
+    /** Shown when a VideoBlock's link is not a supported provider. */
+    videoBlockUnsupportedProvider: string;
+    /** Heading shown while a VideoBlock's media is still processing. */
+    videoBlockProcessing: string;
+    /** Sub-message shown while a VideoBlock's media is still processing. */
+    videoBlockProcessingSubtitle: string;
+    /** Fallback iframe title when a VideoBlock has no alt text. */
+    videoBlockTitle: string;
+}
+/** English bundled with this package — also the source for `locales/en.json`. */
+export declare const VideoBlockEnglish: VideoBlockTranslations;
+//# sourceMappingURL=videoBlockTranslations.d.ts.map

package/dist/components/blocks/VideoBlock/videoBlockTranslations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"videoBlockTranslations.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/VideoBlock/videoBlockTranslations.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,gFAAgF;IAChF,qBAAqB,EAAE,MAAM,CAAA;IAC7B,sDAAsD;IACtD,iBAAiB,EAAE,MAAM,CAAA;IACzB,qDAAqD;IACrD,eAAe,EAAE,MAAM,CAAA;IACvB,kEAAkE;IAClE,6BAA6B,EAAE,MAAM,CAAA;IACrC,oEAAoE;IACpE,oBAAoB,EAAE,MAAM,CAAA;IAC5B,wEAAwE;IACxE,4BAA4B,EAAE,MAAM,CAAA;IACpC,+DAA+D;IAC/D,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,EAAE,sBAS/B,CAAA"}

package/dist/components/blocks/WidgetBlock/WidgetBlock.d.ts

@@ -0,0 +1,8 @@
+import { WidgetBlockProps } from './widgetBlockPropsSchema';
+/**
+ * Slot for a host-supplied widget. The block stores only an opaque `widgetType`
+ * and renders whatever the host's `useWidget` resolves it to — the widgets
+ * themselves, and the vocabulary naming them, stay with the host.
+ */
+export declare function WidgetBlock({ widgetType }: WidgetBlockProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WidgetBlock.d.ts.map

package/dist/components/blocks/WidgetBlock/WidgetBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetBlock.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/WidgetBlock/WidgetBlock.tsx"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAyChE;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,UAAe,EAAE,EAAE,gBAAgB,2CAkBhE"}

package/dist/components/blocks/WidgetBlock/WidgetErrorBoundary.d.ts

@@ -0,0 +1,36 @@
+import { Component, ReactNode } from 'react';
+interface WidgetErrorBoundaryProps {
+    /** Rendered in place of the widget once it has thrown. */
+    fallback: ReactNode;
+    children: ReactNode;
+}
+interface WidgetErrorBoundaryState {
+    hasError: boolean;
+}
+/**
+ * Contains the host's failures to the block they happen in — the widget's own render,
+ * and the `useWidget` that resolves it, since the caller keeps both below this
+ * boundary. A throwing component unmounts every ancestor up to the nearest boundary,
+ * so without one here a single broken widget or resolver blanks the whole editor or
+ * learner page.
+ *
+ * It is a page-saving guard, not error reporting: it catches nothing outside that
+ * subtree and reports nowhere, so a host that wants widget failures in its telemetry
+ * keeps its own boundary above the provider. Recovery is by remount — the caller keys this on
+ * `widgetType` — because a boundary cannot tell whether the thing that threw has
+ * since been fixed.
+ *
+ * Scope is React's: render, lifecycle and effect failures. A throw from an event
+ * handler or a rejected promise reaches no boundary — and unmounts nothing either,
+ * so it is not the failure this guards against.
+ *
+ * The only class component in the package: `getDerivedStateFromError` has no hook
+ * equivalent.
+ */
+export declare class WidgetErrorBoundary extends Component<WidgetErrorBoundaryProps, WidgetErrorBoundaryState> {
+    state: WidgetErrorBoundaryState;
+    static getDerivedStateFromError(): WidgetErrorBoundaryState;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=WidgetErrorBoundary.d.ts.map

package/dist/components/blocks/WidgetBlock/WidgetErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetErrorBoundary.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/WidgetBlock/WidgetErrorBoundary.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAEjD,UAAU,wBAAwB;IAChC,0DAA0D;IAC1D,QAAQ,EAAE,SAAS,CAAA;IACnB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,UAAU,wBAAwB;IAChC,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,mBAAoB,SAAQ,SAAS,CAChD,wBAAwB,EACxB,wBAAwB,CACzB;IACC,KAAK,EAAE,wBAAwB,CAAsB;IAErD,MAAM,CAAC,wBAAwB,IAAI,wBAAwB;IAI3D,MAAM,IAAI,SAAS;CAGpB"}

package/dist/components/blocks/WidgetBlock/createWidgetBlock.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Registry entry factory for WidgetBlock, registered under the wire name `WidgetBlock` — that
+ * string is what stored documents contain, and renaming it orphans them. It owns strings, so the
+ * host supplies its `WidgetBlockTranslations` here; anything omitted falls back to bundled English.
+ *
+ * This entry carries the package's open `widgetType`. A host that narrows it to its own widget
+ * names (see `index.ts`) also owns the entry's schema and defaults, so it builds its entry from
+ * `defineBlock` directly rather than calling this — passing `WidgetBlockEnglish` as `english`,
+ * which keeps the strings side identical.
+ */
+export declare const createWidgetBlock: (options: import('../../..').BlockFactoryOptions<import('./widgetBlockTranslations').WidgetBlockTranslations>) => import('../../..').BlockRegistryEntry<{
+    widgetType: string;
+}>;
+//# sourceMappingURL=createWidgetBlock.d.ts.map

package/dist/components/blocks/WidgetBlock/createWidgetBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createWidgetBlock.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/WidgetBlock/createWidgetBlock.ts"],"names":[],"mappings":"AAuBA;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB;;EAM5B,CAAA"}

package/dist/components/blocks/WidgetBlock/index.d.ts

@@ -0,0 +1,5 @@
+export { WidgetBlock } from './WidgetBlock';
+export { RegisteredWidgetBlockPropsSchema, WidgetBlockDefaultProps, WidgetBlockPropsSchema, } from './widgetBlockPropsSchema';
+export { createWidgetBlock } from './createWidgetBlock';
+export { WidgetBlockEnglish, type WidgetBlockTranslations } from './widgetBlockTranslations';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/WidgetBlock/index.ts"],"names":[],"mappings":"AAkDA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EACL,gCAAgC,EAChC,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,0BAA0B,CAAA;AAGjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/components/blocks/WidgetBlock/widgetBlockPropsSchema.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export declare const WidgetBlockPropsSchema: z.ZodObject<{
+    /**
+     * Opaque host widget identifier, resolved to a component via `useWidget`. Kept a
+     * free string on purpose: the widgets on offer belong to the host product, so a
+     * closed enum here would bind this package to one host's vocabulary. A host that
+     * wants its own set validated narrows this schema itself — see the block's
+     * `index.ts`. `''` means "not configured yet", as an empty `asset_id` does.
+     */
+    widgetType: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    widgetType: string;
+}, {
+    widgetType?: string | undefined;
+}>;
+export type WidgetBlockProps = z.infer<typeof WidgetBlockPropsSchema>;
+/**
+ * Defaults for an unconfigured block. A host that narrows `widgetType` to its own
+ * enum declares its own defaults instead: `''` is by construction not a member of
+ * that enum, so these would fail its stricter gate.
+ */
+export declare const WidgetBlockDefaultProps: WidgetBlockProps;
+export declare const RegisteredWidgetBlockPropsSchema: import('../../..').RegisteredComponentSchema<{
+    widgetType: string;
+}>;
+//# sourceMappingURL=widgetBlockPropsSchema.d.ts.map

package/dist/components/blocks/WidgetBlock/widgetBlockPropsSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgetBlockPropsSchema.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/WidgetBlock/widgetBlockPropsSchema.ts"],"names":[],"mappings":"AAmBA,OAAO,+BAA+B,CAAA;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,sBAAsB;IACjC;;;;;;OAMG;;;;;;EAEH,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAErE;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,gBAErC,CAAA;AAED,eAAO,MAAM,gCAAgC;;EAG5C,CAAA"}

package/dist/components/blocks/WidgetBlock/widgetBlockTranslations.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Strings owned by the WidgetBlock block. The host supplies these when it registers the
+ * block; anything it omits falls back to the English below.
+ *
+ * None of them name a widget: the vocabulary belongs to the host, so these describe the
+ * slot's state only.
+ */
+export interface WidgetBlockTranslations {
+    /** Placeholder shown in the designer when a WidgetBlock has no widget chosen. */
+    widgetBlockPlaceholder: string;
+    /** Shown while the host is resolving a WidgetBlock's widget. */
+    widgetBlockLoading: string;
+    /** Shown when the host cannot supply the requested widget. */
+    widgetBlockError: string;
+}
+/** English bundled with this package — also the source for `locales/en.json`. */
+export declare const WidgetBlockEnglish: WidgetBlockTranslations;
+//# sourceMappingURL=widgetBlockTranslations.d.ts.map

package/dist/components/blocks/WidgetBlock/widgetBlockTranslations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widgetBlockTranslations.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/WidgetBlock/widgetBlockTranslations.ts"],"names":[],"mappings":"AAkBA;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,iFAAiF;IACjF,sBAAsB,EAAE,MAAM,CAAA;IAC9B,gEAAgE;IAChE,kBAAkB,EAAE,MAAM,CAAA;IAC1B,8DAA8D;IAC9D,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,EAAE,uBAIhC,CAAA"}

package/dist/components/blocks/commonSchemas.d.ts

@@ -14,4 +14,17 @@ export type ColorTheme = z.infer<typeof ColorThemeSchema>;
 /** Semantic heading level for a block's heading region. Used by Banner and Accordion. */
 export declare const HeadingLevelSchema: z.ZodEnum<["h2", "h3", "h4"]>;
 export type HeadingLevel = z.infer<typeof HeadingLevelSchema>;
+/**
+ * Emphasis a block's *heading region* is filled with — the whole surface for Banner,
+ * the question band for KnowledgeCheck. Distinct from `ColorThemeSchema`: `none` is
+ * a transparent surface, and there is no un-branded `neutral` option.
+ */
+export declare const HeaderStyleSchema: z.ZodEnum<["none", "light", "dark"]>;
+export type HeaderStyle = z.infer<typeof HeaderStyleSchema>;
+/**
+ * Ships with the schema rather than being retyped per block: two copies of one sentence
+ * about one resolver (`getHeaderStyleStyling`) is how help text drifts from what the
+ * option actually renders. `light` is a brand-color fill, not a tint.
+ */
+export declare const HEADER_STYLE_HELP = "None: transparent; Light: brand color; Dark: dark surface \u2014 both with contrasting text";
 //# sourceMappingURL=commonSchemas.d.ts.map

package/dist/components/blocks/commonSchemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commonSchemas.d.ts","sourceRoot":"","sources":["../../../src/components/blocks/commonSchemas.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,kCAAgC,CAAA;AAC9D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D,gEAAgE;AAChE,eAAO,MAAM,WAAW,wCAAsC,CAAA;AAC9D,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAE/C;;;GAGG;AACH,eAAO,MAAM,gBAAgB,yCAAuC,CAAA;AACpE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEzD,yFAAyF;AACzF,eAAO,MAAM,kBAAkB,+BAA6B,CAAA;AAC5D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA"}
+{"version":3,"file":"commonSchemas.d.ts","sourceRoot":"","sources":["../../../src/components/blocks/commonSchemas.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,kCAAgC,CAAA;AAC9D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D,gEAAgE;AAChE,eAAO,MAAM,WAAW,wCAAsC,CAAA;AAC9D,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAE/C;;;GAGG;AACH,eAAO,MAAM,gBAAgB,yCAAuC,CAAA;AACpE,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEzD,yFAAyF;AACzF,eAAO,MAAM,kBAAkB,+BAA6B,CAAA;AAC5D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,sCAAoC,CAAA;AAClE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,gGAC4D,CAAA"}

package/dist/components/blocks/commonViewProps.d.ts

@@ -1,6 +1,7 @@
 import { View } from '@instructure/ui-view';
 import { ComponentProps } from 'react';
-import { Align } from './commonSchemas';
+import { Styling } from './brandTheming';
+import { Align, ColorTheme, HeaderStyle } from './commonSchemas';
 type ViewProps = ComponentProps<typeof View>;
 /** Horizontal alignment as a `View` `textAlign` token. */
 export declare const ALIGN_TEXT: Record<Align, NonNullable<ViewProps['textAlign']>>;
@@ -15,5 +16,26 @@ export interface MediaBlockViewProps {
     aspectRatio: string;
     borderRadius: NonNullable<ViewProps['borderRadius']>;
 }
+/**
+ * Styling for a block's heading region. `light`/`dark` are branded fills matching the
+ * requested tone; `none` is transparent, so it takes no brand color and leaves the
+ * text on whatever surface sits behind it.
+ */
+export declare function getHeaderStyleStyling(headerStyle: HeaderStyle, brandColor?: string): Styling;
+export interface ThemedContainer {
+    styling: Styling;
+    /**
+     * Whether the resolved surface is dark. InstUI derives a control's own colors from
+     * the theme, not from whatever it happens to be sitting on, so anything that has to
+     * contrast with *this* surface — a focus ring, a progress meter — needs telling.
+     */
+    isDarkSurface: boolean;
+}
+/**
+ * Container styling for a `colorTheme`, branded wherever the host supplies a color.
+ * `neutral` is deliberately un-branded, and a brand fill keeps the hairline that
+ * `brandFillStyling` would otherwise drop.
+ */
+export declare function getThemedContainerStyling(colorTheme: ColorTheme, brandColor?: string): ThemedContainer;
 export {};
 //# sourceMappingURL=commonViewProps.d.ts.map

package/dist/components/blocks/commonViewProps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commonViewProps.d.ts","sourceRoot":"","sources":["../../../src/components/blocks/commonViewProps.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAE5C,KAAK,SAAS,GAAG,cAAc,CAAC,OAAO,IAAI,CAAC,CAAA;AAE5C,0DAA0D;AAC1D,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAIzE,CAAA;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAA;IAC9C,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,WAAW,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAA;CACrD"}
+{"version":3,"file":"commonViewProps.d.ts","sourceRoot":"","sources":["../../../src/components/blocks/commonViewProps.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAC3C,OAAO,EAKL,KAAK,OAAO,EACb,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAErE,KAAK,SAAS,GAAG,cAAc,CAAC,OAAO,IAAI,CAAC,CAAA;AAE5C,0DAA0D;AAC1D,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAIzE,CAAA;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAA;IAC9C,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,WAAW,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAA;CACrD;AAwBD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAK5F;AAmBD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAA;CACvB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,UAAU,EACtB,UAAU,CAAC,EAAE,MAAM,GAClB,eAAe,CAiBjB"}

package/dist/components/blocks/richTextTableStyles.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Class name for containers that render sanitized RCE HTML. Blocks that opt
+ * in to table cell styling add this class to their `dangerouslySetInnerHTML`
+ * container. Currently used by Text; other rich-text blocks (Accordion,
+ * TabsBlock) can adopt it when table support is needed there.
+ */
+export declare const RICH_TEXT_CLASS = "bce-rich-text";
+/** Injects table cell styles for `.bce-rich-text` containers. Rendered per block that uses it. */
+export declare function RichTextTableStyles(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=richTextTableStyles.d.ts.map

package/dist/components/blocks/richTextTableStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"richTextTableStyles.d.ts","sourceRoot":"","sources":["../../../src/components/blocks/richTextTableStyles.tsx"],"names":[],"mappings":"AAoBA;;;;;GAKG;AACH,eAAO,MAAM,eAAe,kBAAkB,CAAA;AA+B9C,kGAAkG;AAClG,wBAAgB,mBAAmB,4CAElC"}

package/dist/contexts/BlockEditorApiContext.d.ts

@@ -1,3 +1,4 @@
+import { ComponentType } from 'react';
 /**
  * A resolved image asset. `url` is the direct, displayable file URL (rendered
  * in `<img>`); `undefined` while loading or on error.
@@ -25,8 +26,49 @@ export interface ResolvedVideo {
     isProcessing?: boolean;
     isError: boolean;
 }
+/** The props `WidgetBlock` renders a host widget with. */
+export interface WidgetComponentProps {
+    /**
+     * The identifier the block stored, handed back so one parameterised host component
+     * can serve several widget names. Without it such a host would have to wrap the
+     * component per name, and the natural wrapper is the fresh arrow the stability rule
+     * below forbids. Optional so a host whose widgets take no props stays assignable;
+     * the block always passes it. A *change* of name remounts the widget rather than
+     * updating it in place — a different name is a different widget — so such a
+     * component reads this once and never has to transition between widgets.
+     */
+    widgetType?: string;
+}
+/**
+ * A resolved widget. `Component` is the host's own component for the requested
+ * widget; `undefined` while loading or when the host does not recognise the
+ * identifier.
+ *
+ * `Component` must be a **stable reference** for a given `widgetType` — resolve it
+ * from a module-level map, not an arrow function built inside the hook. React
+ * remounts on component identity, so a fresh reference each render throws away
+ * whatever state the widget holds, on every render of the block.
+ *
+ * A widget that throws while rendering — or a `useWidget` that throws, which runs inside
+ * the same boundary — is contained to its own block, which shows the error placeholder
+ * in its place. That guard exists because the alternative is the
+ * whole page unmounting, not because the package can handle the failure: it catches
+ * only the widget and reports nowhere, so a host that wants widget failures in its
+ * telemetry keeps its own error boundary above the provider.
+ */
+export interface ResolvedWidget {
+    Component?: ComponentType<WidgetComponentProps>;
+    isLoading: boolean;
+    isError: boolean;
+}
 export type UseImageUrl = (assetId: string) => ResolvedImage;
 export type UseVideoUrl = (assetId: string) => ResolvedVideo;
+/**
+ * `widgetType` is an opaque host identifier, like an `assetId`: the package never
+ * owns the vocabulary of widget names, so an unrecognised one is an error result,
+ * not an invalid value.
+ */
+export type UseWidget = (widgetType: string) => ResolvedWidget;
 /**
  * The host-injected data hooks the blocks call to resolve an opaque `asset_id`
  * to the URL they render. The host owns the fetch (e.g. Canvas Files API via
@@ -44,15 +86,28 @@ export type UseVideoUrl = (assetId: string) => ResolvedVideo;
  * stable value).
  *
  * Calling unconditionally also means an unconfigured block passes an empty
- * `assetId`, so a hook must treat `''` as "nothing to resolve": don't fetch, and
- * report neither loading nor error (`{isLoading: false, isError: false}` with no
- * `url` — with react-query, `enabled: !!assetId`). The block ignores that result:
- * an unconfigured block renders the authoring placeholder inside the editor canvas
+ * identifier — `assetId`, or `widgetType` for `useWidget` — so a hook must treat
+ * `''` as "nothing to resolve": don't fetch, and report neither loading nor error
+ * (`{isLoading: false, isError: false}` with no `url`/`Component` — with
+ * react-query, `enabled: !!assetId`). The block ignores that result: an
+ * unconfigured block renders the authoring placeholder inside the editor canvas
  * and nothing outside it, so a hook that fetches for `''` only wastes a request.
+ *
+ * For any other identifier, though, a result that reports neither loading nor
+ * anything resolved reads as a failure: the blocks show the error placeholder. A hook
+ * that can sit idle for a real identifier (a query not yet enabled, say) must report
+ * `isLoading: true` until it settles, or the block flashes an error it will replace.
+ *
+ * A hook **reports** failure rather than raising it: `isError`, never a throw and never
+ * a suspend. `WidgetBlock` happens to run its hook inside its own error boundary, so a
+ * throw there degrades to the error placeholder instead of the page, but the other
+ * blocks have no such guard, and nothing here provides the `Suspense` a suspending hook
+ * needs (a react-query resolver wants `throwOnError: false` and a plain `useQuery`).
  */
 export interface BlockEditorApi {
     useImageUrl?: UseImageUrl;
     useVideoUrl?: UseVideoUrl;
+    useWidget?: UseWidget;
 }
 export declare const BlockEditorApiContext: import('react').Context<BlockEditorApi>;
 export declare const BlockEditorApiProvider: import('react').Provider<BlockEditorApi>;
@@ -60,4 +115,6 @@ export declare const BlockEditorApiProvider: import('react').Provider<BlockEdito
 export declare const useImageUrl: (assetId: string) => ResolvedImage;
 /** Resolve a video asset id via the host-provided `useVideoUrl` hook. */
 export declare const useVideoUrl: (assetId: string) => ResolvedVideo;
+/** Resolve a widget identifier to the host's component via the `useWidget` hook. */
+export declare const useWidget: (widgetType: string) => ResolvedWidget;
 //# sourceMappingURL=BlockEditorApiContext.d.ts.map

package/dist/contexts/BlockEditorApiContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlockEditorApiContext.d.ts","sourceRoot":"","sources":["../../src/contexts/BlockEditorApiContext.tsx"],"names":[],"mappings":"AAoBA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,OAAO,CAAA;IAClB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,aAAa,CAAA;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,aAAa,CAAA;AAE5D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAMD,eAAO,MAAM,qBAAqB,yCAAoC,CAAA;AAEtE,eAAO,MAAM,sBAAsB,0CAAiC,CAAA;AAEpE,0EAA0E;AAC1E,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,KAAG,aAG7C,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,KAAG,aAG7C,CAAA"}
+{"version":3,"file":"BlockEditorApiContext.d.ts","sourceRoot":"","sources":["../../src/contexts/BlockEditorApiContext.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,aAAa,EAA6B,MAAM,OAAO,CAAA;AAErE;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,OAAO,CAAA;IAClB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAA;IAC/C,SAAS,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,aAAa,CAAA;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,aAAa,CAAA;AAC5D;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,cAAc,CAAA;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAOD,eAAO,MAAM,qBAAqB,yCAAoC,CAAA;AAEtE,eAAO,MAAM,sBAAsB,0CAAiC,CAAA;AAEpE,0EAA0E;AAC1E,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,KAAG,aAG7C,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,KAAG,aAG7C,CAAA;AAED,oFAAoF;AACpF,eAAO,MAAM,SAAS,GAAI,YAAY,MAAM,KAAG,cAG9C,CAAA"}

package/dist/contexts/BlockTranslationsContext.d.ts

@@ -0,0 +1,47 @@
+import { ReactNode } from 'react';
+/**
+ * Strings for one block, supplied by the host when it registers that block
+ * (`create<Name>Block({ translations })`). Scoping them this way is what lets a host
+ * translate only the blocks it actually uses — an unregistered block never asks for
+ * anything.
+ */
+export type BlockTranslationValues = Record<string, string>;
+export interface BlockTranslationsProviderProps<T> {
+    value: T;
+    children: ReactNode;
+}
+/**
+ * Wraps a single block. Placed by `create<Name>Block`, not by the renderer, so every
+ * consumer — this package's viewer, a host's designer, or a bare `<Text />` — behaves the
+ * same.
+ */
+export declare function BlockTranslationsProvider<T extends AllStringValues<T>>({ value, children, }: BlockTranslationsProviderProps<T>): import("react/jsx-runtime").JSX.Element;
+/**
+ * "Every property is a string", expressed so that an `interface` satisfies it.
+ * `Record<string, string>` would not: an interface gets no implicit index signature, so
+ * every block's `<Name>Translations` — and every host block's — would be rejected.
+ */
+export type AllStringValues<T> = {
+    [K in keyof T]: string;
+};
+export interface BlockTranslations<T> {
+    /** Fully resolved strings — every key present, whatever the host supplied. */
+    translations: T;
+    /** Resolve a key and substitute its `%{…}` placeholders. */
+    translate: (key: keyof T & string, vars?: Record<string, unknown>) => string;
+}
+/**
+ * Resolves a block's strings: the English bundled with this package, overridden by
+ * whatever a `BlockTranslationsProvider` above supplies — which in practice is what the
+ * host passed to `create<Name>Block({ translations })`.
+ *
+ * The English fallback means a bare `<Text />` renders with no provider at all, so tests,
+ * stories and direct use need no setup, and a host that forgets a key degrades to English
+ * rather than showing a raw key.
+ *
+ * Nothing else is needed for strings the *package* owns outside any block (designer
+ * chrome, say): give them their own slice and call this hook with it. There is
+ * deliberately no separate "base translations" provider — this one already generalises.
+ */
+export declare function useBlockTranslations<T extends AllStringValues<T>>(fallback: T): BlockTranslations<T>;
+//# sourceMappingURL=BlockTranslationsContext.d.ts.map

package/dist/contexts/BlockTranslationsContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockTranslationsContext.d.ts","sourceRoot":"","sources":["../../src/contexts/BlockTranslationsContext.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAAiB,KAAK,SAAS,EAAuB,MAAM,OAAO,CAAA;AAE1E;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAI3D,MAAM,WAAW,8BAA8B,CAAC,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAA;IACR,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,eAAe,CAAC,CAAC,CAAC,EAAE,EACtE,KAAK,EACL,QAAQ,GACT,EAAE,8BAA8B,CAAC,CAAC,CAAC,2CAMnC;AAcD;;;;GAIG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM;CAAE,CAAA;AAE3D,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,8EAA8E;IAC9E,YAAY,EAAE,CAAC,CAAA;IACf,4DAA4D;IAC5D,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAA;CAC7E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,eAAe,CAAC,CAAC,CAAC,EAC/D,QAAQ,EAAE,CAAC,GACV,iBAAiB,CAAC,CAAC,CAAC,CAoBtB"}

package/dist/contexts/RichTextRendererContext.d.ts

@@ -0,0 +1,21 @@
+import { ReactNode } from 'react';
+/**
+ * Renders a rich-text HTML string into React nodes. A host injects one to run
+ * RCE-authored content through its own pipeline (e.g. Canvas file-link
+ * rewriting, inline file previews, media enhancement, MathJax) instead of the
+ * blocks' plain sanitized-HTML fallback.
+ *
+ * SECURITY: the renderer receives the **raw, unsanitized** HTML — the blocks do
+ * not sanitize on this path. A host that injects a renderer owns sanitization
+ * and MUST sanitize the html itself, or it opens an XSS hole.
+ */
+export type RichTextRenderer = (html: string) => ReactNode;
+/**
+ * The host's rich-text renderer, or `undefined` when none is provided — in which
+ * case the blocks fall back to `sanitizeHtml` + `dangerouslySetInnerHTML`. The
+ * host (e.g. a learner page) provides the value; consumers that don't need a
+ * custom pipeline (storybook, the designer, a bare render) leave it `undefined`.
+ */
+export declare const RichTextRendererContext: import('react').Context<RichTextRenderer | undefined>;
+export declare const useRichTextRenderer: () => RichTextRenderer | undefined;
+//# sourceMappingURL=RichTextRendererContext.d.ts.map

package/dist/contexts/RichTextRendererContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RichTextRendererContext.d.ts","sourceRoot":"","sources":["../../src/contexts/RichTextRendererContext.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAAiB,KAAK,SAAS,EAAc,MAAM,OAAO,CAAA;AAEjE;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAAA;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,uDAAyD,CAAA;AAE7F,eAAO,MAAM,mBAAmB,QAAO,gBAAgB,GAAG,SACrB,CAAA"}

package/dist/index.d.ts

@@ -5,9 +5,20 @@ export * from './components/blocks/Quote';
 export * from './components/blocks/CodeBlock';
 export * from './components/blocks/ImageBlock';
 export * from './components/blocks/VideoBlock';
-export { BlockEditorApiContext, BlockEditorApiProvider, useImageUrl, useVideoUrl, type BlockEditorApi, type ResolvedImage, type ResolvedVideo, type UseImageUrl, type UseVideoUrl, } from './contexts/BlockEditorApiContext';
+export * from './components/blocks/TabsBlock';
+export * from './components/blocks/FlashCards';
+export * from './components/blocks/MixAndMatch';
+export * from './components/blocks/KnowledgeCheck';
+export * from './components/blocks/LayoutContainer';
+export * from './components/blocks/TwoColumn';
+export * from './components/blocks/WidgetBlock';
+export { HeaderStyleSchema, type HeaderStyle } from './components/blocks/commonSchemas';
+export * from './registry';
+export * from './viewer';
+export { BlockTranslationsProvider, useBlockTranslations, type AllStringValues, type BlockTranslations, type BlockTranslationValues, } from './contexts/BlockTranslationsContext';
+export { BlockEditorApiContext, BlockEditorApiProvider, useImageUrl, useVideoUrl, useWidget, type BlockEditorApi, type ResolvedImage, type ResolvedVideo, type ResolvedWidget, type UseImageUrl, type UseVideoUrl, type UseWidget, type WidgetComponentProps, } from './contexts/BlockEditorApiContext';
 export { BrandColorContext, useBrandColor } from './contexts/BrandColorContext';
 export { DesignerModeContext, useDesignerMode } from './contexts/DesignerModeContext';
-export { TranslationsProvider, useTranslations, type BlockContentEditorTranslations, type BlockContentEditorTranslationsContext, type TranslateFunction, type TranslationsProviderProps, } from './contexts/TranslationsContext';
+export { RichTextRendererContext, useRichTextRenderer, type RichTextRenderer, } from './contexts/RichTextRendererContext';
 export * from './schema';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmBA,cAAc,+BAA+B,CAAA;AAC7C,cAAc,0BAA0B,CAAA;AACxC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,gCAAgC,CAAA;AAG9C,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,WAAW,EACX,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC/E,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AACrF,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,KAAK,8BAA8B,EACnC,KAAK,qCAAqC,EAC1C,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,GAC/B,MAAM,gCAAgC,CAAA;AAGvC,cAAc,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmBA,cAAc,+BAA+B,CAAA;AAC7C,cAAc,0BAA0B,CAAA;AACxC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,2BAA2B,CAAA;AACzC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,oCAAoC,CAAA;AAClD,cAAc,qCAAqC,CAAA;AACnD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iCAAiC,CAAA;AAI/C,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,mCAAmC,CAAA;AAGvF,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AAGxB,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,GAC5B,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,WAAW,EACX,WAAW,EACX,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,oBAAoB,GAC1B,MAAM,kCAAkC,CAAA;AACzC,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC/E,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AACrF,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,KAAK,gBAAgB,GACtB,MAAM,oCAAoC,CAAA;AAG3C,cAAc,UAAU,CAAA"}