@instructure/platform-block-content-editor 0.3.1

package/dist/schema/index.d.ts

@@ -0,0 +1,5 @@
+export { parseDescription, type ZodFormMetadata, type ZodRangeConfig, type ZodHiddenWhenConfig, type ZodDisabledWhenConfig, } from './zodExtensions';
+export { validateComponentSchema, type ValidationError, type ValidationIssue, type ValidationResult, } from './schemaValidator';
+export { registerComponentSchema, type RegisteredComponentSchema, } from './registeredSchema';
+export { FormFieldType, type FormFieldMetadata, unwrapZodType, deriveFieldType, extractValidationRules, extractFieldMetadata, extractFormMetadata, } from './zodUtils';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schema/index.ts"],"names":[],"mappings":"AAmBA,OAAO,iBAAiB,CAAA;AAExB,OAAO,EACL,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EACL,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,uBAAuB,EACvB,KAAK,yBAAyB,GAC/B,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EACL,aAAa,EACb,KAAK,iBAAiB,EACtB,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,YAAY,CAAA"}

package/dist/schema/registeredSchema.d.ts

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+/**
+ * Brand symbol to mark validated component schemas
+ * This symbol is never instantiated - it only exists in the type system
+ */
+declare const __registeredComponentSchema: unique symbol;
+/**
+ * A Zod schema that has been validated for component registration
+ *
+ * This branded type can only be created via registerComponentSchema(),
+ * which validates that the schema meets all requirements:
+ * - All visible fields have .zodLabel()
+ * - Hidden fields (with .zodHidden()) are exempt
+ * - No z.any() / z.unknown() / z.custom() without .zodHidden()
+ *
+ * @template T - The inferred TypeScript type from the Zod schema
+ */
+export type RegisteredComponentSchema<T> = z.ZodType<T> & {
+    readonly [__registeredComponentSchema]: true;
+};
+/**
+ * Creates a RegisteredComponentSchema from a Zod schema
+ *
+ * Validates the schema meets all requirements for form generation and brands it
+ * as a RegisteredComponentSchema. Throws TypeError if validation fails.
+ *
+ * @template T - The inferred TypeScript type from the Zod schema
+ * @param schema - The Zod object schema to validate and register
+ * @param componentName - Name of the component (for error messages)
+ * @returns The validated and branded schema
+ * @throws {TypeError} If the schema doesn't meet registration requirements
+ *
+ * @example
+ * ```typescript
+ * const TextPropsSchema = z.object({
+ *   content: z.string().zodLabel('Content'),
+ * })
+ *
+ * export const RegisteredTextPropsSchema = registerComponentSchema(
+ *   TextPropsSchema,
+ *   'Text'
+ * )
+ * ```
+ */
+export declare function registerComponentSchema<T extends z.ZodRawShape>(schema: z.ZodObject<T>, componentName: string): RegisteredComponentSchema<z.infer<z.ZodObject<T>>>;
+export {};
+//# sourceMappingURL=registeredSchema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registeredSchema.d.ts","sourceRoot":"","sources":["../../src/schema/registeredSchema.ts"],"names":[],"mappings":"AAkBA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAG5B;;;GAGG;AACH,OAAO,CAAC,MAAM,2BAA2B,EAAE,OAAO,MAAM,CAAA;AAExD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,yBAAyB,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;IACxD,QAAQ,CAAC,CAAC,2BAA2B,CAAC,EAAE,IAAI,CAAA;CAC7C,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAC7D,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EACtB,aAAa,EAAE,MAAM,GACpB,yBAAyB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAgBpD"}

