@rezi-ui/core 0.1.0-alpha.7 → 0.1.0-alpha.71

package/dist/layout/types.d.ts

@@ -1,3 +1,4 @@
+import type { ConstraintExpr } from "../constraints/types.js";
 /**
  * packages/core/src/layout/types.ts — Layout primitive type definitions.
  *
@@ -6,6 +7,7 @@
  *
  * @see docs/guide/layout.md
  */
+import type { FluidValue } from "./responsive.js";
 /** Rectangle with position (x,y) and dimensions (w,h) in terminal cells. */
 export type Rect = Readonly<{
     x: number;
@@ -20,24 +22,57 @@ export type Size = Readonly<{
 }>;
 /** Layout axis: row (horizontal) or column (vertical) stacking. */
 export type Axis = "row" | "column";
-/** Size constraint: fixed cell count, percentage of parent size, or "auto". */
-export type SizeConstraint = number | `${number}%` | "auto";
+/** Base size constraint scalar value. */
+export type SizeConstraintAtom = number | "full" | "auto" | ConstraintExpr | FluidValue;
+/** Size constraint: scalar value only (responsive maps are removed in alpha). */
+export type SizeConstraint = SizeConstraintAtom;
+export type LayoutNumericConstraint = number | ConstraintExpr;
+export type DisplayConstraint = boolean | ConstraintExpr;
 /**
  * Generic layout constraints supported by container widgets.
  *
  * Notes:
- * - `width`/`height` are resolved against the parent content size when expressed as percentages.
+ * - `width`/`height` accept fixed values, `full`, `auto`, `fluid(...)`, or `expr(...)`.
  * - `flex` participates in main-axis space distribution inside Row/Column.
  */
 export type LayoutConstraints = Readonly<{
     width?: SizeConstraint;
     height?: SizeConstraint;
-    minWidth?: number;
-    maxWidth?: number;
-    minHeight?: number;
-    maxHeight?: number;
+    minWidth?: LayoutNumericConstraint;
+    maxWidth?: LayoutNumericConstraint;
+    minHeight?: LayoutNumericConstraint;
+    maxHeight?: LayoutNumericConstraint;
     flex?: number;
+    /** Flex shrink factor. How much this child shrinks when siblings overflow. Default 0. */
+    flexShrink?: number;
+    /** Flex basis. Starting main-axis size before grow/shrink. Default "auto" (natural size). */
+    flexBasis?: SizeConstraint;
     /** Width / height ratio (e.g. 2 for 2:1). */
     aspectRatio?: number;
+    /** Per-child cross-axis alignment override. "auto" inherits parent align. */
+    alignSelf?: "auto" | "start" | "center" | "end" | "stretch";
+    /**
+     * Positioning mode.
+     * "absolute" is honored only for children of box/row/column parents; other parents ignore it.
+     */
+    position?: "static" | "absolute";
+    /** Top offset for absolute positioning (cells, box/row/column children only). */
+    top?: number;
+    /** Right offset for absolute positioning (cells, box/row/column children only). */
+    right?: number;
+    /** Bottom offset for absolute positioning (cells, box/row/column children only). */
+    bottom?: number;
+    /** Left offset for absolute positioning (cells, box/row/column children only). */
+    left?: number;
+    /** Grid column start (1-based). Only used when parent is a grid. */
+    gridColumn?: number;
+    /** Grid row start (1-based). Only used when parent is a grid. */
+    gridRow?: number;
+    /** Number of columns to span (default 1). Only used when parent is a grid. */
+    colSpan?: number;
+    /** Number of rows to span (default 1). Only used when parent is a grid. */
+    rowSpan?: number;
+    /** Conditional layout visibility. <= 0 (or false) hides node from layout/render/focus/hit-test. */
+    display?: DisplayConstraint;
 }>;
 //# sourceMappingURL=types.d.ts.map

package/dist/layout/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/layout/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,4EAA4E;AAC5E,MAAM,MAAM,IAAI,GAAG,QAAQ,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE5E,4DAA4D;AAC5D,MAAM,MAAM,IAAI,GAAG,QAAQ,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEtD,mEAAmE;AACnE,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEpC,+EAA+E;AAC/E,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,GAAG,MAAM,GAAG,GAAG,MAAM,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/layout/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,4EAA4E;AAC5E,MAAM,MAAM,IAAI,GAAG,QAAQ,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE5E,4DAA4D;AAC5D,MAAM,MAAM,IAAI,GAAG,QAAQ,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEtD,mEAAmE;AACnE,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEpC,yCAAyC;AACzC,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,cAAc,GAAG,UAAU,CAAC;AACxF,iFAAiF;AACjF,MAAM,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAChD,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,cAAc,CAAC;AAC9D,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,cAAc,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6FAA6F;IAC7F,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;IAC5D;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IACjC,iFAAiF;IACjF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mGAAmG;IACnG,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC7B,CAAC,CAAC"}

package/dist/layout/types.js

@@ -1,10 +1,2 @@
-/**
- * packages/core/src/layout/types.ts — Layout primitive type definitions.
- *
- * Why: Defines the fundamental geometric types used throughout the layout
- * system. All coordinates are in terminal cell units (not pixels).
- *
- * @see docs/guide/layout.md
- */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/layout/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/layout/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/layout/types.ts"],"names":[],"mappings":""}

package/dist/layout/validate/interactive.d.ts

@@ -0,0 +1,106 @@
+import type { ConstraintExpr } from "../../constraints/types.js";
+import type { Align, BoxProps, ButtonProps, CheckboxProps, InputProps, RadioGroupProps, SelectProps, SliderProps, SpacerProps, StackProps, TextProps } from "../../widgets/types.js";
+import type { ValidatedLayoutConstraints } from "./layoutConstraints.js";
+import { type LayoutResult } from "./shared.js";
+import type { ValidatedSpacingProps } from "./spacing.js";
+export type ValidatedStackProps = Readonly<{
+    pad: number;
+    gap: number;
+    align: Align;
+    justify: "start" | "end" | "center" | "between" | "around" | "evenly";
+    overflow: "visible" | "hidden" | "scroll";
+    scrollX: number;
+    scrollY: number;
+} & ValidatedSpacingProps & ValidatedLayoutConstraints>;
+export type ValidatedBoxProps = Readonly<{
+    pad: number;
+    gap: number;
+    border: "none" | "single" | "double" | "rounded" | "heavy" | "dashed" | "heavy-dashed";
+    borderTop: boolean;
+    borderRight: boolean;
+    borderBottom: boolean;
+    borderLeft: boolean;
+    overflow: "visible" | "hidden" | "scroll";
+    scrollX: number;
+    scrollY: number;
+} & ValidatedSpacingProps & ValidatedLayoutConstraints>;
+export type ValidatedSpacerProps = Readonly<{
+    size: number;
+    flex: number;
+}>;
+export type ValidatedButtonProps = Readonly<{
+    id: string;
+    label: string;
+    disabled: boolean;
+}>;
+export type ValidatedInputProps = Readonly<{
+    id: string;
+    value: string;
+    disabled: boolean;
+    readOnly: boolean;
+    multiline: boolean;
+    rows: number;
+    wordWrap: boolean;
+}>;
+export type ValidatedSelectOption = Readonly<{
+    value: string;
+    label: string;
+    disabled: boolean;
+}>;
+export type ValidatedSelectProps = Readonly<{
+    id: string;
+    value: string;
+    options: readonly ValidatedSelectOption[];
+    disabled: boolean;
+    placeholder?: string;
+}>;
+export type ValidatedSliderProps = Readonly<{
+    id: string;
+    value: number;
+    min: number;
+    max: number;
+    step: number;
+    width?: number;
+    label?: string;
+    showValue: boolean;
+    disabled: boolean;
+    readOnly: boolean;
+}>;
+export type ValidatedCheckboxProps = Readonly<{
+    id: string;
+    checked: boolean;
+    label?: string;
+    disabled: boolean;
+}>;
+export type ValidatedRadioGroupProps = Readonly<{
+    id: string;
+    value: string;
+    options: readonly ValidatedSelectOption[];
+    direction: "horizontal" | "vertical";
+    disabled: boolean;
+}>;
+export type ValidatedTextProps = Readonly<{
+    maxWidth?: number | ConstraintExpr;
+    wrap: boolean;
+}>;
+/** Validate Row/Column props: pad (default 0), gap (default 0), align (default "start"). */
+export declare function validateStackProps(kind: "row" | "column", props: StackProps | unknown): LayoutResult<ValidatedStackProps>;
+/** Validate Box props: pad (default 0), border (default "single"). */
+export declare function validateBoxProps(props: BoxProps | unknown): LayoutResult<ValidatedBoxProps>;
+/** Validate Spacer props: size (default 1). */
+export declare function validateSpacerProps(props: SpacerProps | unknown): LayoutResult<ValidatedSpacerProps>;
+/** Validate Button props: id (required), label (required), disabled (default false). */
+export declare function validateButtonProps(props: ButtonProps | unknown): LayoutResult<ValidatedButtonProps>;
+/** Validate Input props: id (required, non-empty), value (required), disabled (default false). */
+export declare function validateInputProps(props: InputProps | unknown): LayoutResult<ValidatedInputProps>;
+/** Validate Select props: id/value/options required; options may be empty. */
+export declare function validateSelectProps(props: SelectProps | unknown): LayoutResult<ValidatedSelectProps>;
+/** Validate Slider props: id/value required; finite range with min<=max and step>0. */
+export declare function validateSliderProps(props: SliderProps | unknown): LayoutResult<ValidatedSliderProps>;
+/** Validate Checkbox props: id and checked required. */
+export declare function validateCheckboxProps(props: CheckboxProps | unknown): LayoutResult<ValidatedCheckboxProps>;
+/** Validate RadioGroup props: id/value/options required; options must be non-empty. */
+export declare function validateRadioGroupProps(props: RadioGroupProps | unknown): LayoutResult<ValidatedRadioGroupProps>;
+/** Validate Text props (`maxWidth` affects measurement; style/overflow are renderer concerns). */
+export declare function validateTextProps(props: TextProps | unknown): LayoutResult<ValidatedTextProps>;
+//# sourceMappingURL=interactive.d.ts.map

package/dist/layout/validate/interactive.d.ts.map

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

package/dist/layout/validate/interactive.js

@@ -0,0 +1,430 @@
+import { resolveResponsiveValue } from "../responsive.js";
+import { validateLayoutConstraints } from "./layoutConstraints.js";
+import { normalizeStringToken, requireBoolean, requireFiniteNumber, requireFlex, requireIntNonNegative, requireNonEmptyString, requireOptionalFiniteNumber, requireOptionalIntNonNegative, requireOptionalString, requireOptionalTextMaxWidth, requireOverflow, requireSpacingIntNonNegative, requireString, } from "./primitives.js";
+import { invalid, requirePropBag } from "./shared.js";
+import { validateSpacingProps } from "./spacing.js";
+/** Validate Row/Column props: pad (default 0), gap (default 0), align (default "start"). */
+export function validateStackProps(kind, props) {
+    const propsRes = requirePropBag(kind, props);
+    if (!propsRes.ok)
+        return propsRes;
+    const p = propsRes.value;
+    const padRes = requireSpacingIntNonNegative(kind, "pad", p.pad, 0);
+    if (!padRes.ok)
+        return padRes;
+    const gapRes = requireSpacingIntNonNegative(kind, "gap", p.gap, 0);
+    if (!gapRes.ok)
+        return gapRes;
+    const alignRaw = resolveResponsiveValue(p.items ?? p.align);
+    const alignValue = alignRaw === undefined ? "start" : normalizeStringToken(alignRaw);
+    if (alignValue !== "start" &&
+        alignValue !== "center" &&
+        alignValue !== "end" &&
+        alignValue !== "stretch") {
+        return invalid(`${kind}.align must be one of "start" | "center" | "end" | "stretch"`);
+    }
+    const justifySource = resolveResponsiveValue(p.justify);
+    const justifyRaw = justifySource === undefined ? "start" : normalizeStringToken(justifySource);
+    const justifyValue = justifyRaw === "space-between"
+        ? "between"
+        : justifyRaw === "space-around"
+            ? "around"
+            : justifyRaw === "space-evenly"
+                ? "evenly"
+                : justifyRaw;
+    if (justifyValue !== "start" &&
+        justifyValue !== "end" &&
+        justifyValue !== "center" &&
+        justifyValue !== "between" &&
+        justifyValue !== "around" &&
+        justifyValue !== "evenly") {
+        return invalid(`${kind}.justify must be one of "start" | "end" | "center" | "between" | "around" | "evenly" (also accepts CSS aliases: "space-between" | "space-around" | "space-evenly")`);
+    }
+    const lcRes = validateLayoutConstraints(kind, p);
+    if (!lcRes.ok)
+        return lcRes;
+    const normalizedConstraints = { ...lcRes.value };
+    const overflowRes = requireOverflow(kind, "overflow", p.overflow, "visible");
+    if (!overflowRes.ok)
+        return overflowRes;
+    const scrollXRes = requireIntNonNegative(kind, "scrollX", p.scrollX, 0);
+    if (!scrollXRes.ok)
+        return scrollXRes;
+    const scrollYRes = requireIntNonNegative(kind, "scrollY", p.scrollY, 0);
+    if (!scrollYRes.ok)
+        return scrollYRes;
+    const spRes = validateSpacingProps(kind, p);
+    if (!spRes.ok)
+        return spRes;
+    return {
+        ok: true,
+        value: {
+            pad: padRes.value,
+            gap: gapRes.value,
+            align: alignValue,
+            justify: justifyValue,
+            overflow: overflowRes.value,
+            scrollX: scrollXRes.value,
+            scrollY: scrollYRes.value,
+            ...spRes.value,
+            ...normalizedConstraints,
+        },
+    };
+}
+/** Validate Box props: pad (default 0), border (default "single"). */
+export function validateBoxProps(props) {
+    const propsRes = requirePropBag("box", props);
+    if (!propsRes.ok)
+        return propsRes;
+    const p = propsRes.value;
+    const padRes = requireSpacingIntNonNegative("box", "pad", p.pad, 0);
+    if (!padRes.ok)
+        return padRes;
+    const gapRes = requireSpacingIntNonNegative("box", "gap", p.gap, 0);
+    if (!gapRes.ok)
+        return gapRes;
+    const borderValue = p.border === undefined ? "single" : normalizeStringToken(p.border);
+    if (borderValue !== "none" &&
+        borderValue !== "single" &&
+        borderValue !== "double" &&
+        borderValue !== "rounded" &&
+        borderValue !== "heavy" &&
+        borderValue !== "dashed" &&
+        borderValue !== "heavy-dashed") {
+        return invalid('box.border must be one of "none" | "single" | "double" | "rounded" | "heavy" | "dashed" | "heavy-dashed"');
+    }
+    const defaultSide = borderValue !== "none";
+    const topRes = requireBoolean("box", "borderTop", p.borderTop, defaultSide);
+    if (!topRes.ok)
+        return topRes;
+    const rightRes = requireBoolean("box", "borderRight", p.borderRight, defaultSide);
+    if (!rightRes.ok)
+        return rightRes;
+    const bottomRes = requireBoolean("box", "borderBottom", p.borderBottom, defaultSide);
+    if (!bottomRes.ok)
+        return bottomRes;
+    const leftRes = requireBoolean("box", "borderLeft", p.borderLeft, defaultSide);
+    if (!leftRes.ok)
+        return leftRes;
+    const lcRes = validateLayoutConstraints("box", p);
+    if (!lcRes.ok)
+        return lcRes;
+    const overflowRes = requireOverflow("box", "overflow", p.overflow, "visible");
+    if (!overflowRes.ok)
+        return overflowRes;
+    const scrollXRes = requireIntNonNegative("box", "scrollX", p.scrollX, 0);
+    if (!scrollXRes.ok)
+        return scrollXRes;
+    const scrollYRes = requireIntNonNegative("box", "scrollY", p.scrollY, 0);
+    if (!scrollYRes.ok)
+        return scrollYRes;
+    const spRes = validateSpacingProps("box", p);
+    if (!spRes.ok)
+        return spRes;
+    return {
+        ok: true,
+        value: {
+            pad: padRes.value,
+            gap: gapRes.value,
+            border: borderValue,
+            borderTop: topRes.value,
+            borderRight: rightRes.value,
+            borderBottom: bottomRes.value,
+            borderLeft: leftRes.value,
+            overflow: overflowRes.value,
+            scrollX: scrollXRes.value,
+            scrollY: scrollYRes.value,
+            ...spRes.value,
+            ...lcRes.value,
+        },
+    };
+}
+/** Validate Spacer props: size (default 1). */
+export function validateSpacerProps(props) {
+    const propsRes = requirePropBag("spacer", props);
+    if (!propsRes.ok)
+        return propsRes;
+    const p = propsRes.value;
+    const flexRes = requireFlex("spacer", p.flex);
+    if (!flexRes.ok)
+        return flexRes;
+    const flex = flexRes.value ?? 0;
+    const defaultSize = flex > 0 ? 0 : 1;
+    const sizeRes = requireIntNonNegative("spacer", "size", p.size, defaultSize);
+    if (!sizeRes.ok)
+        return sizeRes;
+    return { ok: true, value: { size: sizeRes.value, flex } };
+}
+/** Validate Button props: id (required), label (required), disabled (default false). */
+export function validateButtonProps(props) {
+    const propsRes = requirePropBag("button", props);
+    if (!propsRes.ok)
+        return propsRes;
+    const p = propsRes.value;
+    const idRes = requireNonEmptyString("button", "id", p.id);
+    if (!idRes.ok)
+        return idRes;
+    const labelRes = requireString("button", "label", p.label);
+    if (!labelRes.ok)
+        return labelRes;
+    const disabledRes = requireBoolean("button", "disabled", p.disabled, false);
+    if (!disabledRes.ok)
+        return disabledRes;
+    return {
+        ok: true,
+        value: { id: idRes.value, label: labelRes.value, disabled: disabledRes.value },
+    };
+}
+/** Validate Input props: id (required, non-empty), value (required), disabled (default false). */
+export function validateInputProps(props) {
+    const propsRes = requirePropBag("input", props);
+    if (!propsRes.ok)
+        return propsRes;
+    const p = propsRes.value;
+    const idRes = requireNonEmptyString("input", "id", p.id);
+    if (!idRes.ok)
+        return idRes;
+    const valueRes = requireString("input", "value", p.value);
+    if (!valueRes.ok)
+        return valueRes;
+    const disabledRes = requireBoolean("input", "disabled", p.disabled, false);
+    if (!disabledRes.ok)
+        return disabledRes;
+    const readOnlyRes = requireBoolean("input", "readOnly", p.readOnly, false);
+    if (!readOnlyRes.ok)
+        return readOnlyRes;
+    const multilineRes = requireBoolean("input", "multiline", p.multiline, false);
+    if (!multilineRes.ok)
+        return multilineRes;
+    const rowsRes = requireOptionalIntNonNegative("input", "rows", p.rows);
+    if (!rowsRes.ok)
+        return rowsRes;
+    const wordWrapRes = requireBoolean("input", "wordWrap", p.wordWrap, true);
+    if (!wordWrapRes.ok)
+        return wordWrapRes;
+    const multiline = multilineRes.value;
+    const rows = multiline ? Math.max(1, rowsRes.value ?? 3) : 1;
+    const wordWrap = multiline ? wordWrapRes.value : false;
+    return {
+        ok: true,
+        value: {
+            id: idRes.value,
+            value: valueRes.value,
+            disabled: disabledRes.value,
+            readOnly: readOnlyRes.value,
+            multiline,
+            rows,
+            wordWrap,
+        },
+    };
+}
+function validateInteractiveOptions(kind, options, requireNonEmpty) {
+    if (!Array.isArray(options)) {
+        return invalid(`${kind}.options must be an array`);
+    }
+    if (requireNonEmpty && options.length === 0) {
+        return invalid(`${kind}.options must be a non-empty array`);
+    }
+    const validated = [];
+    for (let i = 0; i < options.length; i++) {
+        const option = options[i];
+        if (typeof option !== "object" || option === null || Array.isArray(option)) {
+            return invalid(`${kind}.options[${i}] must be an object`);
+        }
+        const p = option;
+        const valueRes = requireString(`${kind}.options[${i}]`, "value", p.value);
+        if (!valueRes.ok)
+            return valueRes;
+        const labelRes = requireString(`${kind}.options[${i}]`, "label", p.label);
+        if (!labelRes.ok)
+            return labelRes;
+        const disabledRes = requireBoolean(`${kind}.options[${i}]`, "disabled", p.disabled, false);
+        if (!disabledRes.ok)
+            return disabledRes;
+        validated.push({ value: valueRes.value, label: labelRes.value, disabled: disabledRes.value });
+    }
+    return { ok: true, value: validated };
+}
+/** Validate Select props: id/value/options required; options may be empty. */
+export function validateSelectProps(props) {
+    const propsRes = requirePropBag("select", props);
+    if (!propsRes.ok)
+        return propsRes;
+    const p = propsRes.value;
+    const idRes = requireNonEmptyString("select", "id", p.id);
+    if (!idRes.ok)
+        return idRes;
+    const valueRes = requireString("select", "value", p.value);
+    if (!valueRes.ok)
+        return valueRes;
+    const optionsRes = validateInteractiveOptions("select", p.options, false);
+    if (!optionsRes.ok)
+        return optionsRes;
+    const disabledRes = requireBoolean("select", "disabled", p.disabled, false);
+    if (!disabledRes.ok)
+        return disabledRes;
+    const placeholderRes = requireOptionalString("select", "placeholder", p.placeholder);
+    if (!placeholderRes.ok)
+        return placeholderRes;
+    const hasEmptyValueOption = optionsRes.value.some((option) => option.value === "");
+    return {
+        ok: true,
+        value: {
+            id: idRes.value,
+            value: valueRes.value,
+            options: optionsRes.value,
+            disabled: disabledRes.value,
+            ...(placeholderRes.value === undefined ? {} : { placeholder: placeholderRes.value }),
+        },
+        ...(hasEmptyValueOption
+            ? {
+                warnings: Object.freeze([
+                    'select.options contains value "". Empty-string values are treated as unselected unless an explicit empty option is present in display logic.',
+                ]),
+            }
+            : {}),
+    };
+}
+/** Validate Slider props: id/value required; finite range with min<=max and step>0. */
+export function validateSliderProps(props) {
+    const propsRes = requirePropBag("slider", props);
+    if (!propsRes.ok)
+        return propsRes;
+    const p = propsRes.value;
+    const idRes = requireNonEmptyString("slider", "id", p.id);
+    if (!idRes.ok)
+        return idRes;
+    const valueRes = requireFiniteNumber("slider", "value", p.value);
+    if (!valueRes.ok)
+        return valueRes;
+    const minRes = requireOptionalFiniteNumber("slider", "min", p.min);
+    if (!minRes.ok)
+        return minRes;
+    const maxRes = requireOptionalFiniteNumber("slider", "max", p.max);
+    if (!maxRes.ok)
+        return maxRes;
+    const stepRes = requireOptionalFiniteNumber("slider", "step", p.step);
+    if (!stepRes.ok)
+        return stepRes;
+    const widthRes = requireOptionalIntNonNegative("slider", "width", p.width);
+    if (!widthRes.ok)
+        return widthRes;
+    const labelRes = requireOptionalString("slider", "label", p.label);
+    if (!labelRes.ok)
+        return labelRes;
+    const showValueRes = requireBoolean("slider", "showValue", p.showValue, true);
+    if (!showValueRes.ok)
+        return showValueRes;
+    const disabledRes = requireBoolean("slider", "disabled", p.disabled, false);
+    if (!disabledRes.ok)
+        return disabledRes;
+    const readOnlyRes = requireBoolean("slider", "readOnly", p.readOnly, false);
+    if (!readOnlyRes.ok)
+        return readOnlyRes;
+    const min = minRes.value ?? 0;
+    const max = maxRes.value ?? 100;
+    if (min > max) {
+        return invalid("slider.min must be <= slider.max");
+    }
+    const step = stepRes.value ?? 1;
+    if (step <= 0) {
+        return invalid("slider.step must be a finite number > 0");
+    }
+    return {
+        ok: true,
+        value: {
+            id: idRes.value,
+            value: valueRes.value,
+            min,
+            max,
+            step,
+            ...(widthRes.value === undefined ? {} : { width: widthRes.value }),
+            ...(labelRes.value === undefined ? {} : { label: labelRes.value }),
+            showValue: showValueRes.value,
+            disabled: disabledRes.value,
+            readOnly: readOnlyRes.value,
+        },
+    };
+}
+/** Validate Checkbox props: id and checked required. */
+export function validateCheckboxProps(props) {
+    const propsRes = requirePropBag("checkbox", props);
+    if (!propsRes.ok)
+        return propsRes;
+    const p = propsRes.value;
+    const idRes = requireNonEmptyString("checkbox", "id", p.id);
+    if (!idRes.ok)
+        return idRes;
+    if (typeof p.checked !== "boolean") {
+        return invalid("checkbox.checked must be a boolean");
+    }
+    const labelRes = requireOptionalString("checkbox", "label", p.label);
+    if (!labelRes.ok)
+        return labelRes;
+    const disabledRes = requireBoolean("checkbox", "disabled", p.disabled, false);
+    if (!disabledRes.ok)
+        return disabledRes;
+    return {
+        ok: true,
+        value: {
+            id: idRes.value,
+            checked: p.checked,
+            ...(labelRes.value === undefined ? {} : { label: labelRes.value }),
+            disabled: disabledRes.value,
+        },
+    };
+}
+/** Validate RadioGroup props: id/value/options required; options must be non-empty. */
+export function validateRadioGroupProps(props) {
+    const propsRes = requirePropBag("radioGroup", props);
+    if (!propsRes.ok)
+        return propsRes;
+    const p = propsRes.value;
+    const idRes = requireNonEmptyString("radioGroup", "id", p.id);
+    if (!idRes.ok)
+        return idRes;
+    const valueRes = requireString("radioGroup", "value", p.value);
+    if (!valueRes.ok)
+        return valueRes;
+    const optionsRes = validateInteractiveOptions("radioGroup", p.options, true);
+    if (!optionsRes.ok)
+        return optionsRes;
+    const directionValue = p.direction === undefined ? "vertical" : normalizeStringToken(p.direction);
+    if (directionValue !== "horizontal" && directionValue !== "vertical") {
+        return invalid('radioGroup.direction must be one of "horizontal" | "vertical"');
+    }
+    const disabledRes = requireBoolean("radioGroup", "disabled", p.disabled, false);
+    if (!disabledRes.ok)
+        return disabledRes;
+    return {
+        ok: true,
+        value: {
+            id: idRes.value,
+            value: valueRes.value,
+            options: optionsRes.value,
+            direction: directionValue,
+            disabled: disabledRes.value,
+        },
+    };
+}
+/** Validate Text props (`maxWidth` affects measurement; style/overflow are renderer concerns). */
+export function validateTextProps(props) {
+    const propsRes = requirePropBag("text", props);
+    if (!propsRes.ok)
+        return propsRes;
+    const p = propsRes.value;
+    const maxWidthRes = requireOptionalTextMaxWidth("text", "maxWidth", p.maxWidth);
+    if (!maxWidthRes.ok)
+        return maxWidthRes;
+    const wrapRes = requireBoolean("text", "wrap", p.wrap, false);
+    if (!wrapRes.ok)
+        return wrapRes;
+    return {
+        ok: true,
+        value: {
+            ...(maxWidthRes.value === undefined ? {} : { maxWidth: maxWidthRes.value }),
+            wrap: wrapRes.value,
+        },
+    };
+}
+//# sourceMappingURL=interactive.js.map