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

package/dist/editor/sidebar/form/formTranslations.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Strings the package owns for the settings form (the schema-driven block editor). Consumed
+ * via `useBlockTranslations(DesignerFormEnglish)`, the same mechanism blocks and the designer
+ * chrome use; the host overrides by placing a `BlockTranslationsProvider` above the sidebar.
+ *
+ * `%{name}` markers are interpolated by `translate('<key>', { … })`.
+ */
+export interface DesignerFormTranslations {
+    /** Array-item paging: previous button. */
+    previous: string;
+    /** Array-item paging: next button. */
+    next: string;
+    /** Array-item title/subtitle, e.g. "Accordion 2". Interpolates `%{itemName}` and `%{number}`. */
+    itemSubtitle: string;
+    /** Fallback noun for an array item with no configured name. */
+    defaultItemName: string;
+    /** Drag-handle screen-reader label for an array item. */
+    dragToReorderItem: string;
+    /** Edit-button screen-reader label for an array item. */
+    editItem: string;
+    /** Remove-button screen-reader label for an array item. */
+    removeItem: string;
+    /** Manage-layer collapse row label, e.g. "Manage Accordions". */
+    manageLabel: string;
+    /** Manage-layer collapse row count, e.g. "6 Accordions". */
+    countLabel: string;
+    /** Empty-state text for an array-of-objects field. */
+    noItemsYet: string;
+    /** Add-button label for an array-of-objects field, e.g. "Add accordion". */
+    addItem: string;
+    /** True/false question: the True answer label. */
+    answerTrue: string;
+    /** True/false question: the False answer label. */
+    answerFalse: string;
+    /** Multiple-choice answer label, e.g. "Option A". */
+    optionLabel: string;
+    /** Multiple-choice answer remove-button screen-reader label. */
+    removeOption: string;
+    /** Multiple-choice add-answer button. */
+    addOption: string;
+    /** Primitive string-array item label, e.g. "Item 1". */
+    arrayItemLabel: string;
+    /** Primitive string-array item remove button. */
+    remove: string;
+    /** Primitive string-array add button. */
+    addPrimitiveItem: string;
+    /** File-drop zone secondary instruction. */
+    dragAndDropOrBrowse: string;
+    /** File-drop zone button. */
+    chooseFile: string;
+    /** Shown while an existing asset's preview is loading. */
+    loadingPreview: string;
+    /** Generic upload-failure message. */
+    uploadFailed: string;
+    /** Image uploader: drop-zone heading. */
+    uploadImage: string;
+    /** Image uploader: accepted types line. */
+    imageAcceptedTypes: string;
+    /** Image uploader: max-size line. */
+    imageMaxSize: string;
+    /** Image uploader: replace-button screen-reader label. */
+    replaceImage: string;
+    /** Image uploader: uploading state. */
+    uploadingImage: string;
+    /** Image uploader: over-size error. */
+    imageSizeError: string;
+    /** Video uploader: drop-zone heading. */
+    uploadVideo: string;
+    /** Video uploader: accepted types line. */
+    videoAcceptedTypes: string;
+    /** Video uploader: max-size line. */
+    videoMaxSize: string;
+    /** Video uploader: replace-button screen-reader label. */
+    replaceVideo: string;
+    /** Video uploader: uploading state. */
+    uploadingVideo: string;
+    /** Video uploader: over-size error. */
+    videoSizeError: string;
+    /** Video uploader: source toggle label. */
+    videoSource: string;
+    /** Video uploader: file source option. */
+    sourceFile: string;
+    /** Video uploader: link source option. */
+    sourceLink: string;
+    /** Video uploader: link input label. */
+    videoLink: string;
+    /** Video uploader: link input placeholder. */
+    videoLinkPlaceholder: string;
+}
+/** English bundled with this package — also the source for `locales/en.json`. */
+export declare const DesignerFormEnglish: DesignerFormTranslations;
+//# sourceMappingURL=formTranslations.d.ts.map

package/dist/editor/sidebar/form/formTranslations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formTranslations.d.ts","sourceRoot":"","sources":["../../../../src/editor/sidebar/form/formTranslations.ts"],"names":[],"mappings":"AAkBA;;;;;;GAMG;AACH,MAAM,WAAW,wBAAwB;IACvC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAA;IAChB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,iGAAiG;IACjG,YAAY,EAAE,MAAM,CAAA;IACpB,+DAA+D;IAC/D,eAAe,EAAE,MAAM,CAAA;IACvB,yDAAyD;IACzD,iBAAiB,EAAE,MAAM,CAAA;IACzB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAA;IAChB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAA;IAClB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAA;IACnB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,OAAO,EAAE,MAAM,CAAA;IACf,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAA;IAClB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAA;IACnB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAA;IACnB,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAA;IACpB,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,wDAAwD;IACxD,cAAc,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAA;IACd,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAA;IACxB,4CAA4C;IAC5C,mBAAmB,EAAE,MAAM,CAAA;IAC3B,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAA;IAClB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAA;IACtB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAA;IACpB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,2CAA2C;IAC3C,kBAAkB,EAAE,MAAM,CAAA;IAC1B,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAA;IACpB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAA;IACpB,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAA;IACtB,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAA;IACtB,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAA;IACnB,2CAA2C;IAC3C,kBAAkB,EAAE,MAAM,CAAA;IAC1B,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAA;IACpB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAA;IACpB,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAA;IACtB,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAA;IACtB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAA;IACnB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAA;IACjB,8CAA8C;IAC9C,oBAAoB,EAAE,MAAM,CAAA;CAC7B;AAED,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,EAAE,wBAyCjC,CAAA"}