package/dist/schema/schemaValidator.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+/**
+ * Types of validation issues
+ */
+export type ValidationIssue = 'missing-label' | 'invalid-type' | 'missing-metadata';
+/**
+ * A single validation error for a field
+ */
+export interface ValidationError {
+    /** Field name (or nested path like "theme.primary") */
+    field: string;
+    /** Type of issue */
+    issue: ValidationIssue;
+    /** Human-readable error message */
+    message: string;
+}
+/**
+ * Result of schema validation
+ */
+export interface ValidationResult {
+    /** Whether the schema passed all validation checks */
+    valid: boolean;
+    /** List of validation errors (empty if valid) */
+    errors: ValidationError[];
+}
+/**
+ * Validates that a component schema meets registration requirements
+ *
+ * Requirements:
+ * - Schema must be a ZodObject (z.object({...}))
+ * - All visible fields must have .zodLabel()
+ * - Hidden fields (with .zodHidden()) are exempt
+ * - No z.any() / z.unknown() / z.custom() without .zodHidden()
+ *
+ * @param schema - The Zod schema to validate
+ * @param componentName - Name of the component (for error messages)
+ * @returns Validation result with any errors found
+ */
+export declare function validateComponentSchema<T>(schema: z.ZodType<T>, componentName: string): ValidationResult;
+//# sourceMappingURL=schemaValidator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemaValidator.d.ts","sourceRoot":"","sources":["../../src/schema/schemaValidator.ts"],"names":[],"mappings":"AAkBA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,cAAc,GAAG,kBAAkB,CAAA;AAEnF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAA;IACb,oBAAoB;IACpB,KAAK,EAAE,eAAe,CAAA;IACtB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,KAAK,EAAE,OAAO,CAAA;IACd,iDAAiD;IACjD,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1B;AA2FD;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,aAAa,EAAE,MAAM,GACpB,gBAAgB,CAyBlB"}

package/dist/schema/zodExtensions.d.ts

