@instructure/platform-block-content-editor 0.3.1

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

@@ -0,0 +1,16 @@
+import { VideoBlockProps } from './videoBlockPropsSchema';
+/** Normalise a supported provider URL to its embeddable form, or `null` if unsupported. */
+export declare function getEmbedUrl(url: string): string | null;
+/**
+ * Presentational video block. A `file` source resolves `asset_id` to a playable
+ * URL via the asset context (the host owns the fetch and the Canvas media-embed
+ * URL); a `link` source embeds a supported provider (YouTube/Vimeo).
+ */
+export declare function VideoBlock({ source, asset_id, video_url, alt, size, align, cornerStyle, }: VideoBlockProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hookless, provider-free stand-in the host's drag-and-drop renders instead of
+ * the live iframe during a drag (re-mounting an iframe mid-drag is expensive).
+ * Copy is static because it renders outside the translations provider.
+ */
+export declare function VideoBlockDragPreview({ size, align, cornerStyle, }: Partial<Pick<VideoBlockProps, 'size' | 'align' | 'cornerStyle'>>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=VideoBlock.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,5 @@
+import { Align, CornerStyle } from '../commonSchemas';
+import { MediaBlockViewProps } from '../commonViewProps';
+export type VideoBlockViewProps = MediaBlockViewProps;
+export declare function getVideoBlockViewProps(align: Align, size: number, cornerStyle: CornerStyle): VideoBlockViewProps;
+//# sourceMappingURL=getVideoBlockViewProps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getVideoBlockViewProps.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/VideoBlock/getVideoBlockViewProps.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAc,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAKzE,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,CAAA;AAErD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,WAAW,GACvB,mBAAmB,CAOrB"}

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

@@ -0,0 +1,3 @@
+export { VideoBlock, VideoBlockDragPreview } from './VideoBlock';
+export { RegisteredVideoBlockPropsSchema, VideoBlockDefaultProps } from './videoBlockPropsSchema';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+export declare const VideoSourceSchema: z.ZodEnum<["file", "link"]>;
+export declare const VideoBlockPropsSchema: z.ZodObject<{
+    source: z.ZodDefault<z.ZodEnum<["file", "link"]>>;
+    asset_id: z.ZodString;
+    video_url: z.ZodOptional<z.ZodString>;
+    alt: z.ZodString;
+    size: z.ZodDefault<z.ZodNumber>;
+    align: z.ZodDefault<z.ZodEnum<["left", "center", "right"]>>;
+    cornerStyle: z.ZodOptional<z.ZodDefault<z.ZodEnum<["rounded", "square"]>>>;
+}, "strip", z.ZodTypeAny, {
+    alt: string;
+    size: number;
+    source: "link" | "file";
+    align: "left" | "center" | "right";
+    asset_id: string;
+    cornerStyle?: "rounded" | "square" | undefined;
+    video_url?: string | undefined;
+}, {
+    alt: string;
+    asset_id: string;
+    cornerStyle?: "rounded" | "square" | undefined;
+    size?: number | undefined;
+    source?: "link" | "file" | undefined;
+    align?: "left" | "center" | "right" | undefined;
+    video_url?: string | undefined;
+}>;
+export type VideoBlockProps = z.infer<typeof VideoBlockPropsSchema>;
+export type VideoSource = z.infer<typeof VideoSourceSchema>;
+export declare const VideoBlockDefaultProps: VideoBlockProps;
+export declare const RegisteredVideoBlockPropsSchema: import('../../..').RegisteredComponentSchema<{
+    alt: string;
+    size: number;
+    source: "link" | "file";
+    align: "left" | "center" | "right";
+    asset_id: string;
+    cornerStyle?: "rounded" | "square" | undefined;
+    video_url?: string | undefined;
+}>;
+//# sourceMappingURL=videoBlockPropsSchema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"videoBlockPropsSchema.d.ts","sourceRoot":"","sources":["../../../../src/components/blocks/VideoBlock/videoBlockPropsSchema.ts"],"names":[],"mappings":"AAmBA,OAAO,+BAA+B,CAAA;AACtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,iBAAiB,6BAA2B,CAAA;AAEzD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;EAgChC,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AACnE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D,eAAO,MAAM,sBAAsB,EAAE,eAQpC,CAAA;AAED,eAAO,MAAM,+BAA+B;;;;;;;;EAG3C,CAAA"}

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

@@ -0,0 +1,87 @@
+import { View } from '@instructure/ui-view';
+import { ComponentProps } from 'react';
+type ViewProps = ComponentProps<typeof View>;
+type ViewThemeOverride = ViewProps['themeOverride'];
+/**
+ * The text theme override a block applies. Only the primary text color is
+ * recolored, and `primaryColor` is a key both InstUI `Text` and `Heading` accept,
+ * so the same override works on either.
+ */
+type BlockTextThemeOverride = {
+    primaryColor: string;
+};
+/**
+ * Text color tokens accepted by both InstUI `Text` and `Heading`, so a block can
+ * apply one `text.color` to either. (`Text`'s `brand`/`ai-*` and `Heading`'s
+ * `inherit` are deliberately excluded — they're not shared.)
+ */
+export type BlockTextColor = 'primary' | 'secondary' | 'primary-inverse' | 'secondary-inverse';
+/**
+ * Coherent InstUI props for a block's container and its text. Container and text
+ * colors are decided together so a themed surface always carries the matching
+ * accessible text color.
+ */
+export interface BlockRenderProps {
+    view: {
+        background: NonNullable<ViewProps['background']>;
+        borderWidth: NonNullable<ViewProps['borderWidth']>;
+        borderColor: ViewProps['borderColor'];
+        borderRadius: NonNullable<ViewProps['borderRadius']>;
+        padding: ViewProps['padding'];
+        /** Set only when a brand color themes the container/border. */
+        themeOverride?: ViewThemeOverride;
+    };
+    text: {
+        /** Token accepted by Text and Heading; omitted when the default is fine. */
+        color?: BlockTextColor;
+        /** Set only when a brand color themes the text. */
+        themeOverride?: BlockTextThemeOverride;
+    };
+}
+/** A block's own token colors for a style, before any brand override. */
+export interface Decoration {
+    background: NonNullable<ViewProps['background']>;
+    borderWidth: NonNullable<ViewProps['borderWidth']>;
+    borderColor: ViewProps['borderColor'];
+    textColor?: BlockTextColor;
+}
+/** A base decoration plus the theme overrides that recolor it with a brand color. */
+export interface Styling {
+    decoration: Decoration;
+    viewThemeOverride?: ViewThemeOverride;
+    textThemeOverride?: BlockTextThemeOverride;
+}
+/** How much of the block's surface a corner radius applies to. */
+export interface Layout {
+    borderRadius: NonNullable<ViewProps['borderRadius']>;
+    padding: ViewProps['padding'];
+}
+/** A brand variant's surface color paired with its accessible text color, as hex. */
+export type BrandVariant = {
+    color: string;
+    textColor: string;
+};
+/** Which accessible variant of the brand color to use. */
+export type BrandTone = 'light' | 'dark';
+/**
+ * The brand variant for a tone, from `deriveColorVariants` (via
+ * `deriveBrandColorVariants`). Returns `undefined` when no brand color is set or
+ * it can't be parsed, so a bad host value never crashes a block.
+ */
+export declare function resolveBrandVariant(brandColor: string | undefined, tone: BrandTone): BrandVariant | undefined;
+/**
+ * Fill treatment: paint the container with the brand color and the text with its
+ * paired accessible color. Both reuse the `brand`/`primary` token slots and only
+ * override their values — the slot is just where the override attaches.
+ */
+export declare function brandFillStyling(brand: BrandVariant): Styling;
+/**
+ * Border treatment: color a transparent surface's border with the brand color.
+ * Text keeps its default color (it sits on the page, not the brand surface). The
+ * caller supplies the `borderWidth` (a full outline vs. a single-side accent).
+ */
+export declare function brandBorderStyling(brand: BrandVariant, borderWidth: NonNullable<ViewProps['borderWidth']>): Styling;
+/** Assemble the final render props from a resolved styling and layout. */
+export declare function toRenderProps(styling: Styling, layout: Layout): BlockRenderProps;
+export {};
+//# sourceMappingURL=brandTheming.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brandTheming.d.ts","sourceRoot":"","sources":["../../../src/components/blocks/brandTheming.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAG3C,KAAK,SAAS,GAAG,cAAc,CAAC,OAAO,IAAI,CAAC,CAAA;AAC5C,KAAK,iBAAiB,GAAG,SAAS,CAAC,eAAe,CAAC,CAAA;AAEnD;;;;GAIG;AACH,KAAK,sBAAsB,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,iBAAiB,GAAG,mBAAmB,CAAA;AAE9F;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE;QACJ,UAAU,EAAE,WAAW,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAA;QAChD,WAAW,EAAE,WAAW,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAA;QAClD,WAAW,EAAE,SAAS,CAAC,aAAa,CAAC,CAAA;QACrC,YAAY,EAAE,WAAW,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAA;QACpD,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;QAC7B,+DAA+D;QAC/D,aAAa,CAAC,EAAE,iBAAiB,CAAA;KAClC,CAAA;IACD,IAAI,EAAE;QACJ,4EAA4E;QAC5E,KAAK,CAAC,EAAE,cAAc,CAAA;QACtB,mDAAmD;QACnD,aAAa,CAAC,EAAE,sBAAsB,CAAA;KACvC,CAAA;CACF;AAED,yEAAyE;AACzE,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,WAAW,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAA;IAChD,WAAW,EAAE,WAAW,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAA;IAClD,WAAW,EAAE,SAAS,CAAC,aAAa,CAAC,CAAA;IACrC,SAAS,CAAC,EAAE,cAAc,CAAA;CAC3B;AAED,qFAAqF;AACrF,MAAM,WAAW,OAAO;IACtB,UAAU,EAAE,UAAU,CAAA;IACtB,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,iBAAiB,CAAC,EAAE,sBAAsB,CAAA;CAC3C;AAED,kEAAkE;AAClE,MAAM,WAAW,MAAM;IACrB,YAAY,EAAE,WAAW,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAA;IACpD,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;CAC9B;AAED,qFAAqF;AACrF,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/D,0DAA0D;AAC1D,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;AAExC;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,IAAI,EAAE,SAAS,GACd,YAAY,GAAG,SAAS,CAW1B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAW7D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,WAAW,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,GACjD,OAAO,CAKT;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAWhF"}

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

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+/** Corner rounding for a block's container. Used by every block. */
+export declare const CornerStyleSchema: z.ZodEnum<["rounded", "square"]>;
+export type CornerStyle = z.infer<typeof CornerStyleSchema>;
+/** Horizontal alignment for the media blocks (Image, Video). */
+export declare const AlignSchema: z.ZodEnum<["left", "center", "right"]>;
+export type Align = z.infer<typeof AlignSchema>;
+/**
+ * Emphasis a block's surface is decorated with. Used by Text and Accordion.
+ * `neutral` is deliberately never branded — see the block mappers.
+ */
+export declare const ColorThemeSchema: z.ZodEnum<["light", "dark", "neutral"]>;
+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>;
+//# sourceMappingURL=commonSchemas.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,19 @@
+import { View } from '@instructure/ui-view';
+import { ComponentProps } from 'react';
+import { Align } from './commonSchemas';
+type ViewProps = ComponentProps<typeof View>;
+/** Horizontal alignment as a `View` `textAlign` token. */
+export declare const ALIGN_TEXT: Record<Align, NonNullable<ViewProps['textAlign']>>;
+/**
+ * What a media block's mapper returns: InstUI `View` tokens plus the two values
+ * InstUI has no token for — `width` (percentage) and `aspectRatio` — which the
+ * block applies as plain layout CSS.
+ */
+export interface MediaBlockViewProps {
+    textAlign: NonNullable<ViewProps['textAlign']>;
+    width: string;
+    aspectRatio: string;
+    borderRadius: NonNullable<ViewProps['borderRadius']>;
+}
+export {};
+//# sourceMappingURL=commonViewProps.d.ts.map

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

@@ -0,0 +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"}

package/dist/contexts/BlockEditorApiContext.d.ts

@@ -0,0 +1,63 @@
+/**
+ * A resolved image asset. `url` is the direct, displayable file URL (rendered
+ * in `<img>`); `undefined` while loading or on error.
+ */
+export interface ResolvedImage {
+    url?: string;
+    isLoading: boolean;
+    isError: boolean;
+}
+/**
+ * A resolved video asset. `url` is the media-player embed URL — the host builds
+ * it (a block must not construct a host-specific URL), rendered in an
+ * `<iframe>`; `undefined` while loading, processing, or on error.
+ *
+ * The status flags `isLoading` / `isProcessing` / `isError` are mutually
+ * exclusive: the host reports at most one as `true` (all false/absent means
+ * "ready", with `url` populated). `mediaEntryId` is emitted as `data-media-id`
+ * so host scripts can target the iframe.
+ */
+export interface ResolvedVideo {
+    url?: string;
+    displayName?: string;
+    mediaEntryId?: string;
+    isLoading: boolean;
+    isProcessing?: boolean;
+    isError: boolean;
+}
+export type UseImageUrl = (assetId: string) => ResolvedImage;
+export type UseVideoUrl = (assetId: string) => ResolvedVideo;
+/**
+ * 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
+ * react-query) and any host-specific URL construction (e.g. the video
+ * media-embed iframe URL) — a block only ever renders a URL the host resolved,
+ * never builds a host route — so the package stays host-agnostic. One provider
+ * carries every host API the blocks need; add a hook here as new blocks need
+ * host data (e.g. `useAudioUrl`). Each hook is optional: a host wires only the
+ * hooks for the blocks it uses, and an unprovided hook falls back to an error
+ * result rather than crashing. Because they are hooks, blocks call them
+ * unconditionally once per render, so the host hooks must obey the rules of hooks
+ * — and the *set* of provided hooks must stay stable for a mounted provider:
+ * toggling a field between defined and undefined across renders flips which hook
+ * a block calls and breaks the rules of hooks (mount the provider once with a
+ * 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
+ * and nothing outside it, so a hook that fetches for `''` only wastes a request.
+ */
+export interface BlockEditorApi {
+    useImageUrl?: UseImageUrl;
+    useVideoUrl?: UseVideoUrl;
+}
+export declare const BlockEditorApiContext: import('react').Context<BlockEditorApi>;
+export declare const BlockEditorApiProvider: import('react').Provider<BlockEditorApi>;
+/** Resolve an image asset id via the host-provided `useImageUrl` hook. */
+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;
+//# sourceMappingURL=BlockEditorApiContext.d.ts.map

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

@@ -0,0 +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"}

package/dist/contexts/BrandColorContext.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The host institution's brand color as a hex or `rgb()/rgba()` string, or
+ * `undefined` when the host provides none. Blocks derive accessible light/dark
+ * variants from it (see `deriveBrandColorVariants`) and apply them through
+ * InstUI's per-component `themeOverride`. The host (e.g. the editor) provides
+ * the value; consumers that don't theme leave the default `undefined`.
+ */
+export declare const BrandColorContext: import('react').Context<string | undefined>;
+export declare const useBrandColor: () => string | undefined;
+//# sourceMappingURL=BrandColorContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BrandColorContext.d.ts","sourceRoot":"","sources":["../../src/contexts/BrandColorContext.tsx"],"names":[],"mappings":"AAoBA;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,6CAA+C,CAAA;AAE7E,eAAO,MAAM,aAAa,QAAO,MAAM,GAAG,SAA0C,CAAA"}

package/dist/contexts/DesignerModeContext.d.ts

@@ -0,0 +1,8 @@
+/**
+ * True when a block is rendered inside the editor/designer canvas, false when
+ * rendered for display. The host (e.g. the editor) provides `true`; consumers
+ * that just render content leave the default `false`.
+ */
+export declare const DesignerModeContext: import('react').Context<boolean>;
+export declare const useDesignerMode: () => boolean;
+//# sourceMappingURL=DesignerModeContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DesignerModeContext.d.ts","sourceRoot":"","sources":["../../src/contexts/DesignerModeContext.tsx"],"names":[],"mappings":"AAoBA;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,kCAAuB,CAAA;AAEvD,eAAO,MAAM,eAAe,QAAO,OAA0C,CAAA"}

package/dist/contexts/TranslationsContext.d.ts

@@ -0,0 +1,70 @@
+import { ReactNode } from 'react';
+/**
+ * Translate function for dynamic interpolation. The consuming app provides this
+ * to handle i18n with variable substitution.
+ *
+ * `key` is a key of `BlockContentEditorTranslations`, not an English source string —
+ * the host resolves it against its own translations map, then substitutes `%{name}`
+ * placeholders in the resulting value.
+ *
+ * Example: with `accordionItemPlaceholderTitle: 'Accordion %{index}'`,
+ * translate('accordionItemPlaceholderTitle', { index: 2 }) => 'Accordion 2'
+ */
+export type TranslateFunction = (key: string, options?: Record<string, unknown>) => string;
+/**
+ * Translation keys used by the block content editor. The consuming app is
+ * responsible for providing translated strings (see `locales/en.json`).
+ */
+export interface BlockContentEditorTranslations {
+    /** Placeholder shown in the designer when a Text block has no content. */
+    placeholderContent: string;
+    /** Placeholder heading shown in the designer when a Banner block is empty. */
+    bannerPlaceholderTitle: string;
+    /** Placeholder eyebrow shown in the designer when a Banner block is empty. */
+    bannerPlaceholderSubtitle: string;
+    /** Placeholder quote shown in the designer when a Quote block has no content. */
+    quotePlaceholderContent: string;
+    /** Placeholder author shown in the designer when a Quote block has no content. */
+    quotePlaceholderAuthor: string;
+    /** Placeholder code shown in the designer when a CodeBlock has no content. */
+    codeBlockPlaceholder: string;
+    /** Placeholder shown in the designer when an ImageBlock has no image. */
+    imageBlockPlaceholder: string;
+    /** Announced while an ImageBlock's image is loading. */
+    imageBlockLoading: string;
+    /** Shown when an ImageBlock's image fails to load. */
+    imageBlockError: string;
+    /** 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;
+    /** Placeholder shown in the designer when an Accordion has no sections at all. */
+    accordionPlaceholder: string;
+    /** Placeholder title for an empty Accordion section; interpolates `%{index}` via `translate`. */
+    accordionItemPlaceholderTitle: string;
+    /** Placeholder body shown in the designer when an Accordion section has no content. */
+    accordionItemPlaceholderContent: string;
+    [key: string]: string;
+}
+export interface BlockContentEditorTranslationsContext {
+    translations: BlockContentEditorTranslations;
+    translate: TranslateFunction;
+}
+export interface TranslationsProviderProps {
+    translations: BlockContentEditorTranslations;
+    translate: TranslateFunction;
+    children: ReactNode;
+}
+export declare function TranslationsProvider({ translations, translate, children, }: TranslationsProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useTranslations(): BlockContentEditorTranslationsContext;
+//# sourceMappingURL=TranslationsContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TranslationsContext.d.ts","sourceRoot":"","sources":["../../src/contexts/TranslationsContext.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAAiB,KAAK,SAAS,EAAc,MAAM,OAAO,CAAA;AAEjE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAA;AAE1F;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,0EAA0E;IAC1E,kBAAkB,EAAE,MAAM,CAAA;IAC1B,8EAA8E;IAC9E,sBAAsB,EAAE,MAAM,CAAA;IAC9B,8EAA8E;IAC9E,yBAAyB,EAAE,MAAM,CAAA;IACjC,iFAAiF;IACjF,uBAAuB,EAAE,MAAM,CAAA;IAC/B,kFAAkF;IAClF,sBAAsB,EAAE,MAAM,CAAA;IAC9B,8EAA8E;IAC9E,oBAAoB,EAAE,MAAM,CAAA;IAC5B,yEAAyE;IACzE,qBAAqB,EAAE,MAAM,CAAA;IAC7B,wDAAwD;IACxD,iBAAiB,EAAE,MAAM,CAAA;IACzB,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAA;IACvB,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;IACvB,kFAAkF;IAClF,oBAAoB,EAAE,MAAM,CAAA;IAC5B,iGAAiG;IACjG,6BAA6B,EAAE,MAAM,CAAA;IACrC,uFAAuF;IACvF,+BAA+B,EAAE,MAAM,CAAA;IAEvC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,qCAAqC;IACpD,YAAY,EAAE,8BAA8B,CAAA;IAC5C,SAAS,EAAE,iBAAiB,CAAA;CAC7B;AAMD,MAAM,WAAW,yBAAyB;IACxC,YAAY,EAAE,8BAA8B,CAAA;IAC5C,SAAS,EAAE,iBAAiB,CAAA;IAC5B,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,wBAAgB,oBAAoB,CAAC,EACnC,YAAY,EACZ,SAAS,EACT,QAAQ,GACT,EAAE,yBAAyB,2CAG3B;AAED,wBAAgB,eAAe,IAAI,qCAAqC,CAMvE"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export * from './components/blocks/Accordion';
+export * from './components/blocks/Text';
+export * from './components/blocks/Banner';
+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 { 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 * from './schema';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}