package/dist/editor/sidebar/form/formUtils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The one-based subtitle for an array-item edit view (e.g. "Accordion 2"), reusing the same
+ * `itemSubtitle` string as an item's inline display label so the list and the paging header
+ * agree. `translate` is the resolver from `useBlockTranslations(DesignerFormEnglish)`.
+ */
+export declare function getItemSubtitle(translate: (key: 'itemSubtitle', vars?: Record<string, unknown>) => string, fieldName: string, itemName: string | undefined, fieldLabel: string | undefined, index: number): string;
+//# sourceMappingURL=formUtils.d.ts.map

package/dist/editor/sidebar/form/formUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formUtils.d.ts","sourceRoot":"","sources":["../../../../src/editor/sidebar/form/formUtils.ts"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,EAC1E,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,KAAK,EAAE,MAAM,GACZ,MAAM,CAKR"}

package/dist/editor/sidebar/form/index.d.ts

@@ -0,0 +1,7 @@
+export { ComponentEditorForm, type ComponentEditorFormProps } from './ComponentEditorForm';
+export { FormFieldWrapper } from './FormFieldWrapper';
+export { fieldRendererRegistry, getFieldRenderer } from './fieldRenderers';
+export type { FieldRenderFn, FieldRenderProps } from './fieldRendererUtils';
+export { getItemSubtitle } from './formUtils';
+export { DesignerFormEnglish, type DesignerFormTranslations } from './formTranslations';
+//# sourceMappingURL=index.d.ts.map

package/dist/editor/sidebar/form/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/editor/sidebar/form/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,mBAAmB,EAAE,KAAK,wBAAwB,EAAE,MAAM,uBAAuB,CAAA;AAC1F,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAC1E,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,KAAK,wBAAwB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/editor/sidebar/form/knowledgeCheckEditor.d.ts

@@ -0,0 +1,10 @@
+import { KnowledgeCheckAnswer, QuestionType } from '../../../components/blocks/KnowledgeCheck';
+export type { KnowledgeCheckAnswer, QuestionType };
+/** Question type: Multiple choice or True/False. */
+export declare const QuestionTypeEnum: {
+    readonly MULTIPLE_CHOICE: "Multiple choice";
+    readonly TRUE_FALSE: "True or false";
+};
+/** Default answers for a new multiple-choice question in the editor. */
+export declare const DEFAULT_MULTIPLE_CHOICE_ANSWERS: KnowledgeCheckAnswer[];
+//# sourceMappingURL=knowledgeCheckEditor.d.ts.map

package/dist/editor/sidebar/form/knowledgeCheckEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledgeCheckEditor.d.ts","sourceRoot":"","sources":["../../../../src/editor/sidebar/form/knowledgeCheckEditor.ts"],"names":[],"mappings":"AAkBA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAA;AAEnG,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,CAAA;AAElD,oDAAoD;AACpD,eAAO,MAAM,gBAAgB;;;CAGoB,CAAA;AAEjD,wEAAwE;AACxE,eAAO,MAAM,+BAA+B,EAAE,oBAAoB,EAIjE,CAAA"}

package/dist/editor/sidebar/form/renderers/AltTextFieldRenderer.d.ts

@@ -0,0 +1,4 @@
+import { ReactElement } from 'react';
+import { FieldRenderProps } from '../fieldRendererUtils';
+export declare function AltTextFieldRenderer({ metadata, control, fieldError, onFieldChange, setValue, disabled, }: FieldRenderProps): ReactElement;
+//# sourceMappingURL=AltTextFieldRenderer.d.ts.map

package/dist/editor/sidebar/form/renderers/AltTextFieldRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AltTextFieldRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/editor/sidebar/form/renderers/AltTextFieldRenderer.tsx"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AASzC,OAAO,EAAE,KAAK,gBAAgB,EAAoB,MAAM,uBAAuB,CAAA;AAE/E,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,OAAO,EACP,UAAU,EACV,aAAa,EACb,QAAQ,EACR,QAAQ,GACT,EAAE,gBAAgB,GAAG,YAAY,CAuGjC"}

package/dist/editor/sidebar/form/renderers/AnswerArrayFieldRenderer.d.ts

@@ -0,0 +1,4 @@
+import { ReactElement } from 'react';
+import { FieldRenderProps } from '../fieldRendererUtils';
+export declare function AnswerArrayFieldRenderer({ metadata, control, fieldError, onFieldChange, }: FieldRenderProps): ReactElement;
+//# sourceMappingURL=AnswerArrayFieldRenderer.d.ts.map

package/dist/editor/sidebar/form/renderers/AnswerArrayFieldRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnswerArrayFieldRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/editor/sidebar/form/renderers/AnswerArrayFieldRenderer.tsx"],"names":[],"mappings":"AA2BA,OAAO,EAAE,KAAK,YAAY,EAA4B,MAAM,OAAO,CAAA;AAQnE,OAAO,EAAE,KAAK,gBAAgB,EAAgC,MAAM,uBAAuB,CAAA;AAU3F,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,OAAO,EACP,UAAU,EACV,aAAa,GACd,EAAE,gBAAgB,GAAG,YAAY,CAmLjC"}