@@ -0,0 +1,137 @@
+import { z } from 'zod';
+/**
+ * Metadata stored in Zod schema descriptions for form generation
+ */
+export interface ZodRangeConfig {
+    min: number;
+    max: number;
+    step?: number;
+    formatValue?: string;
+}
+export interface ZodHiddenWhenConfig {
+    field: string;
+    values: string[];
+}
+export interface ZodDisabledWhenConfig {
+    field: string;
+    value: boolean;
+}
+export interface ZodFormMetadata {
+    label?: string;
+    placeholder?: string;
+    help?: string;
+    hidden?: boolean;
+    hiddenWhen?: ZodHiddenWhenConfig | ZodHiddenWhenConfig[];
+    disabledWhen?: ZodDisabledWhenConfig | ZodDisabledWhenConfig[];
+    textarea?: boolean;
+    richtext?: boolean;
+    range?: ZodRangeConfig;
+    codeeditor?: boolean;
+    image?: boolean;
+    video?: boolean;
+    description?: string;
+    itemLabel?: string;
+    itemName?: string;
+    manageLayer?: string;
+    answers?: boolean;
+    altText?: boolean;
+}
+/**
+ * Parse metadata from a Zod schema description
+ */
+export declare function parseDescription(description?: string): ZodFormMetadata;
+/**
+ * Extend Zod with custom methods for form UI hints
+ */
+declare module 'zod' {
+    interface ZodType<Output = any, Def extends z.ZodTypeDef = z.ZodTypeDef, Input = Output> {
+        /**
+         * Add a human-readable label for form field generation
+         * @example z.string().zodLabel('Email Address')
+         */
+        zodLabel(label: string): this;
+        /**
+         * Add placeholder text for input fields
+         * @example z.string().zodPlaceholder('Enter your email')
+         */
+        zodPlaceholder(placeholder: string): this;
+        /**
+         * Add help text or tooltip content
+         * @example z.string().zodHelp('We will never share your email')
+         */
+        zodHelp(help: string): this;
+        /**
+         * Mark field as hidden from auto-generated forms
+         * Useful for fields managed by custom components (like gcpUploadKey)
+         * @example z.string().optional().zodHidden()
+         */
+        zodHidden(hidden?: boolean): this;
+        /**
+         * Mark string field as a multi-line textarea input.
+         * @example z.string().zodTextarea().zodLabel('Description')
+         */
+        zodTextarea(textarea?: boolean): this;
+        /**
+         * Mark string field as rich text (HTML) for rendering with RCE editor
+         * @example z.string().zodRichText().zodLabel('Content')
+         */
+        zodRichText(richtext?: boolean): this;
+        /**
+         * Mark number field as a range slider input
+         * @example z.number().zodRange({ min: 0, max: 100, step: 25, formatValue: '%' }).zodLabel('Size')
+         */
+        zodRange(config: ZodRangeConfig): this;
+        /**
+         * Mark string field as a code editor with syntax highlighting
+         * @example z.string().zodCodeEditor().zodLabel('Code')
+         */
+        zodCodeEditor(codeeditor?: boolean): this;
+        /**
+         * Mark string field as an image upload field
+         * @example z.string().zodImage().zodLabel('Image')
+         */
+        zodImage(image?: boolean): this;
+        /**
+         * Mark string field as a video upload field
+         * @example z.string().zodVideo().zodLabel('Video')
+         */
+        zodVideo(video?: boolean): this;
+        /**
+         * Conditionally hide this field when another field has one of the specified values
+         * @example z.string().zodHiddenWhen({ field: 'style', values: ['folder'] })
+         */
+        zodHiddenWhen(config: ZodHiddenWhenConfig): this;
+        /**
+         * Conditionally disable this field when another boolean field equals the given value
+         * @example z.string().zodDisabledWhen({ field: 'isDecorative', value: true })
+         */
+        zodDisabledWhen(config: ZodDisabledWhenConfig): this;
+        /**
+         * Specify which field in array object items to use as the display label
+         * @example z.array(z.object({ title: z.string(), content: z.string() })).zodItemLabel('title')
+         */
+        zodItemLabel(fieldName: string): this;
+        /**
+         * Specify custom text for the "Add" button in arrays of objects
+         * @example z.array(itemSchema).zodItemName('question').zodLabel('Questions')
+         */
+        zodItemName(name: string): this;
+        /**
+         * Opt an array-of-objects field into the host's manage-layer collapse behavior,
+         * labelled with the given plural noun
+         * @example z.array(itemSchema).zodManageLayer('Accordions').zodLabel('Accordions (up to 10)')
+         */
+        zodManageLayer(pluralLabel: string): this;
+        /**
+         * Mark array field as answer options that require special inline editing with position labels and correct/incorrect toggles
+         * @example z.array(answerSchema).zodAnswers().zodLabel('Answer options')
+         */
+        zodAnswers(answers?: boolean): this;
+        /**
+         * Mark string field as an alt text input with AI generation support
+         * @example z.string().zodAltText().zodLabel('Alt Text')
+         */
+        zodAltText(altText?: boolean): this;
+    }
+}
+//# sourceMappingURL=zodExtensions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zodExtensions.d.ts","sourceRoot":"","sources":["../../src/schema/zodExtensions.ts"],"names":[],"mappings":"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"}

package/dist/schema/zodUtils.d.ts

