blecsd 0.1.0

package/dist/schemas/index.d.ts

@@ -0,0 +1,936 @@
+import { z } from 'zod';
+
+/**
+ * Common Zod schemas used across the library
+ * @module schemas/common
+ */
+
+/**
+ * Schema for positive integers (1, 2, 3, ...).
+ *
+ * @example
+ * ```typescript
+ * import { PositiveIntSchema } from 'blecsd';
+ *
+ * const count = PositiveIntSchema.parse(5); // OK
+ * PositiveIntSchema.parse(0); // throws
+ * ```
+ */
+declare const PositiveIntSchema: z.ZodNumber;
+type PositiveInt = z.infer<typeof PositiveIntSchema>;
+/**
+ * Schema for non-negative integers (0, 1, 2, 3, ...).
+ *
+ * @example
+ * ```typescript
+ * import { NonNegativeIntSchema } from 'blecsd';
+ *
+ * const index = NonNegativeIntSchema.parse(0); // OK
+ * NonNegativeIntSchema.parse(-1); // throws
+ * ```
+ */
+declare const NonNegativeIntSchema: z.ZodNumber;
+type NonNegativeInt = z.infer<typeof NonNegativeIntSchema>;
+/**
+ * Schema for percentage values (0-100).
+ *
+ * @example
+ * ```typescript
+ * import { PercentageSchema } from 'blecsd';
+ *
+ * const pct = PercentageSchema.parse(75); // OK
+ * PercentageSchema.parse(101); // throws
+ * ```
+ */
+declare const PercentageSchema: z.ZodNumber;
+type Percentage = z.infer<typeof PercentageSchema>;
+/**
+ * Schema for color strings — hex (#fff, #ffffff, #ffffffff), rgb(), hsl(), or named colors.
+ *
+ * @example
+ * ```typescript
+ * import { ColorStringSchema } from 'blecsd';
+ *
+ * ColorStringSchema.parse('#ff0000'); // OK
+ * ColorStringSchema.parse('rgb(255, 0, 0)'); // OK
+ * ColorStringSchema.parse('red'); // OK
+ * ```
+ */
+declare const ColorStringSchema: z.ZodString;
+type ColorString = z.infer<typeof ColorStringSchema>;
+/**
+ * Schema for dimensions — number (absolute cells) or percentage string ("50%").
+ *
+ * @example
+ * ```typescript
+ * import { DimensionSchema } from 'blecsd';
+ *
+ * DimensionSchema.parse(80); // OK
+ * DimensionSchema.parse('50%'); // OK
+ * ```
+ */
+declare const DimensionSchema: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+type Dimension = z.infer<typeof DimensionSchema>;
+/**
+ * Schema for position values — number, percentage string, or keyword.
+ *
+ * @example
+ * ```typescript
+ * import { PositionValueSchema } from 'blecsd';
+ *
+ * PositionValueSchema.parse(10); // OK
+ * PositionValueSchema.parse('50%'); // OK
+ * PositionValueSchema.parse('center'); // OK
+ * ```
+ */
+declare const PositionValueSchema: z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodEnum<{
+    left: "left";
+    top: "top";
+    right: "right";
+    bottom: "bottom";
+    center: "center";
+}>]>;
+type PositionValue = z.infer<typeof PositionValueSchema>;
+
+/**
+ * Zod validation schemas for component setter functions.
+ * @module schemas/components
+ */
+
+/**
+ * Schema for setPosition parameters.
+ *
+ * @example
+ * ```typescript
+ * import { SetPositionSchema } from 'blecsd';
+ *
+ * const pos = SetPositionSchema.parse({ x: 10, y: 20, z: 5 });
+ * ```
+ */
+declare const SetPositionSchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    z: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Schema for z-index values (0-65535).
+ *
+ * @example
+ * ```typescript
+ * import { ZIndexSchema } from 'blecsd';
+ *
+ * const z = ZIndexSchema.parse(100);
+ * ```
+ */
+declare const ZIndexSchema: z.ZodNumber;
+/**
+ * Schema for dimension values (number, percentage string, or 'auto').
+ *
+ * @example
+ * ```typescript
+ * import { DimensionValueSchema } from 'blecsd';
+ *
+ * DimensionValueSchema.parse(80); // absolute cells
+ * DimensionValueSchema.parse('50%'); // percentage
+ * DimensionValueSchema.parse('auto'); // auto-size
+ * ```
+ */
+declare const DimensionValueSchema: z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodLiteral<"auto">]>;
+/**
+ * Schema for setDimensions parameters.
+ *
+ * @example
+ * ```typescript
+ * import { SetDimensionsSchema } from 'blecsd';
+ *
+ * const dims = SetDimensionsSchema.parse({ width: 80, height: '50%' });
+ * ```
+ */
+declare const SetDimensionsSchema: z.ZodObject<{
+    width: z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodLiteral<"auto">]>;
+    height: z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodLiteral<"auto">]>;
+}, z.core.$strip>;
+/**
+ * Schema for dimension constraints (min/max width and height).
+ *
+ * @example
+ * ```typescript
+ * import { DimensionConstraintsSchema } from 'blecsd';
+ *
+ * const constraints = DimensionConstraintsSchema.parse({
+ *   minWidth: 20, maxWidth: 100,
+ *   minHeight: 5, maxHeight: 50,
+ * });
+ * ```
+ */
+declare const DimensionConstraintsSchema: z.ZodObject<{
+    minWidth: z.ZodOptional<z.ZodNumber>;
+    minHeight: z.ZodOptional<z.ZodNumber>;
+    maxWidth: z.ZodOptional<z.ZodNumber>;
+    maxHeight: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Schema for padding values (stored as Uint8, so 0-255).
+ *
+ * @example
+ * ```typescript
+ * import { PaddingValueSchema } from 'blecsd';
+ *
+ * const pad = PaddingValueSchema.parse(4);
+ * ```
+ */
+declare const PaddingValueSchema: z.ZodNumber;
+/**
+ * Schema for setPadding options with per-side values.
+ *
+ * @example
+ * ```typescript
+ * import { PaddingOptionsSchema } from 'blecsd';
+ *
+ * const padding = PaddingOptionsSchema.parse({ left: 2, right: 2 });
+ * ```
+ */
+declare const PaddingOptionsSchema: z.ZodObject<{
+    left: z.ZodOptional<z.ZodNumber>;
+    top: z.ZodOptional<z.ZodNumber>;
+    right: z.ZodOptional<z.ZodNumber>;
+    bottom: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Schema for style color values (hex string or packed RGBA number).
+ *
+ * @example
+ * ```typescript
+ * import { StyleColorSchema } from 'blecsd';
+ *
+ * StyleColorSchema.parse('#ff0000'); // hex string
+ * StyleColorSchema.parse(0xff0000ff); // packed RGBA
+ * ```
+ */
+declare const StyleColorSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+/**
+ * Schema for setStyle options (foreground, background, text attributes).
+ *
+ * @example
+ * ```typescript
+ * import { StyleOptionsSchema } from 'blecsd';
+ *
+ * const style = StyleOptionsSchema.parse({
+ *   fg: '#ff0000', bg: '#000000', bold: true,
+ * });
+ * ```
+ */
+declare const StyleOptionsSchema: z.ZodObject<{
+    fg: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    bg: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    bold: z.ZodOptional<z.ZodBoolean>;
+    underline: z.ZodOptional<z.ZodBoolean>;
+    blink: z.ZodOptional<z.ZodBoolean>;
+    inverse: z.ZodOptional<z.ZodBoolean>;
+    transparent: z.ZodOptional<z.ZodBoolean>;
+    opacity: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Schema for scrollable component options.
+ *
+ * @example
+ * ```typescript
+ * import { ScrollableOptionsSchema } from 'blecsd';
+ *
+ * const opts = ScrollableOptionsSchema.parse({
+ *   scrollX: 0, scrollY: 10, scrollHeight: 200,
+ * });
+ * ```
+ */
+declare const ScrollableOptionsSchema: z.ZodObject<{
+    scrollX: z.ZodOptional<z.ZodNumber>;
+    scrollY: z.ZodOptional<z.ZodNumber>;
+    scrollWidth: z.ZodOptional<z.ZodNumber>;
+    scrollHeight: z.ZodOptional<z.ZodNumber>;
+    viewportWidth: z.ZodOptional<z.ZodNumber>;
+    viewportHeight: z.ZodOptional<z.ZodNumber>;
+    scrollbarVisible: z.ZodOptional<z.ZodNumber>;
+    trackVisible: z.ZodOptional<z.ZodBoolean>;
+    alwaysScroll: z.ZodOptional<z.ZodBoolean>;
+    clampEnabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Schema for a single animation frame (index + duration).
+ *
+ * @example
+ * ```typescript
+ * import { AnimationFrameSchema } from 'blecsd';
+ *
+ * const frame = AnimationFrameSchema.parse({ frameIndex: 0, duration: 100 });
+ * ```
+ */
+declare const AnimationFrameSchema: z.ZodObject<{
+    frameIndex: z.ZodNumber;
+    duration: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Schema for registerAnimation options (name + frame sequence).
+ *
+ * @example
+ * ```typescript
+ * import { AnimationOptionsSchema } from 'blecsd';
+ *
+ * const anim = AnimationOptionsSchema.parse({
+ *   name: 'walk',
+ *   frames: [
+ *     { frameIndex: 0, duration: 100 },
+ *     { frameIndex: 1, duration: 100 },
+ *   ],
+ * });
+ * ```
+ */
+declare const AnimationOptionsSchema: z.ZodObject<{
+    name: z.ZodString;
+    frames: z.ZodArray<z.ZodObject<{
+        frameIndex: z.ZodNumber;
+        duration: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Schema for slider range (min must be less than max).
+ *
+ * @example
+ * ```typescript
+ * import { SliderRangeSchema } from 'blecsd';
+ *
+ * const range = SliderRangeSchema.parse({ min: 0, max: 100 });
+ * ```
+ */
+declare const SliderRangeSchema: z.ZodObject<{
+    min: z.ZodNumber;
+    max: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Schema for slider step value (must be positive).
+ *
+ * @example
+ * ```typescript
+ * import { SliderStepSchema } from 'blecsd';
+ *
+ * const step = SliderStepSchema.parse(0.5);
+ * ```
+ */
+declare const SliderStepSchema: z.ZodNumber;
+/**
+ * Schema for slider percentage value (0-1).
+ *
+ * @example
+ * ```typescript
+ * import { SliderPercentageSchema } from 'blecsd';
+ *
+ * const pct = SliderPercentageSchema.parse(0.75);
+ * ```
+ */
+declare const SliderPercentageSchema: z.ZodNumber;
+/**
+ * Schema for list behavior options (interactivity, navigation).
+ *
+ * @example
+ * ```typescript
+ * import { ListBehaviorOptionsSchema } from 'blecsd';
+ *
+ * const opts = ListBehaviorOptionsSchema.parse({
+ *   interactive: true, mouse: true, keys: true,
+ * });
+ * ```
+ */
+declare const ListBehaviorOptionsSchema: z.ZodObject<{
+    interactive: z.ZodOptional<z.ZodBoolean>;
+    mouse: z.ZodOptional<z.ZodBoolean>;
+    keys: z.ZodOptional<z.ZodBoolean>;
+    search: z.ZodOptional<z.ZodBoolean>;
+    selectedIndex: z.ZodOptional<z.ZodNumber>;
+    visibleCount: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Schema for a list item (text, optional value, disabled state).
+ *
+ * @example
+ * ```typescript
+ * import { ListItemSchema } from 'blecsd';
+ *
+ * const item = ListItemSchema.parse({ text: 'Option A', value: 'a' });
+ * ```
+ */
+declare const ListItemSchema: z.ZodObject<{
+    text: z.ZodString;
+    value: z.ZodOptional<z.ZodString>;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+
+/**
+ * Zod validation schemas for game loop configuration.
+ *
+ * Validates timing, fixed timestep, and FPS configuration
+ * used by the game loop and scheduler.
+ *
+ * @module schemas/gameLoop
+ */
+
+/**
+ * Schema for fixed timestep mode configuration.
+ *
+ * Fixed timestep runs game logic at a consistent rate, independent
+ * of the rendering frame rate. Essential for deterministic physics,
+ * network synchronization, and replays.
+ *
+ * @example
+ * ```typescript
+ * import { FixedTimestepConfigSchema } from 'blecsd';
+ *
+ * const config = FixedTimestepConfigSchema.parse({
+ *   tickRate: 60,
+ *   maxUpdatesPerFrame: 5,
+ *   interpolate: true,
+ * });
+ * ```
+ */
+declare const FixedTimestepConfigSchema: z.ZodObject<{
+    tickRate: z.ZodNumber;
+    maxUpdatesPerFrame: z.ZodNumber;
+    interpolate: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * Schema for game loop configuration options.
+ *
+ * Controls frame rate, timestep capping, and optional fixed
+ * timestep mode for deterministic updates.
+ *
+ * @example
+ * ```typescript
+ * import { GameLoopOptionsSchema } from 'blecsd';
+ *
+ * const options = GameLoopOptionsSchema.parse({
+ *   targetFPS: 60,
+ *   maxDeltaTime: 0.1,
+ * });
+ * ```
+ */
+declare const GameLoopOptionsSchema: z.ZodObject<{
+    targetFPS: z.ZodOptional<z.ZodNumber>;
+    fixedTimestep: z.ZodOptional<z.ZodBoolean>;
+    maxDeltaTime: z.ZodOptional<z.ZodNumber>;
+    fixedTimestepMode: z.ZodOptional<z.ZodObject<{
+        tickRate: z.ZodNumber;
+        maxUpdatesPerFrame: z.ZodNumber;
+        interpolate: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Schema for loop performance statistics.
+ *
+ * Validates the shape of performance data returned by the game loop,
+ * including FPS, frame time, tick counts, and interpolation state.
+ *
+ * @example
+ * ```typescript
+ * import { LoopStatsSchema } from 'blecsd';
+ *
+ * const stats = LoopStatsSchema.parse({
+ *   fps: 60,
+ *   frameTime: 16.67,
+ *   frameCount: 3600,
+ *   runningTime: 60,
+ *   tickCount: 3600,
+ *   ticksPerSecond: 60,
+ *   interpolationAlpha: 0.5,
+ *   skippedUpdates: 0,
+ * });
+ * ```
+ */
+declare const LoopStatsSchema: z.ZodObject<{
+    fps: z.ZodNumber;
+    frameTime: z.ZodNumber;
+    frameCount: z.ZodNumber;
+    runningTime: z.ZodNumber;
+    tickCount: z.ZodNumber;
+    ticksPerSecond: z.ZodNumber;
+    interpolationAlpha: z.ZodNumber;
+    skippedUpdates: z.ZodNumber;
+}, z.core.$strip>;
+
+/**
+ * Zod validation schemas for system configuration and boundaries.
+ * @module schemas/systems
+ */
+
+/**
+ * Schema for grid snap configuration (positive x/y step sizes).
+ *
+ * @example
+ * ```typescript
+ * import { SnapToGridSchema } from 'blecsd';
+ *
+ * const snap = SnapToGridSchema.parse({ x: 10, y: 10 });
+ * ```
+ */
+declare const SnapToGridSchema: z.ZodNullable<z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+}, z.core.$strip>>;
+/**
+ * Schema for drag constraint configuration with axis locking, bounds, and grid snapping.
+ *
+ * @example
+ * ```typescript
+ * import { DragConstraintsSchema } from 'blecsd';
+ *
+ * const constraints = DragConstraintsSchema.parse({
+ *   constrainToParent: true,
+ *   constrainAxis: 'x',
+ *   minX: 0, maxX: 100,
+ * });
+ * ```
+ */
+declare const DragConstraintsSchema: z.ZodObject<{
+    constrainToParent: z.ZodOptional<z.ZodBoolean>;
+    constrainAxis: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        x: "x";
+        y: "y";
+    }>>>;
+    snapToGrid: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+    }, z.core.$strip>>>;
+    minX: z.ZodOptional<z.ZodNumber>;
+    maxX: z.ZodOptional<z.ZodNumber>;
+    minY: z.ZodOptional<z.ZodNumber>;
+    maxY: z.ZodOptional<z.ZodNumber>;
+    bringToFront: z.ZodOptional<z.ZodBoolean>;
+    frontZIndex: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Schema for queued key event data.
+ *
+ * @example
+ * ```typescript
+ * import { QueuedKeyEventSchema } from 'blecsd';
+ *
+ * const event = QueuedKeyEventSchema.parse({ type: 'key', key: 'enter' });
+ * ```
+ */
+declare const QueuedKeyEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"key">;
+    key: z.ZodString;
+    raw: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for queued mouse event data.
+ *
+ * @example
+ * ```typescript
+ * import { QueuedMouseEventSchema } from 'blecsd';
+ *
+ * const event = QueuedMouseEventSchema.parse({
+ *   type: 'mouse', action: 'click', x: 10, y: 20,
+ * });
+ * ```
+ */
+declare const QueuedMouseEventSchema: z.ZodObject<{
+    type: z.ZodLiteral<"mouse">;
+    action: z.ZodString;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    button: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for queued input events — discriminated union of key and mouse events.
+ *
+ * @example
+ * ```typescript
+ * import { QueuedInputEventSchema } from 'blecsd';
+ *
+ * const event = QueuedInputEventSchema.parse({ type: 'key', key: 'a' });
+ * ```
+ */
+declare const QueuedInputEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"key">;
+    key: z.ZodString;
+    raw: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"mouse">;
+    action: z.ZodString;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    button: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>], "type">;
+/**
+ * Schema for output state tracking (cursor position, colors, screen mode).
+ *
+ * @example
+ * ```typescript
+ * import { OutputStateSchema } from 'blecsd';
+ *
+ * const state = OutputStateSchema.parse({
+ *   lastX: 0, lastY: 0,
+ *   lastFg: 0xffffffff, lastBg: 0x000000ff,
+ *   lastAttrs: 0, alternateScreen: false,
+ * });
+ * ```
+ */
+declare const OutputStateSchema: z.ZodObject<{
+    lastX: z.ZodNumber;
+    lastY: z.ZodNumber;
+    lastFg: z.ZodNumber;
+    lastBg: z.ZodNumber;
+    lastAttrs: z.ZodNumber;
+    alternateScreen: z.ZodBoolean;
+}, z.core.$strip>;
+/**
+ * Schema for computed layout data (position + dimensions).
+ *
+ * @example
+ * ```typescript
+ * import { ComputedLayoutSchema } from 'blecsd';
+ *
+ * const layout = ComputedLayoutSchema.parse({ x: 10, y: 5, width: 80, height: 24 });
+ * ```
+ */
+declare const ComputedLayoutSchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Schema for entity bounds used in rendering (position, size, z-order).
+ *
+ * @example
+ * ```typescript
+ * import { EntityBoundsSchema } from 'blecsd';
+ *
+ * const bounds = EntityBoundsSchema.parse({ x: 0, y: 0, width: 40, height: 12, z: 10 });
+ * ```
+ */
+declare const EntityBoundsSchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    z: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Schema for focus event types ('focus' | 'blur').
+ *
+ * @example
+ * ```typescript
+ * import { FocusEventTypeSchema } from 'blecsd';
+ *
+ * const type = FocusEventTypeSchema.parse('focus');
+ * ```
+ */
+declare const FocusEventTypeSchema: z.ZodEnum<{
+    focus: "focus";
+    blur: "blur";
+}>;
+
+/**
+ * Zod validation schemas for terminal module configuration.
+ *
+ * Provides runtime validation for process spawning, command execution,
+ * and editor options used by the terminal process utilities.
+ *
+ * @module schemas/terminal
+ */
+
+/**
+ * Schema for valid Node.js buffer encodings.
+ *
+ * @example
+ * ```typescript
+ * import { BufferEncodingSchema } from 'blecsd';
+ *
+ * const encoding = BufferEncodingSchema.parse('utf8'); // OK
+ * BufferEncodingSchema.parse('invalid'); // throws
+ * ```
+ */
+declare const BufferEncodingSchema: z.ZodEnum<{
+    ascii: "ascii";
+    utf8: "utf8";
+    "utf-8": "utf-8";
+    utf16le: "utf16le";
+    "utf-16le": "utf-16le";
+    ucs2: "ucs2";
+    "ucs-2": "ucs-2";
+    base64: "base64";
+    base64url: "base64url";
+    latin1: "latin1";
+    binary: "binary";
+    hex: "hex";
+}>;
+/**
+ * Schema for process spawn options.
+ *
+ * Validates the configuration for spawning child processes with
+ * proper terminal state management. Stream and callback fields
+ * are not validated at runtime (they rely on TypeScript types).
+ *
+ * @example
+ * ```typescript
+ * import { SpawnOptionsSchema } from 'blecsd';
+ *
+ * const options = SpawnOptionsSchema.parse({
+ *   isAlternateBuffer: true,
+ *   isMouseEnabled: false,
+ * });
+ * ```
+ */
+declare const SpawnOptionsSchema: z.ZodObject<{
+    isAlternateBuffer: z.ZodOptional<z.ZodBoolean>;
+    isMouseEnabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Schema for process execution options.
+ *
+ * Extends spawn options with timeout, buffer size, and encoding
+ * for capturing process output.
+ *
+ * @example
+ * ```typescript
+ * import { ExecOptionsSchema } from 'blecsd';
+ *
+ * const options = ExecOptionsSchema.parse({
+ *   timeout: 5000,
+ *   maxBuffer: 1024 * 1024,
+ *   encoding: 'utf8',
+ *   isAlternateBuffer: false,
+ * });
+ * ```
+ */
+declare const ExecOptionsSchema: z.ZodObject<{
+    isAlternateBuffer: z.ZodOptional<z.ZodBoolean>;
+    isMouseEnabled: z.ZodOptional<z.ZodBoolean>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    maxBuffer: z.ZodOptional<z.ZodNumber>;
+    encoding: z.ZodOptional<z.ZodEnum<{
+        ascii: "ascii";
+        utf8: "utf8";
+        "utf-8": "utf-8";
+        utf16le: "utf16le";
+        "utf-16le": "utf-16le";
+        ucs2: "ucs2";
+        "ucs-2": "ucs-2";
+        base64: "base64";
+        base64url: "base64url";
+        latin1: "latin1";
+        binary: "binary";
+        hex: "hex";
+    }>>;
+}, z.core.$strip>;
+/**
+ * Schema for external editor options.
+ *
+ * Validates configuration for opening an external text editor,
+ * including initial content, file extension, and editor command.
+ *
+ * @example
+ * ```typescript
+ * import { EditorOptionsSchema } from 'blecsd';
+ *
+ * const options = EditorOptionsSchema.parse({
+ *   content: '# Hello',
+ *   extension: '.md',
+ *   editor: 'vim',
+ * });
+ * ```
+ */
+declare const EditorOptionsSchema: z.ZodObject<{
+    content: z.ZodOptional<z.ZodString>;
+    extension: z.ZodOptional<z.ZodString>;
+    editor: z.ZodOptional<z.ZodString>;
+    isAlternateBuffer: z.ZodOptional<z.ZodBoolean>;
+    isMouseEnabled: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+
+/**
+ * Zod validation schemas for widget configurations.
+ *
+ * Enhances existing widget schemas with proper bounds validation
+ * for colors, dimensions, intervals, and paths.
+ *
+ * @module schemas/widgets
+ */
+
+/**
+ * Schema for packed RGBA color values (0x00000000 - 0xFFFFFFFF).
+ *
+ * @example
+ * ```typescript
+ * import { PackedColorSchema } from 'blecsd';
+ *
+ * const color = PackedColorSchema.parse(0xff0000ff); // red, full opacity
+ * ```
+ */
+declare const PackedColorSchema: z.ZodNumber;
+/**
+ * Schema for color values — hex strings (#rgb, #rrggbb, #rrggbbaa) or packed numbers.
+ *
+ * @example
+ * ```typescript
+ * import { WidgetColorSchema } from 'blecsd';
+ *
+ * WidgetColorSchema.parse('#ff0000'); // hex string
+ * WidgetColorSchema.parse(0xff0000ff); // packed RGBA
+ * ```
+ */
+declare const WidgetColorSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+/**
+ * Schema for positive widget dimensions — number (cells), percentage, or 'auto'.
+ *
+ * @example
+ * ```typescript
+ * import { WidgetDimensionSchema } from 'blecsd';
+ *
+ * WidgetDimensionSchema.parse(80); // 80 cells
+ * WidgetDimensionSchema.parse('50%'); // 50% of parent
+ * WidgetDimensionSchema.parse('auto'); // auto-size
+ * ```
+ */
+declare const WidgetDimensionSchema: z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodLiteral<"auto">]>;
+/**
+ * Schema for widget position values — number, percentage, or keyword.
+ *
+ * @example
+ * ```typescript
+ * import { WidgetPositionSchema } from 'blecsd';
+ *
+ * WidgetPositionSchema.parse(10); // absolute position
+ * WidgetPositionSchema.parse('center'); // centered
+ * ```
+ */
+declare const WidgetPositionSchema: z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodEnum<{
+    left: "left";
+    top: "top";
+    right: "right";
+    bottom: "bottom";
+    center: "center";
+}>]>;
+/**
+ * Schema for animation/spinner interval in milliseconds (10-60000).
+ *
+ * @example
+ * ```typescript
+ * import { IntervalSchema } from 'blecsd';
+ *
+ * const interval = IntervalSchema.parse(200); // 200ms
+ * ```
+ */
+declare const IntervalSchema: z.ZodNumber;
+/**
+ * Schema for speed multiplier (0.1x to 10x).
+ *
+ * @example
+ * ```typescript
+ * import { SpeedMultiplierSchema } from 'blecsd';
+ *
+ * const speed = SpeedMultiplierSchema.parse(2.0); // 2x speed
+ * ```
+ */
+declare const SpeedMultiplierSchema: z.ZodNumber;
+/**
+ * Schema for file/directory paths. Rejects empty strings and null byte injection.
+ *
+ * @example
+ * ```typescript
+ * import { FilePathSchema } from 'blecsd';
+ *
+ * const path = FilePathSchema.parse('/usr/local/bin/app');
+ * ```
+ */
+declare const FilePathSchema: z.ZodString;
+/**
+ * Schema for text alignment ('left' | 'center' | 'right').
+ *
+ * @example
+ * ```typescript
+ * import { TextAlignSchema } from 'blecsd';
+ *
+ * const align = TextAlignSchema.parse('center');
+ * ```
+ */
+declare const TextAlignSchema: z.ZodEnum<{
+    left: "left";
+    right: "right";
+    center: "center";
+}>;
+/**
+ * Schema for vertical alignment ('top' | 'middle' | 'bottom').
+ *
+ * @example
+ * ```typescript
+ * import { VAlignSchema } from 'blecsd';
+ *
+ * const valign = VAlignSchema.parse('middle');
+ * ```
+ */
+declare const VAlignSchema: z.ZodEnum<{
+    top: "top";
+    bottom: "bottom";
+    middle: "middle";
+}>;
+/**
+ * Schema for border configuration — boolean toggle or detailed object.
+ *
+ * @example
+ * ```typescript
+ * import { WidgetBorderSchema } from 'blecsd';
+ *
+ * WidgetBorderSchema.parse(true); // simple toggle
+ * WidgetBorderSchema.parse({ type: 'line', fg: '#ff0000' }); // detailed
+ * ```
+ */
+declare const WidgetBorderSchema: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+    type: z.ZodOptional<z.ZodEnum<{
+        bg: "bg";
+        none: "none";
+        line: "line";
+    }>>;
+    fg: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    bg: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>]>>;
+/**
+ * Schema for widget padding — uniform number or per-side object.
+ *
+ * @example
+ * ```typescript
+ * import { WidgetPaddingSchema } from 'blecsd';
+ *
+ * WidgetPaddingSchema.parse(2); // uniform padding
+ * WidgetPaddingSchema.parse({ left: 1, right: 1 }); // per-side
+ * ```
+ */
+declare const WidgetPaddingSchema: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodObject<{
+    left: z.ZodOptional<z.ZodNumber>;
+    top: z.ZodOptional<z.ZodNumber>;
+    right: z.ZodOptional<z.ZodNumber>;
+    bottom: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>]>>;
+/**
+ * Schema for opacity value (0 = transparent, 1 = opaque).
+ *
+ * @example
+ * ```typescript
+ * import { OpacitySchema } from 'blecsd';
+ *
+ * const opacity = OpacitySchema.parse(0.5);
+ * ```
+ */
+declare const OpacitySchema: z.ZodNumber;
+/**
+ * Schema for tree widget path format. Rejects empty strings and null bytes.
+ *
+ * @example
+ * ```typescript
+ * import { TreePathSchema } from 'blecsd';
+ *
+ * const path = TreePathSchema.parse('/root/child/leaf');
+ * ```
+ */
+declare const TreePathSchema: z.ZodString;
+
+export { AnimationFrameSchema, AnimationOptionsSchema, BufferEncodingSchema, type ColorString, ColorStringSchema, ComputedLayoutSchema, type Dimension, DimensionConstraintsSchema, DimensionSchema, DimensionValueSchema, DragConstraintsSchema, EditorOptionsSchema, EntityBoundsSchema, ExecOptionsSchema, FilePathSchema, FixedTimestepConfigSchema, FocusEventTypeSchema, GameLoopOptionsSchema, IntervalSchema, ListBehaviorOptionsSchema, ListItemSchema, LoopStatsSchema, type NonNegativeInt, NonNegativeIntSchema, OpacitySchema, OutputStateSchema, PackedColorSchema, PaddingOptionsSchema, PaddingValueSchema, type Percentage, PercentageSchema, type PositionValue, PositionValueSchema, type PositiveInt, PositiveIntSchema, QueuedInputEventSchema, QueuedKeyEventSchema, QueuedMouseEventSchema, ScrollableOptionsSchema, SetDimensionsSchema, SetPositionSchema, SliderPercentageSchema, SliderRangeSchema, SliderStepSchema, SnapToGridSchema, SpawnOptionsSchema, SpeedMultiplierSchema, StyleColorSchema, StyleOptionsSchema, TextAlignSchema, TreePathSchema, VAlignSchema, WidgetBorderSchema, WidgetColorSchema, WidgetDimensionSchema, WidgetPaddingSchema, WidgetPositionSchema, ZIndexSchema };