package/dist/editor/sidebar/form/renderers/ObjectArrayFieldRenderer.d.ts

@@ -0,0 +1,4 @@
+import { ReactElement } from 'react';
+import { FieldRenderProps } from '../fieldRendererUtils';
+export declare function ObjectArrayFieldRenderer({ metadata, control, fieldError, onFieldChange, isManageLayer, }: FieldRenderProps): ReactElement;
+//# sourceMappingURL=ObjectArrayFieldRenderer.d.ts.map

package/dist/editor/sidebar/form/renderers/ObjectArrayFieldRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectArrayFieldRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/editor/sidebar/form/renderers/ObjectArrayFieldRenderer.tsx"],"names":[],"mappings":"AAyCA,OAAO,EAAsB,KAAK,YAAY,EAAwB,MAAM,OAAO,CAAA;AAWnF,OAAO,EAAE,KAAK,gBAAgB,EAAgC,MAAM,uBAAuB,CAAA;AAuG3F,wBAAgB,wBAAwB,CAAC,EACvC,QAAQ,EACR,OAAO,EACP,UAAU,EACV,aAAa,EACb,aAAa,GACd,EAAE,gBAAgB,GAAG,YAAY,CAwIjC"}

package/dist/editor/sidebar/form/uploaders/FileUploader.d.ts