@@ -0,0 +1,90 @@
+import { z } from 'zod';
+import { ZodFormMetadata } from './zodExtensions';
+/**
+ * Unwraps ZodOptional, ZodDefault, ZodNullable wrappers to get the inner type
+ *
+ * This is useful for validation and form generation to access the actual field type
+ * without being confused by wrapper types.
+ *
+ * @param zodType - The Zod type to unwrap
+ * @returns The unwrapped inner type
+ *
+ * @example
+ * ```typescript
+ * const optionalString = z.string().optional()
+ * const unwrapped = unwrapZodType(optionalString)
+ * // unwrapped is z.string()
+ * ```
+ */
+export declare function unwrapZodType(zodType: z.ZodTypeAny): z.ZodTypeAny;
+/**
+ * Form field types that can be generated from Zod schemas
+ */
+export declare enum FormFieldType {
+    TEXT = "text",
+    TEXTAREA = "textarea",
+    NUMBER = "number",
+    RANGE = "range",
+    BOOLEAN = "boolean",
+    SELECT = "select",
+    RICHTEXT = "richtext",
+    IMAGE = "image",
+    VIDEO = "video",
+    ALTTEXT = "alttext",
+    ASSET = "asset",
+    ARRAY = "array",
+    CODEEDITOR = "codeeditor",
+    OBJECT = "object",
+    ANSWERS = "answers",
+    UNKNOWN = "unknown"
+}
+/**
+ * Form field metadata extracted from Zod schema
+ */
+export interface FormFieldMetadata extends ZodFormMetadata {
+    name: string;
+    type: FormFieldType;
+    required: boolean;
+    defaultValue?: unknown;
+    options?: Array<{
+        value: string | number;
+        label: string;
+    }>;
+    validation?: {
+        min?: number;
+        max?: number;
+        /** Characters for a string field, items for an array field — read it with `type`. */
+        minLength?: number;
+        /** Characters for a string field, items for an array field — read it with `type`. */
+        maxLength?: number;
+        pattern?: string;
+        email?: boolean;
+        url?: boolean;
+    };
+    /** For array types - the raw Zod schema of array items */
+    itemSchema?: z.ZodTypeAny;
+    /** For array types with object items - extracted form metadata for each item property */
+    itemProperties?: Record<string, FormFieldMetadata>;
+    /** For object types */
+    properties?: Record<string, FormFieldMetadata>;
+}
+/**
+ * Derive form field type from Zod type
+ */
+export declare function deriveFieldType(zodType: z.ZodTypeAny): FormFieldType;
+/**
+ * Extract validation rules from Zod schema
+ */
+export declare function extractValidationRules(zodType: z.ZodTypeAny): FormFieldMetadata['validation'];
+/**
+ * Extract form metadata from a single Zod field
+ */
+export declare function extractFieldMetadata(name: string, zodType: z.ZodTypeAny): FormFieldMetadata;
+/**
+ * Extract form metadata from Zod object schema
+ *
+ * This is the main function for generating forms from Zod schemas.
+ * It returns metadata for each field that can be used to render form inputs.
+ */
+export declare function extractFormMetadata(schema: z.ZodObject<z.ZodRawShape>): Record<string, FormFieldMetadata>;
+//# sourceMappingURL=zodUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zodUtils.d.ts","sourceRoot":"","sources":["../../src/schema/zodUtils.ts"],"names":[],"mappings":"AAkBA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAExE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAajE;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,UAAU,eAAe;IACzB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,aAAa,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC1D,UAAU,CAAC,EAAE;QACX,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,GAAG,CAAC,EAAE,MAAM,CAAA;QACZ,qFAAqF;QACrF,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,qFAAqF;QACrF,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,GAAG,CAAC,EAAE,OAAO,CAAA;KACd,CAAA;IACD,0DAA0D;IAC1D,UAAU,CAAC,EAAE,CAAC,CAAC,UAAU,CAAA;IACzB,yFAAyF;IACzF,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;IAClD,uBAAuB;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;CAC/C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,UAAU,GAAG,aAAa,CAyEpE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,CAAC,CAAC,UAAU,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAsD7F;AA+FD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,UAAU,GAAG,iBAAiB,CAmD3F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,GACjC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CASnC"}

package/dist/schema/zodUtils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=zodUtils.test.d.ts.map

package/dist/schema/zodUtils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zodUtils.test.d.ts","sourceRoot":"","sources":["../../src/schema/zodUtils.test.ts"],"names":[],"mappings":""}

package/dist/utils/colorVariants/brandColorVariants.d.ts

