@sharedex/ui 0.0.0-stage → 0.9.0

package/dist/schema/helpers.js

@@ -0,0 +1,183 @@
+/** Every option's default (auto options are left out, as a factory call would). */
+export function defaultsOf(schema) {
+    const out = {};
+    for (const [key, field] of Object.entries(schema.fields)) {
+        if (field.default !== undefined)
+            out[key] = field.default;
+    }
+    return out;
+}
+/** Where the factory sits in its entry: `["waterRipple"]`, or `["presence", "contract"]` (imported as `presence`). */
+export function factoryPath(schema) {
+    return schema.factory.split(".");
+}
+/**
+ * What a call to the factory passes: the options object, or with `args` the
+ * options in that order (`pagedBy(3)`), trailing unset ones left off.
+ */
+export function factoryArgs(schema, options) {
+    if (!schema.args)
+        return [options];
+    const out = schema.args.map((key) => options[key]);
+    while (out.length > 0 && out[out.length - 1] === undefined)
+        out.pop();
+    return out;
+}
+/** Deep equality for option values (numbers, strings, booleans, arrays, plain objects). */
+export function sameValue(a, b) {
+    if (Object.is(a, b))
+        return true;
+    if (Array.isArray(a) && Array.isArray(b))
+        return a.length === b.length && a.every((v, i) => sameValue(v, b[i]));
+    if (a && b && typeof a === "object" && typeof b === "object" && !Array.isArray(a) && !Array.isArray(b)) {
+        const ka = Object.keys(a).filter((k) => a[k] !== undefined);
+        const kb = Object.keys(b).filter((k) => b[k] !== undefined);
+        return ka.length === kb.length && ka.every((k) => sameValue(a[k], b[k]));
+    }
+    return false;
+}
+/**
+ * Only what differs from the defaults: `undefined` and values equal to a
+ * field's `default` are dropped (an auto option keeps any value it is given),
+ * in the schema's field order. What a config stores and a generator writes.
+ */
+export function sparseOptions(schema, value) {
+    const out = {};
+    for (const [key, field] of Object.entries(schema.fields)) {
+        const v = value[key];
+        if (v === undefined)
+            continue;
+        if (field.default !== undefined && sameValue(v, field.default))
+            continue;
+        out[key] = v;
+    }
+    return out;
+}
+const COLOR = /^(#[0-9a-f]{3,4}|#[0-9a-f]{6}|#[0-9a-f]{8}|transparent|currentcolor|[a-z]+|(rgba?|hsla?|hwb|lab|lch|oklab|oklch|color|color-mix|var|light-dark)\(.+\))$/i;
+/** A CSS colour as a config may hold one: a theme token, `color-mix()`, a hex or functional colour, a keyword. */
+export function isColor(value) {
+    return typeof value === "string" && COLOR.test(value.trim());
+}
+const isNumber = (v) => typeof v === "number" && Number.isFinite(v);
+const PERCENT = /^-?\d+(\.\d+)?%$/;
+function fieldErrors(path, field, v, lookup) {
+    const bad = (what) => [`${path}: ${what}`];
+    switch (field.kind) {
+        case "number":
+            if (!isNumber(v))
+                return bad("must be a number");
+            if (v < field.min || v > field.max)
+                return bad(`must be between ${field.min} and ${field.max}`);
+            return [];
+        case "integer":
+        case "seed":
+            if (!isNumber(v) || !Number.isInteger(v))
+                return bad("must be a whole number");
+            if (field.kind === "integer" && (v < field.min || v > field.max))
+                return bad(`must be between ${field.min} and ${field.max}`);
+            return [];
+        case "boolean":
+            return typeof v === "boolean" ? [] : bad("must be true or false");
+        case "choice":
+            return (typeof v === "string" || typeof v === "number") && field.values.includes(v) ? [] : bad(`must be one of ${field.values.join(", ")}`);
+        case "color":
+            return isColor(v) ? [] : bad("must be a CSS colour");
+        case "colors":
+            if (!Array.isArray(v))
+                return bad("must be a list of colours");
+            if (v.length < field.min || v.length > field.max)
+                return bad(`must have ${field.min} to ${field.max} colours`);
+            return v.every(isColor) ? [] : bad("every entry must be a CSS colour");
+        case "range":
+            if (!Array.isArray(v) || v.length !== 2 || !v.every(isNumber))
+                return bad("must be two numbers");
+            const [lo, hi] = v;
+            if (lo > hi)
+                return bad("the first number must not be above the second");
+            if (lo < field.min || hi > field.max)
+                return bad(`must stay between ${field.min} and ${field.max}`);
+            return [];
+        case "text":
+            if (typeof v !== "string")
+                return bad("must be text");
+            if (field.url && v.trim() === "")
+                return bad("must not be empty");
+            return [];
+        case "texts":
+            if (!Array.isArray(v) || !v.every((x) => typeof x === "string"))
+                return bad("must be a list of texts");
+            if (v.length < field.min || v.length > field.max)
+                return bad(`must have ${field.min} to ${field.max} entries`);
+            return [];
+        case "point":
+            if (typeof v === "string")
+                return field.keywords.includes(v) ? [] : bad(`must be one of ${field.keywords.join(", ")}, or [x, y]`);
+            if (!Array.isArray(v) || v.length !== 2 || !v.every(isNumber))
+                return bad(`must be one of ${field.keywords.join(", ")}, or [x, y]`);
+            return v.every((n) => n >= 0 && n <= 1) ? [] : bad("x and y must be between 0 and 1");
+        case "vector": {
+            if (!Array.isArray(v) || v.length !== field.labels.length)
+                return bad(`must be ${field.labels.length} numbers`);
+            for (const n of v) {
+                const num = field.percent && typeof n === "string" && PERCENT.test(n) ? Number.parseFloat(n) : n;
+                if (!isNumber(num))
+                    return bad(field.percent ? "every entry must be a number or a percentage" : "every entry must be a number");
+                if (num < field.min || num > field.max)
+                    return bad(`every entry must be between ${field.min} and ${field.max}`);
+            }
+            return [];
+        }
+        case "group": {
+            if (v === false && field.off)
+                return [];
+            if (!v || typeof v !== "object" || Array.isArray(v))
+                return bad(field.off ? "must be an object, or false" : "must be an object");
+            return objectErrors(path, field.fields, v, lookup);
+        }
+        case "effect": {
+            const e = v;
+            if (!e || typeof e !== "object" || typeof e.id !== "string")
+                return bad("must be { id, options }");
+            const schema = lookup?.(field.family, e.id);
+            if (lookup && !schema)
+                return bad(`"${e.id}" is not a ${field.family}`);
+            if (!schema)
+                return [];
+            if (field.mode && schema.meta?.modes && !schema.meta.modes.includes(field.mode))
+                return bad(`"${e.id}" can't play as a ${field.mode}`);
+            if (field.kinds && !field.kinds.includes(schema.meta?.family ?? ""))
+                return bad(`"${e.id}" must be ${field.kinds.join(" or ")}`);
+            return objectErrors(`${path}.options`, schema.fields, (e.options ?? {}), lookup);
+        }
+    }
+}
+function objectErrors(path, fields, value, lookup) {
+    const errors = [];
+    for (const [key, v] of Object.entries(value)) {
+        const field = fields[key];
+        const at = path ? `${path}.${key}` : key;
+        if (!field)
+            errors.push(`${at}: not an option`);
+        else if (v !== undefined)
+            errors.push(...fieldErrors(at, field, v, lookup));
+    }
+    return errors;
+}
+/**
+ * The required options still missing (an image without its `src`). Kept apart
+ * from `validateOptions`: a design may hold a half-configured piece while it
+ * is being edited; a builder warns, an export writes a placeholder.
+ */
+export function missingRequired(schema, value) {
+    return Object.entries(schema.fields)
+        .filter(([key, field]) => field.required && (value[key] === undefined || value[key] === ""))
+        .map(([key]) => key);
+}
+/**
+ * Readable problems with a set of options, empty when they are fine: unknown
+ * keys (including the code-only ones, which a config can't hold), wrong
+ * types, values out of range or not among the choices, malformed colours.
+ */
+export function validateOptions(schema, value, lookup) {
+    return objectErrors("", schema.fields, value, lookup);
+}

package/dist/schema/index.d.ts

@@ -0,0 +1,41 @@
+import { BACKGROUND_SCHEMAS } from "./backgrounds.js";
+import { REVEAL_SCHEMAS, TRANSITION_SCHEMAS } from "./transitions.js";
+import { CAROUSEL_LAYOUT_SCHEMAS, CAROUSEL_MODIFIER_SCHEMAS, CAROUSEL_OPEN_SCHEMAS, CAROUSEL_PHYSICS_SCHEMAS, CAROUSEL_PRESENCE_SCHEMAS, CAROUSEL_SCHEMAS } from "./carousel.js";
+import { TICKER_SCHEMAS } from "./ticker.js";
+import { GRID_OPEN_SCHEMAS, GRID_SCHEMAS } from "./grid.js";
+import { SCROLL_SCHEMAS } from "./scroll.js";
+import { BUTTON_SCHEMAS } from "./buttons.js";
+import { TEXT_SCHEMAS } from "./text.js";
+import { NUMBER_ROLL_SCHEMAS, TYPEWRITER_SCHEMAS, WORD_CYCLE_SCHEMAS } from "./textParts.js";
+import type { Schema, SchemaFamily } from "./types.js";
+export type { Field, FieldKind, FieldFor, NumberField, IntegerField, SeedField, BooleanField, ChoiceField, ColorField, ColorsField, TextsField, RangeField, TextField, PointField, VectorField, EffectField, GroupField, EffectValue, Schema, SchemaEntry, SchemaFamily, SchemaMeta, } from "./types.js";
+export { SCHEMA_FAMILIES } from "./types.js";
+export { defineSchema } from "./define.js";
+export { layerFields, speedField, seedField, colorsField, shaderFallbackField, buttonFillFields } from "./common.js";
+export { defaultsOf, sparseOptions, validateOptions, missingRequired, sameValue, isColor, factoryPath, factoryArgs } from "./helpers.js";
+export type { SchemaLookup } from "./helpers.js";
+export { BACKGROUND_SCHEMAS, TRANSITION_SCHEMAS, REVEAL_SCHEMAS };
+export { CAROUSEL_LAYOUT_SCHEMAS, CAROUSEL_MODIFIER_SCHEMAS, CAROUSEL_PRESENCE_SCHEMAS, CAROUSEL_OPEN_SCHEMAS, CAROUSEL_PHYSICS_SCHEMAS, CAROUSEL_SCHEMAS, };
+export { CAROUSEL_SECTIONS } from "./carousel.js";
+export type { CarouselSection, CarouselSettings } from "./carousel.js";
+export { TICKER_SCHEMAS, GRID_SCHEMAS, GRID_OPEN_SCHEMAS, SCROLL_SCHEMAS, BUTTON_SCHEMAS, TEXT_SCHEMAS, WORD_CYCLE_SCHEMAS, NUMBER_ROLL_SCHEMAS, TYPEWRITER_SCHEMAS };
+export type { TickerDrive, TickerSettings } from "./ticker.js";
+export type { GridSettings } from "./grid.js";
+/** The carousel's own settings (`<Carousel.Root config>` as one flat form). */
+export declare const CAROUSEL_SETTINGS: Schema;
+/** A Ticker's props as one form (`fade` in px, `drive` in place of `offset`). */
+export declare const TICKER_SETTINGS: Schema;
+/** `Grid.Root`'s props as one form (`columns` unset = `"auto"`). */
+export declare const GRID_SETTINGS: Schema;
+/** `WordCycle`'s props as one form (the Hero's `titleCycle`; the words are content). */
+export declare const WORD_CYCLE_SETTINGS: Schema;
+/** `Typewriter`'s props as one form (the lines come from the page). */
+export declare const TYPEWRITER_SETTINGS: Schema;
+/** `NumberRoll`'s props as one form (About's `statRoll`; the value comes from each figure). */
+export declare const NUMBER_ROLL_SETTINGS: Schema;
+/** Every family's schemas, keyed by piece id. Families without schemas yet are empty. */
+export declare const SCHEMAS: {
+    readonly [F in SchemaFamily]: Readonly<Record<string, Schema>>;
+};
+/** One piece's schema, or `undefined`. */
+export declare function schemaOf(family: SchemaFamily, id: string): Schema | undefined;

package/dist/schema/index.js

@@ -0,0 +1,61 @@
+// ---------------------------------------------------------------------------
+// @sharedex/ui/schema — every configurable piece's options, as data.
+//
+// For tools (the Design System Builder): a form renders a schema, a config
+// stores only what differs from the defaults (`sparseOptions`), and a
+// generator writes `factory(options)` back. No React, no DOM, no effect code.
+// ---------------------------------------------------------------------------
+import { BACKGROUND_SCHEMAS } from "./backgrounds.js";
+import { REVEAL_SCHEMAS, TRANSITION_SCHEMAS } from "./transitions.js";
+import { CAROUSEL_LAYOUT_SCHEMAS, CAROUSEL_MODIFIER_SCHEMAS, CAROUSEL_OPEN_SCHEMAS, CAROUSEL_PHYSICS_SCHEMAS, CAROUSEL_PRESENCE_SCHEMAS, CAROUSEL_SCHEMAS, } from "./carousel.js";
+import { TICKER_SCHEMAS } from "./ticker.js";
+import { GRID_OPEN_SCHEMAS, GRID_SCHEMAS } from "./grid.js";
+import { SCROLL_SCHEMAS } from "./scroll.js";
+import { BUTTON_SCHEMAS } from "./buttons.js";
+import { TEXT_SCHEMAS } from "./text.js";
+import { NUMBER_ROLL_SCHEMAS, TYPEWRITER_SCHEMAS, WORD_CYCLE_SCHEMAS } from "./textParts.js";
+export { SCHEMA_FAMILIES } from "./types.js";
+export { defineSchema } from "./define.js";
+export { layerFields, speedField, seedField, colorsField, shaderFallbackField, buttonFillFields } from "./common.js";
+export { defaultsOf, sparseOptions, validateOptions, missingRequired, sameValue, isColor, factoryPath, factoryArgs } from "./helpers.js";
+export { BACKGROUND_SCHEMAS, TRANSITION_SCHEMAS, REVEAL_SCHEMAS };
+export { CAROUSEL_LAYOUT_SCHEMAS, CAROUSEL_MODIFIER_SCHEMAS, CAROUSEL_PRESENCE_SCHEMAS, CAROUSEL_OPEN_SCHEMAS, CAROUSEL_PHYSICS_SCHEMAS, CAROUSEL_SCHEMAS, };
+export { CAROUSEL_SECTIONS } from "./carousel.js";
+export { TICKER_SCHEMAS, GRID_SCHEMAS, GRID_OPEN_SCHEMAS, SCROLL_SCHEMAS, BUTTON_SCHEMAS, TEXT_SCHEMAS, WORD_CYCLE_SCHEMAS, NUMBER_ROLL_SCHEMAS, TYPEWRITER_SCHEMAS };
+/** The carousel's own settings (`<Carousel.Root config>` as one flat form). */
+export const CAROUSEL_SETTINGS = CAROUSEL_SCHEMAS["carousel"];
+/** A Ticker's props as one form (`fade` in px, `drive` in place of `offset`). */
+export const TICKER_SETTINGS = TICKER_SCHEMAS["ticker"];
+/** `Grid.Root`'s props as one form (`columns` unset = `"auto"`). */
+export const GRID_SETTINGS = GRID_SCHEMAS["grid"];
+/** `WordCycle`'s props as one form (the Hero's `titleCycle`; the words are content). */
+export const WORD_CYCLE_SETTINGS = WORD_CYCLE_SCHEMAS["wordCycle"];
+/** `Typewriter`'s props as one form (the lines come from the page). */
+export const TYPEWRITER_SETTINGS = TYPEWRITER_SCHEMAS["typewriter"];
+/** `NumberRoll`'s props as one form (About's `statRoll`; the value comes from each figure). */
+export const NUMBER_ROLL_SETTINGS = NUMBER_ROLL_SCHEMAS["numberRoll"];
+/** Every family's schemas, keyed by piece id. Families without schemas yet are empty. */
+export const SCHEMAS = {
+    background: BACKGROUND_SCHEMAS,
+    transition: TRANSITION_SCHEMAS,
+    reveal: REVEAL_SCHEMAS,
+    "carousel-layout": CAROUSEL_LAYOUT_SCHEMAS,
+    "carousel-modifier": CAROUSEL_MODIFIER_SCHEMAS,
+    "carousel-presence": CAROUSEL_PRESENCE_SCHEMAS,
+    "carousel-open": CAROUSEL_OPEN_SCHEMAS,
+    "carousel-physics": CAROUSEL_PHYSICS_SCHEMAS,
+    carousel: CAROUSEL_SCHEMAS,
+    ticker: TICKER_SCHEMAS,
+    grid: GRID_SCHEMAS,
+    "grid-open": GRID_OPEN_SCHEMAS,
+    scroll: SCROLL_SCHEMAS,
+    button: BUTTON_SCHEMAS,
+    text: TEXT_SCHEMAS,
+    "word-cycle": WORD_CYCLE_SCHEMAS,
+    typewriter: TYPEWRITER_SCHEMAS,
+    "number-roll": NUMBER_ROLL_SCHEMAS,
+};
+/** One piece's schema, or `undefined`. */
+export function schemaOf(family, id) {
+    return SCHEMAS[family][id];
+}

package/dist/schema/scroll.d.ts

@@ -0,0 +1,2 @@
+import type { Schema } from "./types.js";
+export declare const SCROLL_SCHEMAS: Readonly<Record<string, Schema>>;

package/dist/schema/scroll.js

@@ -0,0 +1,16 @@
+// The scroll compositions' option schemas (`transitions/scroll/`): components tied to the page scroll. Their
+// content (sections, cards, a picture, a word, the text) is the page's, so it is listed as code. Imports only
+// schema files.
+import { CURTAIN_SCHEMA } from "../transitions/scroll/Curtain.schema.js";
+import { STACK_CARDS_SCHEMA } from "../transitions/scroll/StackCards.schema.js";
+import { PINNED_EXPAND_SCHEMA } from "../transitions/scroll/PinnedExpand.schema.js";
+import { TEXT_MASK_ZOOM_SCHEMA } from "../transitions/scroll/TextMaskZoom.schema.js";
+import { SPLIT_TEXT_SCHEMA } from "../transitions/scroll/SplitText.schema.js";
+const keyed = (list) => Object.fromEntries(list.map(([schema, meta]) => [schema.id, { ...schema, meta }]));
+export const SCROLL_SCHEMAS = keyed([
+    [CURTAIN_SCHEMA, { label: "Curtain: each section slides off the next" }],
+    [STACK_CARDS_SCHEMA, { label: "Stacked cards" }],
+    [PINNED_EXPAND_SCHEMA, { label: "Picture opening to full screen" }],
+    [TEXT_MASK_ZOOM_SCHEMA, { label: "Picture through growing text" }],
+    [SPLIT_TEXT_SCHEMA, { label: "Text line by line" }],
+]);

package/dist/schema/text.d.ts

@@ -0,0 +1,3 @@
+import type { Schema } from "./types.js";
+/** Every text effect's schema, with its registry metadata, in registry order. Throws if one is missing (caught by the tests). */
+export declare const TEXT_SCHEMAS: Readonly<Record<string, Schema>>;

package/dist/schema/text.js

@@ -0,0 +1,150 @@
+// The text effects' option schemas, keyed by id, in the order of TEXT_EFFECTS. Imports only the schema files and
+// the registry, which import only types: this entry carries no effect code. Each schema gets its registry metadata here.
+import { TEXT_EFFECTS } from "../text/registry.js";
+import { ENTER_RISE_SCHEMA } from "../text/effects/enter/enterRise.schema.js";
+import { ENTER_WORDS_SCHEMA } from "../text/effects/enter/enterWords.schema.js";
+import { ENTER_MASK_SCHEMA } from "../text/effects/enter/enterMask.schema.js";
+import { ENTER_BLUR_SCHEMA } from "../text/effects/enter/enterBlur.schema.js";
+import { ENTER_BOUNCE_SCHEMA } from "../text/effects/enter/enterBounce.schema.js";
+import { ENTER_FLIP_SCHEMA } from "../text/effects/enter/enterFlip.schema.js";
+import { ENTER_POP_SCHEMA } from "../text/effects/enter/enterPop.schema.js";
+import { ENTER_RANDOM_SCHEMA } from "../text/effects/enter/enterRandom.schema.js";
+import { ENTER_BOX_SCHEMA } from "../text/effects/enter/enterBox.schema.js";
+import { ENTER_TRACKING_SCHEMA } from "../text/effects/enter/enterTracking.schema.js";
+import { ENTER_ASSEMBLE_SCHEMA } from "../text/effects/enter/enterAssemble.schema.js";
+import { ENTER_STAMP_SCHEMA } from "../text/effects/enter/enterStamp.schema.js";
+import { ENTER_REDACT_SCHEMA } from "../text/effects/enter/enterRedact.schema.js";
+import { ENTER_SKELETON_SCHEMA } from "../text/effects/enter/enterSkeleton.schema.js";
+import { INK_SHINY_SCHEMA } from "../text/effects/ink/inkShiny.schema.js";
+import { INK_GRADIENT_SCHEMA } from "../text/effects/ink/inkGradient.schema.js";
+import { INK_AURORA_SCHEMA } from "../text/effects/ink/inkAurora.schema.js";
+import { INK_VIDEO_SCHEMA } from "../text/effects/ink/inkVideo.schema.js";
+import { INK_IMAGE_SCHEMA } from "../text/effects/ink/inkImage.schema.js";
+import { INK_SPARKLES_SCHEMA } from "../text/effects/ink/inkSparkles.schema.js";
+import { INK_LINE_SHADOW_SCHEMA } from "../text/effects/ink/inkLineShadow.schema.js";
+import { INK_NEON_SCHEMA } from "../text/effects/ink/inkNeon.schema.js";
+import { INK_COLOURFUL_SCHEMA } from "../text/effects/ink/inkColourful.schema.js";
+import { INK_LINES_SCHEMA } from "../text/effects/ink/inkLines.schema.js";
+import { INK_GRAIN_SCHEMA } from "../text/effects/ink/inkGrain.schema.js";
+import { INK_SWEEP_SCHEMA } from "../text/effects/ink/inkSweep.schema.js";
+import { INK_FOIL_SCHEMA } from "../text/effects/ink/inkFoil.schema.js";
+import { INK_PROGRESS_SCHEMA } from "../text/effects/ink/inkProgress.schema.js";
+import { INK_DOTS_SCHEMA } from "../text/effects/ink/inkDots.schema.js";
+import { STROKE_FILL_SCHEMA } from "../text/effects/stroke/strokeFill.schema.js";
+import { STROKE_HANDWRITE_SCHEMA } from "../text/effects/stroke/strokeHandwrite.schema.js";
+import { STROKE_DRAW_SCHEMA } from "../text/effects/stroke/strokeDraw.schema.js";
+import { STROKE_GRADIENT_SCHEMA } from "../text/effects/stroke/strokeGradient.schema.js";
+import { STROKE_COMIC_SCHEMA } from "../text/effects/stroke/strokeComic.schema.js";
+import { STROKE_UNDERLINE_SCHEMA } from "../text/effects/stroke/strokeUnderline.schema.js";
+import { STROKE_NOTE_SCHEMA } from "../text/effects/stroke/strokeNote.schema.js";
+import { DECODE_HOVER_SCHEMA } from "../text/effects/decode/decodeHover.schema.js";
+import { DECODE_REVEAL_SCHEMA } from "../text/effects/decode/decodeReveal.schema.js";
+import { DECODE_BINARY_SCHEMA } from "../text/effects/decode/decodeBinary.schema.js";
+import { SCRUB_HIGHLIGHT_SCHEMA } from "../text/effects/scrub/scrubHighlight.schema.js";
+import { SCRUB_PARALLAX_SCHEMA } from "../text/effects/scrub/scrubParallax.schema.js";
+import { SCRUB_PIN_SCHEMA } from "../text/effects/scrub/scrubPin.schema.js";
+import { SCRUB_MARKER_SCHEMA } from "../text/effects/scrub/scrubMarker.schema.js";
+import { SCRUB_FLOAT_SCHEMA } from "../text/effects/scrub/scrubFloat.schema.js";
+import { SCRUB_SKEW_SCHEMA } from "../text/effects/scrub/scrubSkew.schema.js";
+import { SCRUB_CYLINDER_SCHEMA } from "../text/effects/scrub/scrubCylinder.schema.js";
+import { POINTER_PROXIMITY_SCHEMA } from "../text/effects/pointer/pointerProximity.schema.js";
+import { POINTER_PRESSURE_SCHEMA } from "../text/effects/pointer/pointerPressure.schema.js";
+import { POINTER_JELLO_SCHEMA } from "../text/effects/pointer/pointerJello.schema.js";
+import { POINTER_WAVE_SCHEMA } from "../text/effects/pointer/pointerWave.schema.js";
+import { POINTER_SPOTLIGHT_SCHEMA } from "../text/effects/pointer/pointerSpotlight.schema.js";
+import { POINTER_SHADOW_SCHEMA } from "../text/effects/pointer/pointerShadow.schema.js";
+import { POINTER_TRAIL_SCHEMA } from "../text/effects/pointer/pointerTrail.schema.js";
+import { POINTER_RIPPLE_SCHEMA } from "../text/effects/pointer/pointerRipple.schema.js";
+import { POINTER_TILT_SCHEMA } from "../text/effects/pointer/pointerTilt.schema.js";
+import { POINTER_ROLL_SCHEMA } from "../text/effects/pointer/pointerRoll.schema.js";
+import { WARP_GLITCH_SCHEMA } from "../text/effects/warp/warpGlitch.schema.js";
+import { WARP_SQUIGGLE_SCHEMA } from "../text/effects/warp/warpSquiggle.schema.js";
+import { WARP_WAVE_SCHEMA } from "../text/effects/warp/warpWave.schema.js";
+import { WARP_GOO_SCHEMA } from "../text/effects/warp/warpGoo.schema.js";
+import { WARP_RGB_SCHEMA } from "../text/effects/warp/warpRgb.schema.js";
+import { WARP_SHADER_SCHEMA } from "../text/effects/warp/warpShader.schema.js";
+import { WARP_FUZZ_SCHEMA } from "../text/effects/warp/warpFuzz.schema.js";
+import { WARP_ASCII_SCHEMA } from "../text/effects/warp/warpAscii.schema.js";
+import { SOLID_SHADOW_SCHEMA } from "../text/effects/solid/solidShadow.schema.js";
+import { SOLID_LAYERS_SCHEMA } from "../text/effects/solid/solidLayers.schema.js";
+import { SOLID_PARTICLES_SCHEMA } from "../text/effects/solid/solidParticles.schema.js";
+import { SOLID_ECHO_SCHEMA } from "../text/effects/solid/solidEcho.schema.js";
+import { SOLID_FALL_SCHEMA } from "../text/effects/solid/solidFall.schema.js";
+const BY_ID = {
+    enterRise: ENTER_RISE_SCHEMA,
+    enterWords: ENTER_WORDS_SCHEMA,
+    enterMask: ENTER_MASK_SCHEMA,
+    enterBlur: ENTER_BLUR_SCHEMA,
+    enterBounce: ENTER_BOUNCE_SCHEMA,
+    enterFlip: ENTER_FLIP_SCHEMA,
+    enterPop: ENTER_POP_SCHEMA,
+    enterRandom: ENTER_RANDOM_SCHEMA,
+    enterBox: ENTER_BOX_SCHEMA,
+    enterTracking: ENTER_TRACKING_SCHEMA,
+    enterAssemble: ENTER_ASSEMBLE_SCHEMA,
+    enterStamp: ENTER_STAMP_SCHEMA,
+    enterRedact: ENTER_REDACT_SCHEMA,
+    enterSkeleton: ENTER_SKELETON_SCHEMA,
+    decodeHover: DECODE_HOVER_SCHEMA,
+    decodeReveal: DECODE_REVEAL_SCHEMA,
+    decodeBinary: DECODE_BINARY_SCHEMA,
+    scrubHighlight: SCRUB_HIGHLIGHT_SCHEMA,
+    scrubParallax: SCRUB_PARALLAX_SCHEMA,
+    scrubPin: SCRUB_PIN_SCHEMA,
+    scrubMarker: SCRUB_MARKER_SCHEMA,
+    scrubFloat: SCRUB_FLOAT_SCHEMA,
+    scrubSkew: SCRUB_SKEW_SCHEMA,
+    scrubCylinder: SCRUB_CYLINDER_SCHEMA,
+    inkShiny: INK_SHINY_SCHEMA,
+    inkGradient: INK_GRADIENT_SCHEMA,
+    inkAurora: INK_AURORA_SCHEMA,
+    inkVideo: INK_VIDEO_SCHEMA,
+    inkImage: INK_IMAGE_SCHEMA,
+    inkSparkles: INK_SPARKLES_SCHEMA,
+    inkLineShadow: INK_LINE_SHADOW_SCHEMA,
+    inkNeon: INK_NEON_SCHEMA,
+    inkColourful: INK_COLOURFUL_SCHEMA,
+    inkLines: INK_LINES_SCHEMA,
+    inkGrain: INK_GRAIN_SCHEMA,
+    inkSweep: INK_SWEEP_SCHEMA,
+    inkFoil: INK_FOIL_SCHEMA,
+    inkProgress: INK_PROGRESS_SCHEMA,
+    inkDots: INK_DOTS_SCHEMA,
+    strokeFill: STROKE_FILL_SCHEMA,
+    strokeHandwrite: STROKE_HANDWRITE_SCHEMA,
+    strokeDraw: STROKE_DRAW_SCHEMA,
+    strokeGradient: STROKE_GRADIENT_SCHEMA,
+    strokeComic: STROKE_COMIC_SCHEMA,
+    strokeUnderline: STROKE_UNDERLINE_SCHEMA,
+    strokeNote: STROKE_NOTE_SCHEMA,
+    pointerProximity: POINTER_PROXIMITY_SCHEMA,
+    pointerPressure: POINTER_PRESSURE_SCHEMA,
+    pointerJello: POINTER_JELLO_SCHEMA,
+    pointerWave: POINTER_WAVE_SCHEMA,
+    pointerSpotlight: POINTER_SPOTLIGHT_SCHEMA,
+    pointerShadow: POINTER_SHADOW_SCHEMA,
+    pointerTrail: POINTER_TRAIL_SCHEMA,
+    pointerRipple: POINTER_RIPPLE_SCHEMA,
+    pointerTilt: POINTER_TILT_SCHEMA,
+    pointerRoll: POINTER_ROLL_SCHEMA,
+    warpGlitch: WARP_GLITCH_SCHEMA,
+    warpSquiggle: WARP_SQUIGGLE_SCHEMA,
+    warpWave: WARP_WAVE_SCHEMA,
+    warpGoo: WARP_GOO_SCHEMA,
+    warpRgb: WARP_RGB_SCHEMA,
+    warpShader: WARP_SHADER_SCHEMA,
+    warpFuzz: WARP_FUZZ_SCHEMA,
+    warpAscii: WARP_ASCII_SCHEMA,
+    solidShadow: SOLID_SHADOW_SCHEMA,
+    solidLayers: SOLID_LAYERS_SCHEMA,
+    solidParticles: SOLID_PARTICLES_SCHEMA,
+    solidEcho: SOLID_ECHO_SCHEMA,
+    solidFall: SOLID_FALL_SCHEMA,
+};
+/** Every text effect's schema, with its registry metadata, in registry order. Throws if one is missing (caught by the tests). */
+export const TEXT_SCHEMAS = Object.fromEntries(TEXT_EFFECTS.map((m) => {
+    const schema = BY_ID[m.id];
+    if (!schema)
+        throw new Error(`[@sharedex/ui] no schema for text effect "${m.id}"`);
+    return [m.id, { ...schema, meta: { label: m.label, category: m.group, family: m.tech, tier: m.tier } }];
+}));

package/dist/schema/textParts.d.ts

@@ -0,0 +1,4 @@
+import type { Schema } from "./types.js";
+export declare const WORD_CYCLE_SCHEMAS: Readonly<Record<string, Schema>>;
+export declare const NUMBER_ROLL_SCHEMAS: Readonly<Record<string, Schema>>;
+export declare const TYPEWRITER_SCHEMAS: Readonly<Record<string, Schema>>;

package/dist/schema/textParts.js

@@ -0,0 +1,8 @@
+// The text components a section can carry: the Hero's cycling word (WordCycle), About's rolling figures
+// (NumberRoll), and the Typewriter, their props as forms. Imports only the schema files.
+import { WORD_CYCLE_SCHEMA } from "../text/cycle/WordCycle.schema.js";
+import { NUMBER_ROLL_SCHEMA } from "../text/number/NumberRoll.schema.js";
+import { TYPEWRITER_SCHEMA } from "../text/type/Typewriter.schema.js";
+export const WORD_CYCLE_SCHEMAS = { wordCycle: { ...WORD_CYCLE_SCHEMA, meta: { label: "Cycling word" } } };
+export const NUMBER_ROLL_SCHEMAS = { numberRoll: { ...NUMBER_ROLL_SCHEMA, meta: { label: "Rolling number" } } };
+export const TYPEWRITER_SCHEMAS = { typewriter: { ...TYPEWRITER_SCHEMA, meta: { label: "Typewriter" } } };

package/dist/schema/ticker.d.ts

@@ -0,0 +1,3 @@
+import type { Schema } from "./types.js";
+export declare const TICKER_SCHEMAS: Readonly<Record<string, Schema>>;
+export type { TickerDrive, TickerSettings } from "../ticker/Ticker.schema.js";

package/dist/schema/ticker.js

@@ -0,0 +1,3 @@
+// The Ticker's option schema: its props as one form (`TickerSettings`). Imports only the schema file.
+import { TICKER_SCHEMA } from "../ticker/Ticker.schema.js";
+export const TICKER_SCHEMAS = { ticker: { ...TICKER_SCHEMA, meta: { label: "Ticker" } } };

package/dist/schema/transitions.d.ts

@@ -0,0 +1,5 @@
+import type { Schema } from "./types.js";
+/** Every transition's schema, with its registry metadata, in registry order. Throws if one is missing (caught by the tests). */
+export declare const TRANSITION_SCHEMAS: Readonly<Record<string, Schema>>;
+/** `Reveal`'s props: the section reveal (its `effect` is a transition that plays as a reveal). */
+export declare const REVEAL_SCHEMAS: Readonly<Record<string, Schema>>;

package/dist/schema/transitions.js

@@ -0,0 +1,96 @@
+// The transitions' option schemas, keyed by id, in the order of TRANSITION_EFFECTS, plus the section reveal
+// (`Reveal`'s props). Imports only the schema files and the registry, which import only types: this entry
+// carries no effect code. Each schema gets its registry metadata here (label, group, kind, tier, modes).
+import { TRANSITION_EFFECTS } from "../transitions/registry.js";
+import { REVEAL_SCHEMA } from "../transitions/reveal/Reveal.schema.js";
+import { FADE_SCHEMA } from "../transitions/effects/stage/fade.schema.js";
+import { CUBE_SCHEMA } from "../transitions/effects/stage/cube.schema.js";
+import { FLIP_SCHEMA } from "../transitions/effects/stage/flip.schema.js";
+import { CARDS_SCHEMA } from "../transitions/effects/stage/cards.schema.js";
+import { CREATIVE_SCHEMA } from "../transitions/effects/stage/creative.schema.js";
+import { PUSH_SCHEMA } from "../transitions/effects/stage/push.schema.js";
+import { CARD_STACK_SCHEMA } from "../transitions/effects/stage/cardStack.schema.js";
+import { TINDER_SCHEMA } from "../transitions/effects/stage/tinder.schema.js";
+import { WIPE_SCHEMA } from "../transitions/effects/css/wipe.schema.js";
+import { IRIS_SCHEMA } from "../transitions/effects/css/iris.schema.js";
+import { DIAGONAL_SCHEMA } from "../transitions/effects/css/diagonal.schema.js";
+import { SPLIT_CURTAIN_SCHEMA } from "../transitions/effects/css/splitCurtain.schema.js";
+import { COLOR_BLOCK_SCHEMA } from "../transitions/effects/css/colorBlock.schema.js";
+import { GRADIENT_MASK_SCHEMA } from "../transitions/effects/css/gradientMask.schema.js";
+import { BLUR_SHARP_SCHEMA } from "../transitions/effects/css/blurSharp.schema.js";
+import { PIXEL_GRID_SCHEMA } from "../transitions/effects/css/pixelGrid.schema.js";
+import { SHUTTERS_SCHEMA } from "../transitions/effects/css/shutters.schema.js";
+import { SLICER_SCHEMA } from "../transitions/effects/css/slicer.schema.js";
+import { FADE_UP_SCHEMA } from "../transitions/effects/css/fadeUp.schema.js";
+import { BLUR_FADE_SCHEMA } from "../transitions/effects/css/blurFade.schema.js";
+import { ZOOM_OUT_SCHEMA } from "../transitions/effects/css/zoomOut.schema.js";
+import { BLINDS_SCHEMA } from "../transitions/effects/css/blinds.schema.js";
+import { RANDOM_GRID_SCHEMA } from "../transitions/effects/css/randomGrid.schema.js";
+import { COLUMN_WAVE_SCHEMA } from "../transitions/effects/css/columnWave.schema.js";
+import { INK_SCHEMA } from "../transitions/effects/css/ink.schema.js";
+import { GOOEY_SCHEMA } from "../transitions/effects/css/gooey.schema.js";
+import { DISPLACEMENT_SCHEMA } from "../transitions/effects/shader/displacement.schema.js";
+import { STRETCH_WARP_SCHEMA } from "../transitions/effects/shader/stretchWarp.schema.js";
+import { RIPPLE_SCHEMA } from "../transitions/effects/shader/ripple.schema.js";
+import { CHROMATIC_SHIFT_SCHEMA } from "../transitions/effects/shader/chromaticShift.schema.js";
+import { LIQUID_MORPH_SCHEMA } from "../transitions/effects/shader/liquidMorph.schema.js";
+import { PIXEL_DISSOLVE_SCHEMA } from "../transitions/effects/shader/pixelDissolve.schema.js";
+import { NOISE_BURN_SCHEMA } from "../transitions/effects/shader/noiseBurn.schema.js";
+import { CROSS_ZOOM_SCHEMA } from "../transitions/effects/shader/crossZoom.schema.js";
+import { SWIRL_SCHEMA } from "../transitions/effects/shader/swirl.schema.js";
+import { DREAMY_SCHEMA } from "../transitions/effects/shader/dreamy.schema.js";
+import { DIRECTIONAL_WARP_SCHEMA } from "../transitions/effects/shader/directionalWarp.schema.js";
+import { MORPH_SCHEMA } from "../transitions/effects/shader/morph.schema.js";
+import { GRID_FLIP_SCHEMA } from "../transitions/effects/shader/gridFlip.schema.js";
+import { PAGE_CURL_SCHEMA } from "../transitions/effects/shader/pageCurl.schema.js";
+const BY_ID = {
+    fade: FADE_SCHEMA,
+    cube: CUBE_SCHEMA,
+    flip: FLIP_SCHEMA,
+    cards: CARDS_SCHEMA,
+    creative: CREATIVE_SCHEMA,
+    push: PUSH_SCHEMA,
+    cardStack: CARD_STACK_SCHEMA,
+    tinder: TINDER_SCHEMA,
+    wipe: WIPE_SCHEMA,
+    iris: IRIS_SCHEMA,
+    diagonal: DIAGONAL_SCHEMA,
+    splitCurtain: SPLIT_CURTAIN_SCHEMA,
+    colorBlock: COLOR_BLOCK_SCHEMA,
+    gradientMask: GRADIENT_MASK_SCHEMA,
+    blurSharp: BLUR_SHARP_SCHEMA,
+    pixelGrid: PIXEL_GRID_SCHEMA,
+    shutters: SHUTTERS_SCHEMA,
+    slicer: SLICER_SCHEMA,
+    fadeUp: FADE_UP_SCHEMA,
+    blurFade: BLUR_FADE_SCHEMA,
+    zoomOut: ZOOM_OUT_SCHEMA,
+    blinds: BLINDS_SCHEMA,
+    randomGrid: RANDOM_GRID_SCHEMA,
+    columnWave: COLUMN_WAVE_SCHEMA,
+    ink: INK_SCHEMA,
+    gooey: GOOEY_SCHEMA,
+    displacement: DISPLACEMENT_SCHEMA,
+    stretchWarp: STRETCH_WARP_SCHEMA,
+    ripple: RIPPLE_SCHEMA,
+    chromaticShift: CHROMATIC_SHIFT_SCHEMA,
+    liquidMorph: LIQUID_MORPH_SCHEMA,
+    pixelDissolve: PIXEL_DISSOLVE_SCHEMA,
+    noiseBurn: NOISE_BURN_SCHEMA,
+    crossZoom: CROSS_ZOOM_SCHEMA,
+    swirl: SWIRL_SCHEMA,
+    dreamy: DREAMY_SCHEMA,
+    directionalWarp: DIRECTIONAL_WARP_SCHEMA,
+    morph: MORPH_SCHEMA,
+    gridFlip: GRID_FLIP_SCHEMA,
+    pageCurl: PAGE_CURL_SCHEMA,
+};
+/** Every transition's schema, with its registry metadata, in registry order. Throws if one is missing (caught by the tests). */
+export const TRANSITION_SCHEMAS = Object.fromEntries(TRANSITION_EFFECTS.map((m) => {
+    const schema = BY_ID[m.id];
+    if (!schema)
+        throw new Error(`[@sharedex/ui] no schema for transition "${m.id}"`);
+    return [m.id, { ...schema, meta: { label: m.label, category: m.group, family: m.kind, tier: m.tier, modes: m.modes } }];
+}));
+/** `Reveal`'s props: the section reveal (its `effect` is a transition that plays as a reveal). */
+export const REVEAL_SCHEMAS = { reveal: { ...REVEAL_SCHEMA, meta: { label: "Reveal" } } };