@@ -0,0 +1,24 @@
+import { ReactNode } from 'react';
+import { Control, FieldValues } from 'react-hook-form';
+import { ResolvedUploadedFile } from '../../../../contexts/BlockEditorApiContext';
+export interface FileUploaderConfig {
+    acceptedExtensions: string[];
+    maxFileSizeBytes: number;
+    uploadLabel: string;
+    acceptedTypesLabel: string;
+    maxSizeLabel: string;
+    replaceScreenReaderLabel: string;
+    uploadingLabel: string;
+    sizeErrorLabel: string;
+}
+export type FileUploaderMediaType = 'image' | 'video';
+export interface FileUploaderProps {
+    control: Control<FieldValues>;
+    onFieldChange: () => void;
+    config: FileUploaderConfig;
+    renderPreview: (file: ResolvedUploadedFile) => ReactNode;
+    header?: ReactNode;
+    mediaType?: FileUploaderMediaType;
+}
+export declare function FileUploader({ control, onFieldChange, config, renderPreview, header, mediaType, }: FileUploaderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=FileUploader.d.ts.map

package/dist/editor/sidebar/form/uploaders/FileUploader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileUploader.d.ts","sourceRoot":"","sources":["../../../../../src/editor/sidebar/form/uploaders/FileUploader.tsx"],"names":[],"mappings":"AAyBA,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,OAAO,CAAA;AACxD,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,WAAW,EAAiB,MAAM,iBAAiB,CAAA;AAE/E,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,4CAA4C,CAAA;AAGnD,MAAM,WAAW,kBAAkB;IACjC,kBAAkB,EAAE,MAAM,EAAE,CAAA;IAC5B,gBAAgB,EAAE,MAAM,CAAA;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;IACpB,wBAAwB,EAAE,MAAM,CAAA;IAChC,cAAc,EAAE,MAAM,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,OAAO,CAAA;AAErD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;IAC7B,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,MAAM,EAAE,kBAAkB,CAAA;IAC1B,aAAa,EAAE,CAAC,IAAI,EAAE,oBAAoB,KAAK,SAAS,CAAA;IACxD,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,SAAS,CAAC,EAAE,qBAAqB,CAAA;CAClC;AAOD,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,aAAa,EACb,MAAM,EACN,aAAa,EACb,MAAM,EACN,SAAmB,GACpB,EAAE,iBAAiB,2CAgInB"}

package/dist/editor/sidebar/form/uploaders/ImageUploader.d.ts

@@ -0,0 +1,8 @@
+import { Control, FieldValues } from 'react-hook-form';
+interface ImageUploaderProps {
+    control: Control<FieldValues>;
+    onFieldChange: () => void;
+}
+export declare function ImageUploader({ control, onFieldChange }: ImageUploaderProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=ImageUploader.d.ts.map

package/dist/editor/sidebar/form/uploaders/ImageUploader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ImageUploader.d.ts","sourceRoot":"","sources":["../../../../../src/editor/sidebar/form/uploaders/ImageUploader.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAQ3D,UAAU,kBAAkB;IAC1B,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;IAC7B,aAAa,EAAE,MAAM,IAAI,CAAA;CAC1B;AAED,wBAAgB,aAAa,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,kBAAkB,2CA2C3E"}

package/dist/editor/sidebar/form/uploaders/VideoUploader.d.ts

@@ -0,0 +1,8 @@
+import { Control, FieldValues } from 'react-hook-form';
+interface VideoUploaderProps {
+    control: Control<FieldValues>;
+    onFieldChange: () => void;
+}
+export declare function VideoUploader({ control, onFieldChange }: VideoUploaderProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=VideoUploader.d.ts.map

package/dist/editor/sidebar/form/uploaders/VideoUploader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoUploader.d.ts","sourceRoot":"","sources":["../../../../../src/editor/sidebar/form/uploaders/VideoUploader.tsx"],"names":[],"mappings":"AAwBA,OAAO,EAAE,KAAK,OAAO,EAAc,KAAK,WAAW,EAAiB,MAAM,iBAAiB,CAAA;AAS3F,UAAU,kBAAkB;IAC1B,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;IAC7B,aAAa,EAAE,MAAM,IAAI,CAAA;CAC1B;AAED,wBAAgB,aAAa,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,kBAAkB,2CAsF3E"}

package/dist/editor/sidebar/panel/DesignerSideBar.d.ts

@@ -0,0 +1,18 @@
+import { Ref } from 'react';
+import { DesignerSideBarProps, ToolPanelHandle } from './types';
+/**
+ * The designer sidebar: a collapsible tool panel on desktop (icon rail + resizable content)
+ * and a slide-up overlay + bottom toolbar on mobile. Built-in trays and any host tools are
+ * supplied through `tools`. Each open tool gets its own `DesignerNavProvider` (keyed by tool
+ * id, so switching tools resets navigation) and `ToolHeaderActionsProvider`.
+ */
+declare function DesignerSideBarInner<ID extends string>({ tools: unsortedTools, initialSelectedToolId, height, toolStyle, isFullScreenMode, hasExpandPanelButton, onToolChange, onFullWidthChange, isPanelResizeEnabled, selectedToolId: controlledSelectedToolId, onSelectedToolIdChange, view, onViewChange, renderContentInActiveLayoutOnly, controlledExpandedWidth, contentKey, onBack, }: DesignerSideBarProps<ID>, ref: Ref<ToolPanelHandle<ID>>): import("react/jsx-runtime").JSX.Element;
+/**
+ * `forwardRef` erases the generic, so re-assert it on the exported component: callers keep
+ * `Tool<ID>` inference and a typed imperative handle.
+ */
+export declare const DesignerSideBar: <ID extends string>(props: DesignerSideBarProps<ID> & {
+    ref?: Ref<ToolPanelHandle<ID>>;
+}) => ReturnType<typeof DesignerSideBarInner>;
+export {};
+//# sourceMappingURL=DesignerSideBar.d.ts.map

package/dist/editor/sidebar/panel/DesignerSideBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesignerSideBar.d.ts","sourceRoot":"","sources":["../../../../src/editor/sidebar/panel/DesignerSideBar.tsx"],"names":[],"mappings":"AAuBA,OAAO,EAIL,KAAK,GAAG,EAQT,MAAM,OAAO,CAAA;AAYd,OAAO,KAAK,EAAE,oBAAoB,EAAQ,eAAe,EAAE,MAAM,SAAS,CAAA;AA6C1E;;;;;GAKG;AACH,iBAAS,oBAAoB,CAAC,EAAE,SAAS,MAAM,EAC7C,EACE,KAAK,EAAE,aAAa,EACpB,qBAAqB,EACrB,MAAM,EACN,SAAS,EACT,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,oBAA2B,EAC3B,cAAc,EAAE,wBAAwB,EACxC,sBAAsB,EACtB,IAAI,EACJ,YAAY,EACZ,+BAAsC,EACtC,uBAAuB,EACvB,UAAU,EACV,MAAM,GACP,EAAE,oBAAoB,CAAC,EAAE,CAAC,EAC3B,GAAG,EAAE,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,2CA0W9B;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAuC,CAAC,EAAE,SAAS,MAAM,EACnF,KAAK,EAAE,oBAAoB,CAAC,EAAE,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAA;CAAE,KACjE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA"}

package/dist/editor/sidebar/panel/MobileToolOverlay.d.ts

@@ -0,0 +1,13 @@
+import { ReactNode } from 'react';
+interface MobileToolOverlayProps {
+    isOpen: boolean;
+    children: ReactNode;
+}
+/**
+ * The compact-viewport slide-up sheet holding a tool's content. Carries the
+ * `data-tool-panel` marker so the canvas↔panel focus coordination treats focus moving into
+ * it as staying "in the panel" (see `useDesignerSelectionFocus`).
+ */
+export declare function MobileToolOverlay({ isOpen, children }: MobileToolOverlayProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=MobileToolOverlay.d.ts.map

package/dist/editor/sidebar/panel/MobileToolOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileToolOverlay.d.ts","sourceRoot":"","sources":["../../../../src/editor/sidebar/panel/MobileToolOverlay.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAA;AAUrD,UAAU,sBAAsB;IAC9B,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,sBAAsB,2CAU7E"}

package/dist/editor/sidebar/panel/MobileToolbar.d.ts

@@ -0,0 +1,10 @@
+import { Tool } from './types';
+interface MobileToolbarProps<ID extends string> {
+    tools: Tool<ID>[];
+    selectedToolId: string | null;
+    onToolClick: (toolId: string) => void;
+}
+/** The fixed bottom toolbar shown on compact viewports in place of the desktop rail. */
+export declare function MobileToolbar<ID extends string>({ tools, selectedToolId, onToolClick, }: MobileToolbarProps<ID>): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=MobileToolbar.d.ts.map

package/dist/editor/sidebar/panel/MobileToolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileToolbar.d.ts","sourceRoot":"","sources":["../../../../src/editor/sidebar/panel/MobileToolbar.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAEnC,UAAU,kBAAkB,CAAC,EAAE,SAAS,MAAM;IAC5C,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAA;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;CACtC;AAED,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,EAC/C,KAAK,EACL,cAAc,EACd,WAAW,GACZ,EAAE,kBAAkB,CAAC,EAAE,CAAC,2CAWxB"}

package/dist/editor/sidebar/panel/ToolBody.d.ts

@@ -0,0 +1,11 @@
+import { ReactNode } from 'react';
+import { ToolStyle } from './types';
+interface ToolBodyProps {
+    children: ReactNode;
+    darkSurface?: boolean;
+    toolStyle?: ToolStyle;
+}
+/** The scrollable content region below the header. */
+export declare function ToolBody({ children, darkSurface, toolStyle }: ToolBodyProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=ToolBody.d.ts.map

package/dist/editor/sidebar/panel/ToolBody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolBody.d.ts","sourceRoot":"","sources":["../../../../src/editor/sidebar/panel/ToolBody.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAA;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExC,UAAU,aAAa;IACrB,QAAQ,EAAE,SAAS,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,EAAE,QAAQ,EAAE,WAAmB,EAAE,SAAS,EAAE,EAAE,aAAa,2CAanF"}

package/dist/editor/sidebar/panel/ToolContentContainer.d.ts

@@ -0,0 +1,27 @@
+import { ReactNode } from 'react';
+import { ToolStyle, ToolVariant } from './types';
+interface ToolContentContainerProps {
+    id?: string;
+    headingId?: string;
+    icon: ReactNode;
+    title: string;
+    variant?: ToolVariant;
+    onClose?: () => void;
+    onBack?: () => void;
+    onToggleFullWidth?: () => void;
+    isFullWidth?: boolean;
+    isFullScreen?: boolean;
+    toolStyle?: ToolStyle;
+    skipInitialFocus?: boolean;
+    onAfterInitialFocus?: () => void;
+    children: ReactNode;
+}
+/**
+ * Wraps a tool's content with the header and scrollable body, and owns focus lifecycle:
+ * focus the close button on open (or the container when there is none), the back button on
+ * forward navigation, the close button on backward navigation. Escape closes the tool
+ * (ignoring Escape bubbling up from portaled descendants like popovers).
+ */
+export declare function ToolContentContainer({ id, headingId, icon, title, variant, onClose, onBack, onToggleFullWidth, isFullWidth, isFullScreen, toolStyle, skipInitialFocus, onAfterInitialFocus, children, }: ToolContentContainerProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=ToolContentContainer.d.ts.map

package/dist/editor/sidebar/panel/ToolContentContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolContentContainer.d.ts","sourceRoot":"","sources":["../../../../src/editor/sidebar/panel/ToolContentContainer.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,SAAS,EAAkC,MAAM,OAAO,CAAA;AAMtE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAErD,UAAU,yBAAyB;IACjC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAA;IAChC,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,EAAE,EACF,SAAS,EACT,IAAI,EACJ,KAAK,EACL,OAAmB,EACnB,OAAO,EACP,MAAM,EACN,iBAAiB,EACjB,WAAmB,EACnB,YAAoB,EACpB,SAAS,EACT,gBAAwB,EACxB,mBAAmB,EACnB,QAAQ,GACT,EAAE,yBAAyB,2CA+G3B"}

package/dist/editor/sidebar/panel/ToolHeader.d.ts

@@ -0,0 +1,24 @@
+import { ReactNode } from 'react';
+interface ToolHeaderProps {
+    headingId?: string;
+    icon: ReactNode;
+    title: string;
+    subtitle?: string;
+    showBackButton?: boolean;
+    onBack?: () => void;
+    onClose?: () => void;
+    onToggleFullWidth?: () => void;
+    isFullWidth?: boolean;
+    headerActions?: ReactNode;
+    darkSurface?: boolean;
+    closeButtonElementRef?: (el: Element | null) => void;
+    backButtonElementRef?: (el: Element | null) => void;
+}
+/**
+ * The tool header: a back button (or the tool icon) beside the title, and a right cluster
+ * of host-injected `headerActions`, the full-width toggle, and the close button. The title
+ * shows `subtitle` when navigated into a sub-view, otherwise the tool `title`.
+ */
+export declare function ToolHeader({ headingId, icon, title, subtitle, showBackButton, onBack, onClose, onToggleFullWidth, isFullWidth, headerActions, darkSurface, closeButtonElementRef, backButtonElementRef, }: ToolHeaderProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=ToolHeader.d.ts.map

package/dist/editor/sidebar/panel/ToolHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolHeader.d.ts","sourceRoot":"","sources":["../../../../src/editor/sidebar/panel/ToolHeader.tsx"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAA;AAYrD,UAAU,eAAe;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,aAAa,CAAC,EAAE,SAAS,CAAA;IACzB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,qBAAqB,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAA;IACpD,oBAAoB,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAA;CACpD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EACzB,SAAS,EACT,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,cAAc,EACd,MAAM,EACN,OAAO,EACP,iBAAiB,EACjB,WAAmB,EACnB,aAAa,EACb,WAAmB,EACnB,qBAAqB,EACrB,oBAAoB,GACrB,EAAE,eAAe,2CA2EjB"}

package/dist/editor/sidebar/panel/ToolHeaderActionsContext.d.ts

@@ -0,0 +1,8 @@
+import { ReactNode } from 'react';
+import { ToolHeaderActionsContextValue } from './types';
+export declare function ToolHeaderActionsProvider({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+/** Access the header-action slot. Throws outside a `ToolHeaderActionsProvider`. */
+export declare function useToolHeaderActions(): ToolHeaderActionsContextValue;
+//# sourceMappingURL=ToolHeaderActionsContext.d.ts.map

package/dist/editor/sidebar/panel/ToolHeaderActionsContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolHeaderActionsContext.d.ts","sourceRoot":"","sources":["../../../../src/editor/sidebar/panel/ToolHeaderActionsContext.tsx"],"names":[],"mappings":"AAkBA;;;;;;GAMG;AAEH,OAAO,EAAiB,KAAK,SAAS,EAAiC,MAAM,OAAO,CAAA;AACpF,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,SAAS,CAAA;AAI5D,wBAAgB,yBAAyB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,2CAS9E;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,IAAI,6BAA6B,CAMpE"}

package/dist/editor/sidebar/panel/ToolIconButtons.d.ts

@@ -0,0 +1,19 @@
+import { Tool } from './types';
+interface ToolIconButtonsProps<ID extends string> {
+    tools: Tool<ID>[];
+    selectedToolId: string | null;
+    onToolClick: (toolId: string) => void;
+    direction?: 'column' | 'row';
+    contentId?: string;
+}
+/**
+ * The rail of tool icon buttons, shared by the desktop panel and the mobile toolbar. The
+ * active tool reads as a filled button; the rest are ghost. Only the active tool carries
+ * `aria-controls`, tying it to the open content region — that region only exists while a tool
+ * is open, so a collapsed button must not reference a missing id. (`aria-expanded` is passed
+ * too, but the wrapping `Tooltip` strips it from the trigger, so `aria-controls` is what
+ * actually lands.)
+ */
+export declare function ToolIconButtons<ID extends string>({ tools, selectedToolId, onToolClick, direction, contentId, }: ToolIconButtonsProps<ID>): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=ToolIconButtons.d.ts.map

package/dist/editor/sidebar/panel/ToolIconButtons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolIconButtons.d.ts","sourceRoot":"","sources":["../../../../src/editor/sidebar/panel/ToolIconButtons.tsx"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAEnC,UAAU,oBAAoB,CAAC,EAAE,SAAS,MAAM;IAC9C,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAA;IACjB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,SAAS,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAA;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,EACjD,KAAK,EACL,cAAc,EACd,WAAW,EACX,SAAoB,EACpB,SAAS,GACV,EAAE,oBAAoB,CAAC,EAAE,CAAC,2CAgC1B"}

package/dist/editor/sidebar/panel/ToolWrapper.d.ts

@@ -0,0 +1,16 @@
+import { ReactNode } from 'react';
+interface ToolWrapperProps {
+    isOpen: boolean;
+    contentWidth: number;
+    isResizing: boolean;
+    isFullWidth: boolean;
+    children: ReactNode;
+}
+/**
+ * Animates the tool content area open/closed beside the icon rail. Width is applied inline
+ * (it varies per render); the resizing/full-width states toggle modifier classes so the
+ * transition and flex-fill come from the stylesheet.
+ */
+export declare function ToolWrapper({ isOpen, contentWidth, isResizing, isFullWidth, children, }: ToolWrapperProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=ToolWrapper.d.ts.map

package/dist/editor/sidebar/panel/ToolWrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolWrapper.d.ts","sourceRoot":"","sources":["../../../../src/editor/sidebar/panel/ToolWrapper.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,UAAU,gBAAgB;IACxB,MAAM,EAAE,OAAO,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,OAAO,CAAA;IACnB,WAAW,EAAE,OAAO,CAAA;IACpB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,YAAY,EACZ,UAAU,EACV,WAAW,EACX,QAAQ,GACT,EAAE,gBAAgB,2CAgBlB"}

package/dist/editor/sidebar/panel/constants.d.ts

@@ -0,0 +1,23 @@
+/** Surface treatments a tool's content can request. `dark-surface` lets a host tool (e.g. an
+ * AI assistant, added in a later step) render light-on-dark; built-in trays use `default`. */
+export declare const TOOL_VARIANTS: {
+    readonly DEFAULT: "default";
+    readonly DARK_SURFACE: "dark-surface";
+};
+/** Panel widths (px). The icon rail is always visible; the content area expands beside it. */
+export declare const TOOL_PANEL_DIMENSIONS: {
+    readonly COLLAPSED_WIDTH: 48;
+    readonly EXPANDED_WIDTH: 368;
+    readonly ICON_BAR_WIDTH: 48;
+    readonly MIN_EXPANDED_WIDTH: 280;
+    readonly MAX_EXPANDED_WIDTH: 800;
+};
+/**
+ * Below this viewport width the panel drops its desktop rail for the mobile slide-up
+ * overlay + bottom toolbar. The panel is editor *chrome*, not a block, so a viewport query
+ * is correct here (blocks size to their container instead). Mirrors canvas-horizon's
+ * `breakpoints.medium`.
+ */
+export declare const FULL_LAYOUT_MIN_WIDTH = "768px";
+export declare const FULL_LAYOUT_MQ = "(min-width: 768px)";
+//# sourceMappingURL=constants.d.ts.map

package/dist/editor/sidebar/panel/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/editor/sidebar/panel/constants.ts"],"names":[],"mappings":"AAkBA;8FAC8F;AAC9F,eAAO,MAAM,aAAa;;;CAGhB,CAAA;AAEV,8FAA8F;AAC9F,eAAO,MAAM,qBAAqB;;;;;;CAMxB,CAAA;AAEV;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,UAAU,CAAA;AAC5C,eAAO,MAAM,cAAc,uBAA0C,CAAA"}

package/dist/editor/sidebar/panel/index.d.ts

@@ -0,0 +1,5 @@
+export { DesignerSideBar } from './DesignerSideBar';
+export { TOOL_PANEL_DIMENSIONS, TOOL_VARIANTS } from './constants';
+export { ToolHeaderActionsProvider, useToolHeaderActions, } from './ToolHeaderActionsContext';
+export type { DesignerSideBarProps, Tool, ToolPanelHandle, ToolStyle, ToolVariant, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/editor/sidebar/panel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/editor/sidebar/panel/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAClE,OAAO,EACL,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,4BAA4B,CAAA;AACnC,YAAY,EACV,oBAAoB,EACpB,IAAI,EACJ,eAAe,EACf,SAAS,EACT,WAAW,GACZ,MAAM,SAAS,CAAA"}

package/dist/editor/sidebar/panel/panelStyles.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The sidebar tool panel's chrome CSS: the desktop wrapper + resize handle, the animated
+ * content wrapper, the content/body surfaces, and the mobile slide-up overlay + bottom
+ * toolbar. None of it is expressible in InstUI props — it needs media queries,
+ * `:focus-visible`, reduced-motion and animated widths — so, like the canvas chrome, it is
+ * injected once as a global stylesheet keyed by stable class names. Widths and transforms
+ * that vary per render are applied inline; the `--resizing`/`--full-width`/`--open`
+ * modifier classes toggle the rest.
+ */
+export declare const PANEL_CLASS: {
+    readonly panel: "bce-tool-panel";
+    readonly panelResizing: "bce-tool-panel--resizing";
+    readonly panelFullWidth: "bce-tool-panel--full-width";
+    readonly dragHandle: "bce-tool-drag-handle";
+    readonly wrapper: "bce-tool-wrapper";
+    readonly wrapperResizing: "bce-tool-wrapper--resizing";
+    readonly wrapperFullWidth: "bce-tool-wrapper--full-width";
+    readonly content: "bce-tool-content";
+    readonly contentDark: "bce-tool-content--dark";
+    readonly contentFullScreen: "bce-tool-content--full-screen";
+    readonly body: "bce-tool-body";
+    readonly bodyDark: "bce-tool-body--dark";
+    readonly mobileOverlay: "bce-tool-mobile-overlay";
+    readonly mobileOverlayOpen: "bce-tool-mobile-overlay--open";
+    readonly mobileToolbar: "bce-tool-mobile-toolbar";
+};
+/** Mounts the tool-panel chrome stylesheet once, under the sidebar. */
+export declare function PanelChromeStyles(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=panelStyles.d.ts.map

package/dist/editor/sidebar/panel/panelStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panelStyles.d.ts","sourceRoot":"","sources":["../../../../src/editor/sidebar/panel/panelStyles.tsx"],"names":[],"mappings":"AAqBA;;;;;;;;GAQG;AAEH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;CAgBd,CAAA;AAsBV,uEAAuE;AACvE,wBAAgB,iBAAiB,4CA6JhC"}

package/dist/editor/sidebar/panel/types.d.ts

@@ -0,0 +1,83 @@
+import { ReactNode } from 'react';
+import { DesignerNavState } from '../DesignerNav';
+import { TOOL_VARIANTS } from './constants';
+export type ToolVariant = (typeof TOOL_VARIANTS)[keyof typeof TOOL_VARIANTS];
+/**
+ * One entry in the sidebar's icon rail. The built-in trays are supplied as tools by the
+ * package; a host appends its own (an AI assistant, a widget tray) through the same array —
+ * this is the sidebar's host-tool slot.
+ *
+ * `icon`/`activeIcon` are `@instructure/ui-icons` elements (InstUI icons are components, not
+ * string names), matching the tray's `BlockDefinition.icon`.
+ */
+export interface Tool<ID extends string> {
+    id: ID;
+    /** Rail tooltip + header title, already translated. */
+    title: string;
+    /** Rail position, lowest first; ties keep the given array order. Omitted sorts after every
+     * tool that sets one, in the order given — a host tool with no `priority` renders last. */
+    priority?: number;
+    icon: ReactNode;
+    /** Shown in the rail while this tool is active; falls back to `icon`. */
+    activeIcon?: ReactNode;
+    /** Surface treatment for the content area. Defaults to `default`. */
+    variant?: ToolVariant;
+    /** Background override for the content surface (e.g. a host tool's branded panel). */
+    background?: string;
+    /** Seed width (px) when this tool opens; clamped to min/max, overridden once the user resizes. */
+    expandedWidth?: number;
+    content?: ReactNode;
+    /** Root view this tool's navigation starts at. Defaults to `main`. */
+    defaultView?: string;
+    /** Set `false` to hide the header close button (e.g. a permanently docked tool). */
+    hasCloseButton?: boolean;
+}
+/** Imperative handle for opening a tool from outside (e.g. a host toolbar button). */
+export interface ToolPanelHandle<ID extends string> {
+    openTool: (toolId: ID) => void;
+}
+export interface DesignerSideBarProps<ID extends string> {
+    tools: Tool<ID>[];
+    /** Uncontrolled: the tool open on first render. Ignored when `selectedToolId` is set. */
+    initialSelectedToolId?: ID;
+    /** Panel height; defaults to `100%`. */
+    height?: number | string;
+    /** Padding/overflow overrides for the content body. */
+    toolStyle?: ToolStyle;
+    /** Renders the active tool's content full-screen (fixed overlay). */
+    isFullScreenMode?: boolean;
+    /** Shows the rail collapse/expand toggle once a tool has been opened. */
+    hasExpandPanelButton?: boolean;
+    onToolChange?: (toolId: ID | null) => void;
+    onFullWidthChange?: (isFullWidth: boolean) => void;
+    /** Enables the drag-to-resize handle + full-width toggle. Defaults to `true`. */
+    isPanelResizeEnabled?: boolean;
+    /** Controlled: the open tool (or `null`). Parent owns selection when provided. */
+    selectedToolId?: ID | null;
+    onSelectedToolIdChange?: (toolId: ID | null) => void;
+    /** Controlled navigation view within the open tool. Parent owns it when provided. */
+    view?: DesignerNavState;
+    onViewChange?: (view: DesignerNavState) => void;
+    /** Render content only in the active layout (desktop XOR mobile) so a singleton like an
+     * RCE field does not double-mount across the two layouts. Defaults to `true`. */
+    renderContentInActiveLayoutOnly?: boolean;
+    /** Overrides the expanded width while set (e.g. widen for an RCE field); restores the
+     * user's width when cleared. */
+    controlledExpandedWidth?: number;
+    /** Extra key mixed into the open tool's content remount — pass the id of the entity being
+     * edited (e.g. the selected block) so navigation history resets when it changes, instead of
+     * leaking a previous block's sub-view into the Back button. */
+    contentKey?: string;
+    /** Fired when the header back button returns to the root view (no navigation history left). */
+    onBack?: () => void;
+}
+export interface ToolStyle {
+    padding?: number | string;
+    overflow?: 'auto' | 'scroll' | 'hidden' | 'visible';
+}
+/** Header-action slot: a tool's content injects buttons into the panel header via this. */
+export interface ToolHeaderActionsContextValue {
+    setHeaderActions: (actions: ReactNode) => void;
+    headerActions: ReactNode;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/editor/sidebar/panel/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/editor/sidebar/panel/types.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAA;AAE5E;;;;;;;GAOG;AACH,MAAM,WAAW,IAAI,CAAC,EAAE,SAAS,MAAM;IACrC,EAAE,EAAE,EAAE,CAAA;IACN,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAA;IACb;+FAC2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,SAAS,CAAA;IACf,yEAAyE;IACzE,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB,qEAAqE;IACrE,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kGAAkG;IAClG,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oFAAoF;IACpF,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,sFAAsF;AACtF,MAAM,WAAW,eAAe,CAAC,EAAE,SAAS,MAAM;IAChD,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,KAAK,IAAI,CAAA;CAC/B;AAED,MAAM,WAAW,oBAAoB,CAAC,EAAE,SAAS,MAAM;IACrD,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAA;IACjB,yFAAyF;IACzF,qBAAqB,CAAC,EAAE,EAAE,CAAA;IAC1B,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,uDAAuD;IACvD,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,yEAAyE;IACzE,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,KAAK,IAAI,CAAA;IAC1C,iBAAiB,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI,CAAA;IAClD,iFAAiF;IACjF,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,kFAAkF;IAClF,cAAc,CAAC,EAAE,EAAE,GAAG,IAAI,CAAA;IAC1B,sBAAsB,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,KAAK,IAAI,CAAA;IACpD,qFAAqF;IACrF,IAAI,CAAC,EAAE,gBAAgB,CAAA;IACvB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAC/C;qFACiF;IACjF,+BAA+B,CAAC,EAAE,OAAO,CAAA;IACzC;oCACgC;IAChC,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC;;mEAE+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+FAA+F;IAC/F,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;CACpD;AAED,2FAA2F;AAC3F,MAAM,WAAW,6BAA6B;IAC5C,gBAAgB,EAAE,CAAC,OAAO,EAAE,SAAS,KAAK,IAAI,CAAA;IAC9C,aAAa,EAAE,SAAS,CAAA;CACzB"}

package/dist/editor/sidebar/panel/useFocusReturn.d.ts

@@ -0,0 +1,8 @@
+import { RefObject } from 'react';
+/**
+ * Returns focus to `returnRef` when `active` goes from true to false — i.e. when the panel
+ * closes, focus goes back to whatever opened it (the rail button captured in `returnRef`).
+ * Does nothing on open, or when the ref is empty.
+ */
+export declare function useFocusReturn(active: boolean, returnRef: RefObject<HTMLElement | null>): void;
+//# sourceMappingURL=useFocusReturn.d.ts.map

package/dist/editor/sidebar/panel/useFocusReturn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFocusReturn.d.ts","sourceRoot":"","sources":["../../../../src/editor/sidebar/panel/useFocusReturn.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,OAAO,CAAA;AAEzD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,IAAI,CAQ9F"}