@@ -0,0 +1,25 @@
+import { ColorVariants } from './types';
+/**
+ * Dark-variant anchor lightness for brand colors — the lightest the dark variant
+ * may be, so a brand fill reads as a genuinely dark surface regardless of the
+ * input's own lightness (the search still darkens further for bright hues that
+ * need it for AA). Tune this to make brand dark variants lighter/darker.
+ */
+export declare const BRAND_DARK_LIGHTNESS = 0.3;
+/**
+ * Text color placed on the light brand variant — InstUI's `grey125125`
+ * (`#273540`), the canvas primary dark font color — so a light brand fill reads
+ * with the same body text color as the rest of the UI rather than pure black.
+ */
+export declare const BRAND_DARK_TEXT = "#273540";
+/**
+ * Derives accessible light and dark variants of a brand color at the WCAG
+ * thresholds: AA (4.5:1) for text on each variant, and non-text (3:1) between
+ * the two variants so they stay distinguishable when rendered adjacent. The dark
+ * variant is anchored dark ([[BRAND_DARK_LIGHTNESS]]) for a consistent surface,
+ * and the light variant carries the InstUI primary font color ([[BRAND_DARK_TEXT]]).
+ *
+ * @param brandColor - Brand color as hex or rgb()/rgba().
+ */
+export declare function deriveBrandColorVariants(brandColor: string): ColorVariants;
+//# sourceMappingURL=brandColorVariants.d.ts.map

package/dist/utils/colorVariants/brandColorVariants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brandColorVariants.d.ts","sourceRoot":"","sources":["../../../src/utils/colorVariants/brandColorVariants.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAG5C;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,MAAM,CAAA;AAEvC;;;;GAIG;AACH,eAAO,MAAM,eAAe,YAAY,CAAA;AAExC;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAO1E"}

package/dist/utils/colorVariants/brandColorVariants.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=brandColorVariants.test.d.ts.map

package/dist/utils/colorVariants/brandColorVariants.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brandColorVariants.test.d.ts","sourceRoot":"","sources":["../../../src/utils/colorVariants/brandColorVariants.test.ts"],"names":[],"mappings":""}

package/dist/utils/colorVariants/color.d.ts

@@ -0,0 +1,21 @@
+import { Rgb } from './types';
+/**
+ * Parses a `#rgb`, `#rrggbb`, `rgb(r, g, b)`, or `rgba(r, g, b, a)` string into
+ * RGB channels. Throws on any other format.
+ */
+export declare function parseColor(input: string): Rgb;
+/** Serializes RGB channels to a `#rrggbb` hex string. */
+export declare function rgbToHex({ r, g, b }: Rgb): string;
+/** Converts RGB (0–255) to HSL with each component in the 0–1 range. */
+export declare function rgbToHsl({ r, g, b }: Rgb): {
+    h: number;
+    s: number;
+    l: number;
+};
+/** Converts HSL (each component 0–1) to RGB (0–255). */
+export declare function hslToRgb(h: number, s: number, l: number): Rgb;
+/** WCAG relative luminance of an RGB color. */
+export declare function relativeLuminance({ r, g, b }: Rgb): number;
+/** WCAG contrast ratio (1–21) between two colors. */
+export declare function contrastRatio(a: Rgb, b: Rgb): number;
+//# sourceMappingURL=color.d.ts.map

package/dist/utils/colorVariants/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../../src/utils/colorVariants/color.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAMlC;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAsB7C;AAOD,yDAAyD;AACzD,wBAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM,CAEjD;AAED,wEAAwE;AACxE,wBAAgB,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CA0B9E;AAED,wDAAwD;AACxD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,GAAG,CAuB7D;AAED,+CAA+C;AAC/C,wBAAgB,iBAAiB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM,CAM1D;AAED,qDAAqD;AACrD,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,MAAM,CAMpD"}

package/dist/utils/colorVariants/color.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=color.test.d.ts.map

package/dist/utils/colorVariants/color.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.test.d.ts","sourceRoot":"","sources":["../../../src/utils/colorVariants/color.test.ts"],"names":[],"mappings":""}

package/dist/utils/colorVariants/deriveColorVariants.d.ts

