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

package/README.md

@@ -0,0 +1,199 @@
+# @instructure/platform-block-content-editor
+
+Host-agnostic **block content editor** for the Canvas activity builder: the blocks, their schemas,
+the read path that renders a saved document, and the write path that authors one — all on native
+InstUI, with every Canvas coupling behind an injectable seam. Owned by **foundation**.
+
+This package ships **building blocks for rebuilding the editor, not a finished app.** There is one
+convenient composition (`BlockContentEditor`), but everything it does is reproducible from the
+exposed primitives, so a host can arrange the pieces however it needs (a tray or the preview in a
+modal, a custom toolbar, its own layout).
+
+> Deep design notes and invariants live in [`CLAUDE.md`](./CLAUDE.md); the block-authoring
+> conventions in the `bce-block-authoring` skill; architecture decisions in the repo's `docs/adr/`.
+> See [Documentation](#documentation) below.
+
+## Install
+
+```sh
+pnpm add @instructure/platform-block-content-editor
+```
+
+InstUI, React, and `zod` are **peer dependencies** — the host provides its single shared copy of
+each (see the `peerDependencies` in `package.json`).
+
+The package is **ESM-only** (`"type": "module"`, one `.` export plus `./locales/en.json`). Styles are
+emotion runtime-injected — there is **no `./styles` import**. There is also **no `PlatformUiProvider`**:
+BCE is host-agnostic through its own set of seam contexts (see [Seams](#seams--everything-canvas-specific-is-injected)),
+not a single umbrella provider. A minimal host can render `Viewer` / `BlockContentEditor` with just
+React, InstUI theming, and a composed registry.
+
+## The registry (both paths need it)
+
+There is deliberately **no default registry**: which blocks a document may contain is the host's
+decision. Compose one from the shipped block factories — the keys are the **wire format** stored in
+documents (`Header` → Banner, `QuoteBlock` → Quote, …):
+
+```tsx
+import { defineRegistry, createBannerBlock, createTextBlock } from '@instructure/platform-block-content-editor'
+
+const registry = defineRegistry({
+  Header: createBannerBlock({ label: t('Banner'), translations: {/* … */} }),
+  Text: createTextBlock({ label: t('Rich content editor'), translations: {/* … */} }),
+  // …the blocks this host offers, plus any host-owned blocks
+})
+```
+
+Compose with `defineRegistry(…)`; never annotate `: BlockRegistry` (it widens the type and silently
+collapses every derived type — see CLAUDE.md).
+
+## Read path — render a saved document
+
+```tsx
+import { Viewer } from '@instructure/platform-block-content-editor'
+
+<Viewer templateLayout={layout} templateData={data} componentRegistry={registry} />
+```
+
+`Viewer` emits no wrapper and takes no `theme`; host-specific typography belongs on the host's
+container. Unresolved blocks are reported via `onUnresolvedBlock`, never dropped or mutated.
+
+## Write path — author a document
+
+The **host owns the state engine** (so it owns save, undo/redo, dirty-tracking, and DB↔package
+conversion). Call `useBlockEditorState` and hand the result to the editor:
+
+```tsx
+import { useBlockEditorState, BlockContentEditor } from '@instructure/platform-block-content-editor'
+
+function Builder() {
+  const engine = useBlockEditorState({ initialData, initialLayout, registry, onDirty })
+
+  return (
+    <BlockContentEditor
+      engine={engine}
+      registry={registry}
+      tools={[widgetTray, aiAssistantTool]} // host-tool slot (optional)
+    />
+  )
+}
+```
+
+`BlockContentEditor` composes the tool-panel sidebar over the drag-and-drop canvas: it builds the
+registry-driven insertion trays, hoists a single DnD context so blocks can be **dragged** from a
+tray onto the canvas, coordinates canvas↔panel selection focus, and routes a selected block to its
+settings form. It is **authoring-only** — see Preview below.
+
+### Or compose the primitives yourself
+
+Every arrangement above is reproducible. Wrap your own layout in one `GridDndProvider` and drop a
+bare `DesignerCanvas` and the trays inside it (so tray drag reaches the canvas), or use the
+standalone `DesignerArea` (which self-wraps its own provider) when you don't need a shared context:
+
+```tsx
+import { GridDndProvider, DesignerCanvas, ComponentsTray, DesignerNavProvider } from '@instructure/platform-block-content-editor'
+
+<GridDndProvider {...dndProps}>
+  <DesignerNavProvider><ComponentsTray registry={registry} onAddComponent={engine.addComponent} /></DesignerNavProvider>
+  <DesignerCanvas canvasRef={canvasRef} {...canvasProps} />
+</GridDndProvider>
+```
+
+Also public: `DesignerSideBar` (the tool-panel chrome), `ComponentEditorForm` (the settings form),
+`useDesignerNav` (the sidebar's view-navigation hook), `useDesignerSelectionFocus`, and the
+block-level AI (`BlockAIMenu`, `useGenerateAltText`).
+
+## Preview — the host presents it
+
+`PreviewArea` is a framed student preview over the read-path `Viewer`, sized from a required,
+controlled `viewport` prop (`'desktop' | 'mobile'`). It renders no switch of its own — the host
+builds the Desktop/Mobile toggle and drives `viewport` from its own state. The package ships
+**no modal**: how the preview is presented (modal, drawer, fullscreen, inline) is the host's choice.
+
+```tsx
+import { PreviewArea, PREVIEW_VIEWPORTS, type PreviewViewport } from '@instructure/platform-block-content-editor'
+
+const [viewport, setViewport] = useState<PreviewViewport>(PREVIEW_VIEWPORTS.DESKTOP)
+
+<Modal open={previewing} onDismiss={…}>
+  <div role="group" aria-label="Preview viewport">
+    <Button onClick={() => setViewport(PREVIEW_VIEWPORTS.DESKTOP)}>Desktop</Button>
+    <Button onClick={() => setViewport(PREVIEW_VIEWPORTS.MOBILE)}>Mobile</Button>
+  </div>
+  <PreviewArea
+    templateLayout={engine.templateLayout}
+    templateData={engine.templateData}
+    componentRegistry={registry}
+    viewport={viewport}
+  />
+</Modal>
+```
+
+## Seams — everything Canvas-specific is injected
+
+Blocks and the editor read only from context; the host provides the implementations:
+
+| Context | What the host injects |
+| --- | --- |
+| `BrandColorContext` | the brand color (hex/`rgb()`), or `undefined` |
+| `BlockTranslationsProvider` | resolved strings per block + designer chrome (bundled English is the fallback) |
+| `RichTextRendererContext` | a renderer for RCE-authored HTML (read path); unset → sanitized fallback |
+| `RichTextEditorContext` | the RCE editor component (write path); unset → plain `TextArea` |
+| `AIActionContext` | the AI executor; **presence enables** the block-level AI, unset → hidden |
+| `BlockEditorApiProvider` | host data hooks — image/video/widget URLs and the settings-form file upload/delete |
+
+Each is host-agnostic: the host closes over Canvas course/plugin/file config **inside** its own
+hook/component; the package only ever passes opaque ids and reads back resolved values.
+
+### Wiring it up
+
+The canonical nesting a host provides (the order proven by the `consumer/index.tsx` reintegration
+fixture) — supply only the seams you use; each has a safe default:
+
+```tsx
+<BrandColorContext.Provider value={brandColor}>
+  <DesignerModeContext.Provider value={false}>
+    <BlockEditorApiProvider value={hostDataHooks}>        {/* image/video/widget + upload hooks */}
+      <RichTextRendererContext.Provider value={renderHtml}>
+        <RichTextEditorContext.Provider value={HostRceEditor}>
+          <AIActionContext.Provider value={executeAiToolUse}> {/* presence enables block-level AI */}
+            <BlockTranslationsProvider value={resolvedStrings}>
+              {/* <Viewer />, <BlockContentEditor />, <PreviewArea /> … */}
+            </BlockTranslationsProvider>
+          </AIActionContext.Provider>
+        </RichTextEditorContext.Provider>
+      </RichTextRendererContext.Provider>
+    </BlockEditorApiProvider>
+  </DesignerModeContext.Provider>
+</BrandColorContext.Provider>
+```
+
+## Reintegration gate
+
+The public surface is the contract a host compiles against. `pnpm check:consumer` builds `dist/` and
+type-checks the `consumer/` fixture against it, catching any exported inferred type that can't be
+named across the `exports` map (TS2742) — which the package's own `type-check` never sees. Add
+newly-exported symbols to `consumer/index.tsx`.
+
+## Development
+
+```sh
+pnpm --filter @instructure/platform-block-content-editor test        # vitest run
+pnpm --filter @instructure/platform-block-content-editor type-check  # tsc -p tsconfig.check.json
+pnpm --filter @instructure/platform-block-content-editor build       # vite build (+ .d.ts emit)
+pnpm --filter @instructure/platform-block-content-editor check:consumer  # the reintegration gate
+pnpm storybook                                                       # 21 stories: every block + the editor
+```
+
+Cross-package types resolve through built `dist/`, so run `pnpm build` once after a clone/pull
+before `type-check`/`test` (see the gotchas in `CLAUDE.md`). Storybook needs Node ≥ 22.12.
+
+## Documentation
+
+- **This README** — how to consume the package.
+- **`CLAUDE.md`** — what is true in `src/` right now: the read/write paths, the seams, the
+  non-negotiable invariants, and the build gotchas.
+- **`bce-block-authoring` skill** (`.claude/skills/`) — the conventions for creating or modifying a
+  block (styling, accessibility, the schema toolkit, per-block translations), loaded on demand.
+- **`docs/adr/`** (repo root) — architecture decision records; append-only.
+- **In-file comments** — reasoning local to one file, especially the block barrels and `src/schema/`.

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

@@ -1 +1 @@
-{"version":3,"file":"LayoutContainer.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/LayoutContainer/LayoutContainer.tsx"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAExE,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EAMR,kBAA6B,EAC7B,gBAA2B,EAC3B,MAAM,EACN,eAAwB,EACxB,UAAU,EACV,OAAO,EACP,UAAU,EACV,OAAO,EACP,KAAK,GACN,EAAE,oBAAoB,kDAqDtB"}
+{"version":3,"file":"LayoutContainer.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/LayoutContainer/LayoutContainer.tsx"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAA;AAExE,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EAMR,kBAA6B,EAC7B,gBAA2B,EAC3B,MAAM,EACN,eAAwB,EACxB,UAAU,EACV,OAAO,EACP,UAAU,EACV,OAAO,EACP,KAAK,GACN,EAAE,oBAAoB,kDAwDtB"}

package/dist/contexts/AIActionContext.d.ts

@@ -0,0 +1,38 @@
+/** The tool invocation the block-level AI affordances send to the host executor. */
+export interface AIToolUse {
+    toolUseId: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+/** One JSON content block of a tool result. */
+export interface AIToolResultJsonContent {
+    json: {
+        [key: string]: unknown;
+    };
+}
+/** One text content block of a tool result. */
+export interface AIToolResultTextContent {
+    text: string;
+}
+/** The result the host's executor resolves with. */
+export interface AIToolResult {
+    toolUseId: string;
+    content: AIToolResultJsonContent[] | AIToolResultTextContent[];
+    status: 'success' | 'error' | 'aborted';
+}
+/**
+ * The host's AI executor. The host closes over its own invocation context (Canvas course id,
+ * chat context, the ignite client) inside this function, so the package never sees them — it
+ * only sends a `toolUse` and reads back a `ToolResult`. `signal` is preserved so the block AI
+ * menu's Stop button can abort an in-flight request.
+ */
+export type AIAction = (toolUse: AIToolUse, signal?: AbortSignal) => Promise<AIToolResult>;
+/**
+ * The host's AI executor, or `undefined` when none is provided — in which case every block-level
+ * AI affordance (the per-block AI menu, the "Generate alt text" button) renders nothing. This is
+ * the renderer-seam twin of `RichTextRendererContext`, and it replaces the source's `isAiEnabled`
+ * gate: presence of the seam *is* the enablement.
+ */
+export declare const AIActionContext: import('react').Context<AIAction | undefined>;
+export declare const useAIAction: () => AIAction | undefined;
+//# sourceMappingURL=AIActionContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AIActionContext.d.ts","sourceRoot":"","sources":["../../src/contexts/AIActionContext.tsx"],"names":[],"mappings":"AAoBA,oFAAoF;AACpF,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,+CAA+C;AAC/C,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;CACjC;AAED,+CAA+C;AAC/C,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAA;CACb;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,uBAAuB,EAAE,GAAG,uBAAuB,EAAE,CAAA;IAC9D,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;CACxC;AAED;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;AAE1F;;;;;GAKG;AACH,eAAO,MAAM,eAAe,+CAAiD,CAAA;AAE7E,eAAO,MAAM,WAAW,QAAO,QAAQ,GAAG,SAAwC,CAAA"}

package/dist/contexts/BlockEditorApiContext.d.ts

@@ -69,6 +69,68 @@ export type UseVideoUrl = (assetId: string) => ResolvedVideo;
  * not an invalid value.
  */
 export type UseWidget = (widgetType: string) => ResolvedWidget;
+/**
+ * A resolved uploaded file, as the settings-form uploaders need it for their *preview*
+ * (not the block's rendered/embed URL — that's `useImageUrl`/`useVideoUrl`). `url` is the
+ * displayable file URL; `displayName` labels the preview. For a video still processing,
+ * `mediaEntryId` may be absent and `isProcessing` true. `undefined`/false flags with a
+ * populated `url` means "ready".
+ */
+export interface ResolvedUploadedFile {
+    url?: string;
+    displayName?: string;
+    mediaEntryId?: string;
+    isLoading: boolean;
+    isProcessing?: boolean;
+    isError: boolean;
+}
+/** Resolve an `asset_id` to its uploaded-file preview data. `''` = nothing to resolve. */
+export type UseUploadedFile = (assetId: string) => ResolvedUploadedFile;
+/** Arguments the uploader hands the host's create-file mutation. */
+export interface CreateFileArgs {
+    file: File;
+    displayName?: string;
+}
+/**
+ * The host's file-upload mutation. The package passes only `{ file, displayName }` and
+ * stores the returned `id` as the block's `asset_id`; all host scoping (course/account,
+ * folder resolution, entity type) lives inside the host's implementation. `upload` rejects
+ * on failure — the uploader catches and surfaces an error message.
+ */
+export interface CreateFileHandle {
+    upload: (args: CreateFileArgs) => Promise<{
+        id: string;
+    }>;
+    isUploading: boolean;
+    error?: unknown;
+}
+export type UseCreateFile = () => CreateFileHandle;
+/** Arguments the host's delete-file mutation takes — a single stored asset id. */
+export interface DeleteFileArgs {
+    fileId: string;
+}
+/**
+ * The host's file-delete mutation, for cleaning up an asset a block no longer references.
+ * Unprovided, deletion is a silent no-op (cleanup is best-effort), rather than an error.
+ */
+export interface DeleteFileHandle {
+    deleteFile: (args: DeleteFileArgs) => Promise<void>;
+}
+export type UseDeleteFile = () => DeleteFileHandle;
+/** Arguments the host's asset-bytes fetch takes — a single stored asset id. */
+export interface FetchAssetArgs {
+    assetId: string;
+}
+/**
+ * The host's asset-bytes fetch: reads a stored `asset_id` back to a `Blob` on the host's own
+ * transport (credentials/CSRF/telemetry), so the package never fetches host content directly. The
+ * alt-text generator uses it to obtain the image bytes it sends to the AI. `fetchAsset` rejects on
+ * failure — the caller catches and surfaces an error message.
+ */
+export interface FetchAssetHandle {
+    fetchAsset: (args: FetchAssetArgs) => Promise<Blob>;
+}
+export type UseFetchAsset = () => FetchAssetHandle;
 /**
  * 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
@@ -108,6 +170,14 @@ export interface BlockEditorApi {
     useImageUrl?: UseImageUrl;
     useVideoUrl?: UseVideoUrl;
     useWidget?: UseWidget;
+    /** Resolve a stored `asset_id` to preview data for the settings-form uploaders. */
+    useUploadedFile?: UseUploadedFile;
+    /** The host's file-upload mutation, driving the settings-form uploaders. */
+    useCreateFile?: UseCreateFile;
+    /** The host's file-delete mutation, for cleaning up orphaned uploads. */
+    useDeleteFile?: UseDeleteFile;
+    /** The host's asset-bytes fetch, reading a stored `asset_id` to a `Blob` for the alt-text AI. */
+    useFetchAsset?: UseFetchAsset;
 }
 export declare const BlockEditorApiContext: import('react').Context<BlockEditorApi>;
 export declare const BlockEditorApiProvider: import('react').Provider<BlockEditorApi>;
@@ -117,4 +187,12 @@ export declare const useImageUrl: (assetId: string) => ResolvedImage;
 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;
+/** Resolve an uploaded file's preview data via the host-provided `useUploadedFile` hook. */
+export declare const useUploadedFile: (assetId: string) => ResolvedUploadedFile;
+/** Obtain the host's file-upload mutation via the `useCreateFile` hook. */
+export declare const useCreateFile: () => CreateFileHandle;
+/** Obtain the host's file-delete mutation via the `useDeleteFile` hook. */
+export declare const useDeleteFile: () => DeleteFileHandle;
+/** Obtain the host's asset-bytes fetch via the `useFetchAsset` hook. */
+export declare const useFetchAsset: () => FetchAssetHandle;
 //# 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":"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"}
+{"version":3,"file":"BlockEditorApiContext.d.ts","sourceRoot":"","sources":["../../src/contexts/BlockEditorApiContext.tsx"],"names":[],"mappings":"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"}

package/dist/contexts/RichTextEditorContext.d.ts

@@ -0,0 +1,28 @@
+import { ComponentType } from 'react';
+/**
+ * The props the settings form hands a host-injected rich-text *editor* — the write-path
+ * twin of `RichTextRendererContext`'s read-path renderer. The contract is deliberately
+ * host-agnostic: host-specific wiring (Canvas course/context, RCE plugin config, JWT) is
+ * closed over by the host inside its own component, never passed across this seam.
+ */
+export interface RichTextEditorProps {
+    /** Current HTML value. */
+    value: string;
+    /** Called with the new HTML whenever the editor's content changes. */
+    onChange: (html: string) => void;
+    /** Accessible label for the editor's textarea. */
+    label: string;
+    /** Stable id for the editor's textarea, derived from the field name. */
+    id: string;
+    /** Optional editor height (CSS length), e.g. `"400px"`. */
+    height?: string;
+}
+export type RichTextEditorComponent = ComponentType<RichTextEditorProps>;
+/**
+ * The host's rich-text editor, or `undefined` when none is provided — in which case the
+ * settings form falls back to a plain `TextArea`. A host (e.g. Canvas) injects its own RCE
+ * here; stories, tests and hosts without an editor leave it `undefined`.
+ */
+export declare const RichTextEditorContext: import('react').Context<RichTextEditorComponent | undefined>;
+export declare const useRichTextEditor: () => RichTextEditorComponent | undefined;
+//# sourceMappingURL=RichTextEditorContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RichTextEditorContext.d.ts","sourceRoot":"","sources":["../../src/contexts/RichTextEditorContext.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,aAAa,EAA6B,MAAM,OAAO,CAAA;AAErE;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,sEAAsE;IACtE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAA;IACb,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAA;IACV,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,MAAM,uBAAuB,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAA;AAExE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,8DAAgE,CAAA;AAElG,eAAO,MAAM,iBAAiB,QAAO,uBAAuB,GAAG,SAC5B,CAAA"}

package/dist/editor/BlockContentEditor.d.ts

@@ -0,0 +1,43 @@
+import { BlockRegistry } from '../registry';
+import { Tool } from './sidebar/panel/types';
+import { UseBlockEditorStateReturn } from './state/useBlockEditorState';
+/** The trays the package ships. A host appends its own tools (widget tray, AI assistant). */
+export declare const BUILT_IN_TOOL_IDS: readonly ["components", "interactive", "layout", "templates"];
+export type BuiltInToolId = (typeof BUILT_IN_TOOL_IDS)[number];
+export interface BlockContentEditorProps<HostToolId extends string = never> {
+    /** The host-owned editor state (from `useBlockEditorState`). The host keeps save / undo /
+     * dirty / DB↔package conversion; this component only composes the authoring UI over it. */
+    engine: UseBlockEditorStateReturn;
+    /** The registry the document's blocks resolve against (same one passed to `useBlockEditorState`). */
+    registry: BlockRegistry;
+    /** Host tools — the host-tool slot (a widget tray, the IgniteAI Assistant). Rendered
+     * alongside the built-ins in one rail; the built-ins carry `priority` 0-3, so a host tool
+     * with no `priority` set renders after all four (e.g. a widget tray), while one that sets a
+     * lower `priority` renders before them (e.g. an Assistant docked at the top of the rail).
+     * Block-level AI is gated on the `AIAction` seam, not on a tool. */
+    tools?: Tool<HostToolId>[];
+    /** Which built-in trays to render, as a subset of `BUILT_IN_TOOL_IDS`; defaults to all four.
+     * Rendered in the canonical order regardless of the order given (e.g. a dashboard passes
+     * `['components', 'layout']`). */
+    builtInToolIds?: BuiltInToolId[];
+    /** The tool open on first render. Defaults to the first rendered built-in tray (`components`
+     * unless excluded), then the first host tool. */
+    initialToolId?: BuiltInToolId | HostToolId;
+    /** Panel height; forwarded to `DesignerSideBar` (defaults to `100%`). */
+    height?: number | string;
+    /** Shows the sidebar's rail collapse/expand toggle once a tool has been opened. */
+    hasExpandPanelButton?: boolean;
+}
+/**
+ * The authoring editor: the tool-panel sidebar over the drag-and-drop canvas, wired to the
+ * host's state engine. It is one convenient composition of the package's primitives — a host
+ * that needs a different arrangement (the sidebar in a modal, a custom layout) composes
+ * `GridDndProvider` + `DesignerSideBar` + `DesignerCanvas` itself; nothing here is required.
+ *
+ * It holds only the panel's view/tool UI state; the document, selection, and history live in
+ * the `engine` the host owns. One shared `GridDndProvider` wraps both surfaces so tray drag
+ * sources reach the canvas droppables. It is authoring-only — the student preview
+ * (`PreviewArea`) is a separate export the host presents however it wants.
+ */
+export declare function BlockContentEditor<HostToolId extends string = never>({ engine, registry, tools: hostTools, builtInToolIds, initialToolId, height, hasExpandPanelButton, }: BlockContentEditorProps<HostToolId>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=BlockContentEditor.d.ts.map

package/dist/editor/BlockContentEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockContentEditor.d.ts","sourceRoot":"","sources":["../../src/editor/BlockContentEditor.tsx"],"names":[],"mappings":"AA4BA,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,aAAa,CAAA;AAOnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAA;AAQjD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAE5E,6FAA6F;AAC7F,eAAO,MAAM,iBAAiB,+DAAgE,CAAA;AAC9F,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAmC9D,MAAM,WAAW,uBAAuB,CAAC,UAAU,SAAS,MAAM,GAAG,KAAK;IACxE;+FAC2F;IAC3F,MAAM,EAAE,yBAAyB,CAAA;IACjC,qGAAqG;IACrG,QAAQ,EAAE,aAAa,CAAA;IACvB;;;;wEAIoE;IACpE,KAAK,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAA;IAC1B;;sCAEkC;IAClC,cAAc,CAAC,EAAE,aAAa,EAAE,CAAA;IAChC;qDACiD;IACjD,aAAa,CAAC,EAAE,aAAa,GAAG,UAAU,CAAA;IAC1C,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,mFAAmF;IACnF,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,SAAS,MAAM,GAAG,KAAK,EAAE,EACpE,MAAM,EACN,QAAQ,EACR,KAAK,EAAE,SAAS,EAChB,cAAuC,EACvC,aAAa,EACb,MAAM,EACN,oBAAoB,GACrB,EAAE,uBAAuB,CAAC,UAAU,CAAC,2CA8NrC"}

package/dist/editor/ai/BlockAIMenu.d.ts

@@ -0,0 +1,17 @@
+import { BlockRegistry } from '../../registry';
+export interface BlockAIMenuProps {
+    componentType: string;
+    componentData: Record<string, unknown>;
+    /** Component instance ID, used to pick the edited entry from the AI's response. */
+    componentId?: string;
+    isOpen: boolean;
+    onOpen: () => void;
+    onApply: (newProps: Record<string, unknown>) => void;
+    onClose: () => void;
+    /** Composed by the host — needed to render the before/after preview and to resolve the block. */
+    componentRegistry: BlockRegistry;
+    /** Fires when the menu popover OR the preview modal is open, so the canvas can hold selection. */
+    onActiveChange?: (active: boolean) => void;
+}
+export declare const BlockAIMenu: ({ componentType, componentData, componentId, isOpen, onOpen, onApply, onClose, componentRegistry, onActiveChange, }: BlockAIMenuProps) => import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=BlockAIMenu.d.ts.map

package/dist/editor/ai/BlockAIMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockAIMenu.d.ts","sourceRoot":"","sources":["../../../src/editor/ai/BlockAIMenu.tsx"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,aAAa,EAA4B,MAAM,gBAAgB,CAAA;AAQ7E,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACtC,mFAAmF;IACnF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IACpD,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,iGAAiG;IACjG,iBAAiB,EAAE,aAAa,CAAA;IAChC,kGAAkG;IAClG,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA;CAC3C;AAED,eAAO,MAAM,WAAW,GAAI,qHAUzB,gBAAgB,mDAkIlB,CAAA"}

package/dist/editor/ai/BlockAIMenuContent.d.ts

@@ -0,0 +1,17 @@
+export type MenuView = 'root' | 'prompt' | 'change-tone' | 'change-length' | 'change-reading-level';
+export interface BlockAIMenuContentProps {
+    view: MenuView;
+    onSetView: (view: MenuView) => void;
+    onQuickAction: (instruction: string) => void;
+    activeInstruction?: string | null;
+    prompt: string;
+    onPromptChange: (value: string) => void;
+    isThinking: boolean;
+    error?: string | null;
+    previewFirst: boolean;
+    onPreviewFirstChange: (value: boolean) => void;
+    onSend: () => void;
+    onStop: () => void;
+}
+export declare const BlockAIMenuContent: ({ view, onSetView, onQuickAction, activeInstruction, prompt, onPromptChange, isThinking, error, previewFirst, onPreviewFirstChange, onSend, onStop, }: BlockAIMenuContentProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=BlockAIMenuContent.d.ts.map

package/dist/editor/ai/BlockAIMenuContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlockAIMenuContent.d.ts","sourceRoot":"","sources":["../../../src/editor/ai/BlockAIMenuContent.tsx"],"names":[],"mappings":"AAsCA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,GAAG,eAAe,GAAG,sBAAsB,CAAA;AAkDnG,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,QAAQ,CAAA;IACd,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;IACnC,aAAa,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5C,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAEjC,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,UAAU,EAAE,OAAO,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,YAAY,EAAE,OAAO,CAAA;IACrB,oBAAoB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAC9C,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAED,eAAO,MAAM,kBAAkB,GAAI,uJAahC,uBAAuB,4CAyLzB,CAAA"}

package/dist/editor/ai/PreviewBlockModal.d.ts

@@ -0,0 +1,29 @@
+import { BlockRegistry, LayoutNode, TemplateData, UnresolvedBlock } from '../../registry';
+export interface PreviewBlockModalProps {
+    open: boolean;
+    onClose: () => void;
+    onReplace: () => void;
+    onRegenerate: (refinementText: string) => void;
+    isRegenerating?: boolean;
+    /** FOUND-62: the refinement/regenerate field is hidden by default. */
+    showRefinement?: boolean;
+    beforeLayout: LayoutNode[];
+    beforeData?: TemplateData;
+    afterLayout: LayoutNode[];
+    afterData?: TemplateData;
+    /** Composed by the host — same contract as `Viewer`; renders both diff panels. */
+    componentRegistry: BlockRegistry;
+    /** Forwarded to both `Viewer`s. */
+    onUnresolvedBlock?: (block: UnresolvedBlock) => void;
+}
+/**
+ * A fullscreen before/after diff of an AI-proposed block change: the current block ("Before")
+ * beside the AI's version ("After"), a Both/After/Before switch, an optional refinement field,
+ * and Cancel / Accept-and-replace. The two panels are the read-path `Viewer` run with designer
+ * mode off (so blocks show their student state), reached through the modal portal — brand color,
+ * translations and host data hooks come from the host's providers above, as everywhere else. The
+ * source's IgniteAI gradient is dropped for a neutral, themeable surface; the AI accent is the
+ * colored icon in the header.
+ */
+export declare const PreviewBlockModal: ({ open, onClose, onReplace, onRegenerate, isRegenerating, showRefinement, beforeLayout, beforeData, afterLayout, afterData, componentRegistry, onUnresolvedBlock, }: PreviewBlockModalProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PreviewBlockModal.d.ts.map

package/dist/editor/ai/PreviewBlockModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreviewBlockModal.d.ts","sourceRoot":"","sources":["../../../src/editor/ai/PreviewBlockModal.tsx"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAS9F,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,YAAY,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9C,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,sEAAsE;IACtE,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,YAAY,EAAE,UAAU,EAAE,CAAA;IAC1B,UAAU,CAAC,EAAE,YAAY,CAAA;IACzB,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,SAAS,CAAC,EAAE,YAAY,CAAA;IACxB,kFAAkF;IAClF,iBAAiB,EAAE,aAAa,CAAA;IAChC,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;CACrD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAAI,qKAa/B,sBAAsB,4CA4KxB,CAAA"}

package/dist/editor/ai/aiMenuStyles.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The block-level AI menu's chrome CSS: the popover card, its interactive menu-item rows
+ * (hover/focus/disabled) and the free-text prompt row. None of it is expressible in InstUI
+ * props — it needs `:hover`/`:focus-visible`/`:disabled` states and a borderless input — so it
+ * is injected once as a global stylesheet keyed by stable class names, the same way the canvas
+ * and preview chrome are. The source's `theme.gradients.igniteAI` branding is neutralized to
+ * plain InstUI surface tokens; the AI accent lives in the colored AI icon on the trigger.
+ */
+export declare const AI_CLASS: {
+    readonly root: "bce-ai-menu-root";
+    readonly card: "bce-ai-menu-card";
+    readonly list: "bce-ai-menu-list";
+    readonly item: "bce-ai-menu-item";
+    readonly itemLabel: "bce-ai-menu-item-label";
+    readonly subHeader: "bce-ai-menu-subheader";
+    readonly input: "bce-ai-menu-input";
+    readonly footer: "bce-ai-menu-footer";
+    readonly thinkingBody: "bce-ai-menu-thinking";
+    readonly thinkingStatus: "bce-ai-menu-thinking-status";
+};
+/** Mounts the AI menu chrome stylesheet once, under the menu popover. */
+export declare function AIMenuStyles(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=aiMenuStyles.d.ts.map

package/dist/editor/ai/aiMenuStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiMenuStyles.d.ts","sourceRoot":"","sources":["../../../src/editor/ai/aiMenuStyles.tsx"],"names":[],"mappings":"AAoBA;;;;;;;GAOG;AAEH,eAAO,MAAM,QAAQ;;;;;;;;;;;CAWX,CAAA;AAmBV,yEAAyE;AACzE,wBAAgB,YAAY,4CA+G3B"}

package/dist/editor/ai/aiTranslations.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Strings the package owns for the block-level AI chrome — the per-block AI menu, the
+ * before/after preview, and the "Generate alt text" affordance. Consumed via
+ * `useBlockTranslations(DesignerAIEnglish)`, the same mechanism blocks use; there is
+ * deliberately no second translation context. The host overrides by placing a
+ * `BlockTranslationsProvider` above the editor; anything it omits falls back to the English
+ * below. Bundled English is intentionally product-neutral ("AI", not a brand name) — a host
+ * brands it through its own translations.
+ *
+ * Only the visible labels/chrome live here. The *instruction* strings the menu sends to the AI
+ * (e.g. "Make the tone more formal") are model prompts, not UI copy, so they stay as literals in
+ * `BlockAIMenuContent` and are not translated.
+ */
+export interface DesignerAITranslations {
+    /** Accessible label for the AI menu trigger on a block. `%{componentType}` is the block name. */
+    aiAssistFor: string;
+    /** Tooltip on the AI menu trigger. */
+    aiActions: string;
+    /** Back link from a submenu to the root menu. */
+    backToMenu: string;
+    /** Root action + prompt-view header: open a free-text regenerate prompt. */
+    regenerateWithPrompt: string;
+    /** Root action: open the tone submenu. */
+    changeTone: string;
+    /** Root action: open the length submenu. */
+    changeLength: string;
+    /** Root action: open the reading-level submenu. */
+    changeReadingLevel: string;
+    /** Tone submenu item labels. */
+    toneMoreFormal: string;
+    toneMoreFun: string;
+    toneMoreCasual: string;
+    toneMoreTechnical: string;
+    /** Length submenu item labels. */
+    lengthShorter: string;
+    lengthLonger: string;
+    /** Reading-level submenu item labels. */
+    readingBeginning: string;
+    readingNovice: string;
+    readingIntermediate: string;
+    readingAdvanced: string;
+    /** Prompt input label/placeholder. */
+    promptPlaceholder: string;
+    /** Toggle: show the before/after preview before applying. */
+    previewFirst: string;
+    /** Send the prompt. */
+    send: string;
+    /** In-flight status while the AI generates. */
+    thinking: string;
+    /** Stop an in-flight generation. */
+    stop: string;
+    /** Error shown in the AI menu when a generation fails or returns nothing usable. */
+    generationFailed: string;
+    /** Preview modal title. */
+    previewBlock: string;
+    /** Accessible group label for the Both/After/Before comparison switch. */
+    compareLabel: string;
+    /** Comparison switch options + panel headings. */
+    both: string;
+    before: string;
+    after: string;
+    /** Preview modal buttons. */
+    previewCancel: string;
+    acceptAndReplace: string;
+    /** Refinement field label/placeholder + its buttons (field hidden by default). */
+    refinementPlaceholder: string;
+    regenerate: string;
+    regenerating: string;
+    /** "Generate alt text" affordance on the alt-text field. */
+    generateAltText: string;
+    generating: string;
+    /** Errors surfaced by the alt-text affordance. */
+    failedToLoadImage: string;
+    failedToGenerate: string;
+    noDescription: string;
+}
+/** English bundled with this package — also the source for `locales/en.json`. */
+export declare const DesignerAIEnglish: DesignerAITranslations;
+//# sourceMappingURL=aiTranslations.d.ts.map

package/dist/editor/ai/aiTranslations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiTranslations.d.ts","sourceRoot":"","sources":["../../../src/editor/ai/aiTranslations.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,sBAAsB;IACrC,iGAAiG;IACjG,WAAW,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,oBAAoB,EAAE,MAAM,CAAA;IAC5B,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAA;IACpB,mDAAmD;IACnD,kBAAkB,EAAE,MAAM,CAAA;IAC1B,gCAAgC;IAChC,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,CAAA;IACzB,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAA;IACpB,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,eAAe,EAAE,MAAM,CAAA;IACvB,sCAAsC;IACtC,iBAAiB,EAAE,MAAM,CAAA;IACzB,6DAA6D;IAC7D,YAAY,EAAE,MAAM,CAAA;IACpB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAA;IAChB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,oFAAoF;IACpF,gBAAgB,EAAE,MAAM,CAAA;IACxB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAA;IACpB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,kFAAkF;IAClF,qBAAqB,EAAE,MAAM,CAAA;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,4DAA4D;IAC5D,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,iBAAiB,EAAE,MAAM,CAAA;IACzB,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED,iFAAiF;AACjF,eAAO,MAAM,iBAAiB,EAAE,sBAuC/B,CAAA"}