@@ -0,0 +1,41 @@
+import { ColorVariants } from './types';
+export interface ColorVariantThresholds {
+    /** Minimum contrast each variant must reach against its own text color. */
+    minTextContrast: number;
+    /**
+     * Minimum contrast required between the light and dark colors. Omit to skip
+     * this check (relevant only when the two variants are rendered adjacent).
+     */
+    minVariantContrast?: number;
+    /** Text color placed on the light variant. Defaults to black. */
+    darkText?: string;
+    /** Text color placed on the dark variant. Defaults to white. */
+    lightText?: string;
+    /**
+     * Anchor lightness (0–1) for the light variant — the lightest it may be. The
+     * search only lightens further if the text contrast target isn't met. Defaults
+     * to a pale tint.
+     */
+    lightLightness?: number;
+    /**
+     * Anchor lightness (0–1) for the dark variant — the lightest it may be. The
+     * search only darkens further if a contrast target isn't met. Lower this for a
+     * consistently darker surface. Defaults to mid-dark.
+     */
+    darkLightness?: number;
+}
+/**
+ * Derives a light and a dark variant of a color, both kept on its hue, by
+ * moving lightness along that hue until the given contrast thresholds are met.
+ *
+ * The light variant is lightened until the dark text reaches `minTextContrast`.
+ * The dark variant is darkened until the light text reaches `minTextContrast`
+ * and, when `minVariantContrast` is set, the two variants are that far apart
+ * from each other. Each search stops at its lightness clamp if a threshold is
+ * unreachable; the achieved ratios are reported so callers can detect that.
+ *
+ * @param baseColor - Source color as hex or rgb()/rgba().
+ * @param thresholds - Contrast targets and the text colors each variant carries.
+ */
+export declare function deriveColorVariants(baseColor: string, thresholds: ColorVariantThresholds): ColorVariants;
+//# sourceMappingURL=deriveColorVariants.d.ts.map

package/dist/utils/colorVariants/deriveColorVariants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deriveColorVariants.d.ts","sourceRoot":"","sources":["../../../src/utils/colorVariants/deriveColorVariants.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAiB5C,MAAM,WAAW,sBAAsB;IACrC,2EAA2E;IAC3E,eAAe,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,sBAAsB,GACjC,aAAa,CAgDf"}

package/dist/utils/colorVariants/deriveColorVariants.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=deriveColorVariants.test.d.ts.map

package/dist/utils/colorVariants/deriveColorVariants.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deriveColorVariants.test.d.ts","sourceRoot":"","sources":["../../../src/utils/colorVariants/deriveColorVariants.test.ts"],"names":[],"mappings":""}

package/dist/utils/colorVariants/index.d.ts

@@ -0,0 +1,3 @@
+export { deriveBrandColorVariants } from './brandColorVariants';
+export type { ColorVariant, ColorVariants } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/colorVariants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/colorVariants/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAC/D,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA"}

package/dist/utils/colorVariants/types.d.ts

@@ -0,0 +1,21 @@
+/** RGB channels, each 0–255. */
+export interface Rgb {
+    r: number;
+    g: number;
+    b: number;
+}
+export interface ColorVariant {
+    /** Derived color as a `#rrggbb` hex string. */
+    color: string;
+    /** Text color this variant is designed to carry, as hex. */
+    textColor: string;
+    /** WCAG contrast ratio of `textColor` on `color`, rounded to 2dp. */
+    contrast: number;
+}
+export interface ColorVariants {
+    light: ColorVariant;
+    dark: ColorVariant;
+    /** WCAG contrast ratio between the light and dark colors, rounded to 2dp. */
+    variantContrast: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/utils/colorVariants/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/utils/colorVariants/types.ts"],"names":[],"mappings":"AAkBA,gCAAgC;AAChC,MAAM,WAAW,GAAG;IAClB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAA;IACjB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,YAAY,CAAA;IACnB,IAAI,EAAE,YAAY,CAAA;IAClB,6EAA6E;IAC7E,eAAe,EAAE,MAAM,CAAA;CACxB"}

package/dist/utils/colorVariants/wcag.d.ts

@@ -0,0 +1,10 @@
+/** Minimum WCAG 2.1 contrast ratios. */
+export declare const WCAG_CONTRAST: {
+    /** AA, normal-size text (below 18pt, or 14pt bold). */
+    readonly AA_NORMAL_TEXT: 4.5;
+    /** AA, large text (18pt+, or 14pt+ bold). */
+    readonly AA_LARGE_TEXT: 3;
+    /** 1.4.11, UI components and graphical objects against adjacent colors. */
+    readonly NON_TEXT: 3;
+};
+//# sourceMappingURL=wcag.d.ts.map

package/dist/utils/colorVariants/wcag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wcag.d.ts","sourceRoot":"","sources":["../../../src/utils/colorVariants/wcag.ts"],"names":[],"mappings":"AAkBA,wCAAwC;AACxC,eAAO,MAAM,aAAa;IACxB,uDAAuD;;IAEvD,6CAA6C;;IAE7C,2EAA2E;;CAEnE,CAAA"}

package/dist/utils/safeMediaUrl.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Guard a URL for use as the `src` of an `<img>` / `<iframe>` media element.
+ * Allowed: absolute http(s) URLs and same-origin relative paths (`/...`).
+ * Everything else — `javascript:`, `data:`, `blob:`, `file:`, other schemes,
+ * protocol-relative (`//host`) and backslash-escaped (`/\host`) URLs — is
+ * rejected. Intentionally stricter than a general URL sanitizer (no
+ * `mailto:`/`tel:`), which is the posture a media embed needs.
+ */
+export declare function isSafeMediaUrl(url: string | undefined | null): url is string;
+//# sourceMappingURL=safeMediaUrl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"safeMediaUrl.d.ts","sourceRoot":"","sources":["../../src/utils/safeMediaUrl.ts"],"names":[],"mappings":"AAoBA;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,GAAG,IAAI,MAAM,CAmB5E"}

package/dist/utils/safeMediaUrl.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=safeMediaUrl.test.d.ts.map

package/dist/utils/safeMediaUrl.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safeMediaUrl.test.d.ts","sourceRoot":"","sources":["../../src/utils/safeMediaUrl.test.ts"],"names":[],"mappings":""}

package/dist/utils/wordWrap.d.ts

@@ -0,0 +1,16 @@
+import { CSSProperties } from 'react';
+/**
+ * Keeps text a block doesn't control — a pasted URL, a long title, a host translation —
+ * from escaping the block: under CSS's initial `overflow-wrap: normal` a word wider than
+ * its container overflows, and a block never knows how narrow a host renders it.
+ *
+ * Goes on a plain element wrapping the content, because InstUI's `passthroughProps` drops
+ * `style` from `View`; the property inherits from there to every descendant. `break-word`
+ * rather than `anywhere` stays out of min-content sizing, and anything declaring its own
+ * `white-space` (CodeBlock's `pre`) is left to scroll instead.
+ *
+ * Deliberately not a `white-space` reset: text refusing to wrap at spaces means a host
+ * stylesheet is leaking `nowrap` in, which is the host's to fix.
+ */
+export declare const BLOCK_WORD_WRAP: CSSProperties;
+//# sourceMappingURL=wordWrap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wordWrap.d.ts","sourceRoot":"","sources":["../../src/utils/wordWrap.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAE1C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,EAAE,aAA8C,CAAA"}

package/locales/en.json

@@ -0,0 +1,21 @@
+{
+  "placeholderContent": "Your content here...",
+  "bannerPlaceholderTitle": "Your banner",
+  "bannerPlaceholderSubtitle": "Your optional eyebrow text",
+  "quotePlaceholderContent": "Your quote here",
+  "quotePlaceholderAuthor": "Author",
+  "codeBlockPlaceholder": "// Your code here",
+  "imageBlockPlaceholder": "Add image...",
+  "imageBlockLoading": "Loading image...",
+  "imageBlockError": "Failed to load image",
+  "videoBlockPlaceholder": "Add video...",
+  "videoBlockLoading": "Loading video...",
+  "videoBlockError": "Failed to load video",
+  "videoBlockUnsupportedProvider": "Unsupported video provider",
+  "videoBlockProcessing": "Video is processing",
+  "videoBlockProcessingSubtitle": "Once video is done processing, block will update. This could take a few minutes.",
+  "videoBlockTitle": "Video",
+  "accordionPlaceholder": "Add accordion...",
+  "accordionItemPlaceholderTitle": "Accordion %{index}",
+  "accordionItemPlaceholderContent": "Your content here..."
+}