@slowclap/rezi-core 0.1.0-fork.1

package/dist/debug/stateTimeline.d.ts

@@ -0,0 +1,73 @@
+/**
+ * packages/core/src/debug/stateTimeline.ts — Application state change tracking.
+ *
+ * Why: Tracks state changes across frames to enable debugging of state-related
+ * issues. Since the C engine doesn't capture application state, this is a
+ * TypeScript-side feature that records state changes from app.update() calls.
+ *
+ * Usage:
+ *   - recordChange(frameId, field, before, after): Record a state change
+ *   - getChanges(since): Get changes since a frame
+ *   - getStateAt(frameId): Reconstruct state at a frame (limited)
+ */
+/**
+ * Record of a single state field change.
+ */
+export type StateChange = Readonly<{
+    /** Frame during which the change occurred */
+    frameId: bigint;
+    /** Timestamp in milliseconds */
+    timestamp: number;
+    /** Field path that changed (e.g., "user.name") */
+    field: string;
+    /** Value before the change */
+    before: unknown;
+    /** Value after the change */
+    after: unknown;
+}>;
+/**
+ * State timeline interface for tracking state changes.
+ */
+export interface StateTimeline {
+    /**
+     * Record a state change.
+     * Called by the app runtime when state is updated.
+     */
+    recordChange(frameId: bigint, timestamp: number, field: string, before: unknown, after: unknown): void;
+    /**
+     * Get all changes since a given frame ID.
+     * @param since - Frame ID to start from (exclusive)
+     */
+    getChanges(since?: bigint): readonly StateChange[];
+    /**
+     * Get changes for a specific frame.
+     * @param frameId - The frame ID
+     */
+    getFrameChanges(frameId: bigint): readonly StateChange[];
+    /**
+     * Clear all recorded changes.
+     */
+    clear(): void;
+    /**
+     * Get the number of recorded changes.
+     */
+    readonly count: number;
+}
+/**
+ * Create a state timeline instance.
+ *
+ * @param maxChanges - Maximum number of changes to retain (default: 10000)
+ */
+export declare function createStateTimeline(maxChanges?: number): StateTimeline;
+/**
+ * Utility to compute the difference between two state objects.
+ * Returns an array of field changes.
+ *
+ * Note: This is a shallow diff - nested objects are compared by reference.
+ */
+export declare function diffState<T extends object>(before: T, after: T): Array<{
+    field: string;
+    before: unknown;
+    after: unknown;
+}>;
+//# sourceMappingURL=stateTimeline.d.ts.map

package/dist/debug/stateTimeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateTimeline.d.ts","sourceRoot":"","sources":["../../src/debug/stateTimeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IACjC,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,6BAA6B;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,YAAY,CACV,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,OAAO,GACb,IAAI,CAAC;IAER;;;OAGG;IACH,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAAC;IAEnD;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAAC;IAEzD;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAYD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,GAAE,MAA4B,GAAG,aAAa,CAuE3F;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EACxC,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,CAAC,GACP,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAkB3D"}

package/dist/debug/stateTimeline.js

@@ -0,0 +1,109 @@
+/**
+ * packages/core/src/debug/stateTimeline.ts — Application state change tracking.
+ *
+ * Why: Tracks state changes across frames to enable debugging of state-related
+ * issues. Since the C engine doesn't capture application state, this is a
+ * TypeScript-side feature that records state changes from app.update() calls.
+ *
+ * Usage:
+ *   - recordChange(frameId, field, before, after): Record a state change
+ *   - getChanges(since): Get changes since a frame
+ *   - getStateAt(frameId): Reconstruct state at a frame (limited)
+ */
+/** Default maximum number of state changes to retain. */
+const DEFAULT_MAX_CHANGES = 10000;
+function normalizeMaxChanges(maxChanges) {
+    if (!Number.isFinite(maxChanges))
+        return DEFAULT_MAX_CHANGES;
+    if (!Number.isInteger(maxChanges))
+        return DEFAULT_MAX_CHANGES;
+    if (maxChanges < 0)
+        return 0;
+    return maxChanges;
+}
+/**
+ * Create a state timeline instance.
+ *
+ * @param maxChanges - Maximum number of changes to retain (default: 10000)
+ */
+export function createStateTimeline(maxChanges = DEFAULT_MAX_CHANGES) {
+    const changes = [];
+    let head = 0;
+    const cap = normalizeMaxChanges(maxChanges);
+    function recordChange(frameId, timestamp, field, before, after) {
+        const change = {
+            frameId,
+            timestamp,
+            field,
+            before,
+            after,
+        };
+        changes.push(change);
+        // Evict oldest changes if over capacity
+        while (changes.length - head > cap) {
+            head++;
+        }
+        // Avoid unbounded growth from a moving head index.
+        if (head > 0 && head * 2 >= changes.length) {
+            changes.splice(0, head);
+            head = 0;
+        }
+    }
+    function getChanges(since) {
+        if (since === undefined) {
+            return changes.slice(head);
+        }
+        const result = [];
+        for (let i = head; i < changes.length; i++) {
+            const c = changes[i];
+            if (c !== undefined && c.frameId > since)
+                result.push(c);
+        }
+        return result;
+    }
+    function getFrameChanges(frameId) {
+        const result = [];
+        for (let i = head; i < changes.length; i++) {
+            const c = changes[i];
+            if (c !== undefined && c.frameId === frameId)
+                result.push(c);
+        }
+        return result;
+    }
+    function clear() {
+        changes.length = 0;
+        head = 0;
+    }
+    return {
+        recordChange,
+        getChanges,
+        getFrameChanges,
+        clear,
+        get count() {
+            return changes.length - head;
+        },
+    };
+}
+/**
+ * Utility to compute the difference between two state objects.
+ * Returns an array of field changes.
+ *
+ * Note: This is a shallow diff - nested objects are compared by reference.
+ */
+export function diffState(before, after) {
+    const changes = [];
+    const allKeys = new Set([...Object.keys(before), ...Object.keys(after)]);
+    for (const key of allKeys) {
+        const beforeVal = before[key];
+        const afterVal = after[key];
+        if (beforeVal !== afterVal) {
+            changes.push({
+                field: key,
+                before: beforeVal,
+                after: afterVal,
+            });
+        }
+    }
+    return changes;
+}
+//# sourceMappingURL=stateTimeline.js.map

package/dist/debug/stateTimeline.js.map

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

package/dist/debug/types.d.ts

@@ -0,0 +1,386 @@
+/**
+ * packages/core/src/debug/types.ts — Debug trace type definitions.
+ *
+ * Why: Defines TypeScript representations of the Zireael C engine's debug trace
+ * structures. These types form the contract between the binary parsers and the
+ * debug controller, ensuring type-safe handling of debug records.
+ *
+ * C structures reference: include/zr/zr_debug.h
+ *
+ * @see docs/guide/debugging.md
+ */
+import type { TerminalCaps } from "../terminalCaps.js";
+/**
+ * Debug record categories matching zr_debug_category_t.
+ *
+ * Categories:
+ *   - none (0): Unspecified category
+ *   - frame (1): Frame lifecycle (submit, present)
+ *   - event (2): Event processing (poll, parse, route)
+ *   - drawlist (3): Drawlist validation and execution
+ *   - error (4): Errors and warnings
+ *   - state (5): State transitions
+ *   - perf (6): Performance measurements
+ */
+export type DebugCategory = "none" | "frame" | "event" | "drawlist" | "error" | "state" | "perf";
+/**
+ * Debug severity levels matching zr_debug_severity_t.
+ *
+ * Severity levels (low to high):
+ *   - trace (0): Verbose tracing (disabled by default)
+ *   - info (1): Informational (frame boundaries, etc.)
+ *   - warn (2): Warnings (recoverable issues)
+ *   - error (3): Errors (operation failed)
+ */
+export type DebugSeverity = "trace" | "info" | "warn" | "error";
+/**
+ * Debug record header (common to all record types).
+ * Matches zr_debug_record_header_t (40 bytes).
+ *
+ * Layout:
+ *   - record_id: u64 (bytes 0-7) - Monotonic record counter
+ *   - timestamp_us: u64 (bytes 8-15) - Microseconds since engine creation
+ *   - frame_id: u64 (bytes 16-23) - Associated frame (0 if not applicable)
+ *   - category: u32 (bytes 24-27) - zr_debug_category_t
+ *   - severity: u32 (bytes 28-31) - zr_debug_severity_t
+ *   - code: u32 (bytes 32-35) - Subsystem-specific code
+ *   - payload_size: u32 (bytes 36-39) - Size of payload following header
+ */
+export type DebugRecordHeader = Readonly<{
+    recordId: bigint;
+    timestampUs: bigint;
+    frameId: bigint;
+    category: DebugCategory;
+    severity: DebugSeverity;
+    code: number;
+    payloadSize: number;
+}>;
+/**
+ * Frame record payload — captures per-frame diagnostics.
+ * Matches zr_debug_frame_record_t (56 bytes).
+ *
+ * Why: Enables frame-by-frame comparison to identify rendering regressions.
+ */
+export type FrameRecord = Readonly<{
+    frameId: bigint;
+    cols: number;
+    rows: number;
+    drawlistBytes: number;
+    drawlistCmds: number;
+    diffBytesEmitted: number;
+    dirtyLines: number;
+    dirtyCells: number;
+    damageRects: number;
+    usDrawlist: number;
+    usDiff: number;
+    usWrite: number;
+}>;
+/**
+ * Event record payload — captures event processing details.
+ * Matches zr_debug_event_record_t (32 bytes).
+ *
+ * Why: Enables tracing of event flow from terminal input to handler dispatch.
+ */
+export type EventRecord = Readonly<{
+    frameId: bigint;
+    eventType: number;
+    eventFlags: number;
+    timeMs: number;
+    rawBytesLen: number;
+    parseResult: number;
+}>;
+/**
+ * Drawlist bytes payload — raw drawlist bytes captured by the engine.
+ *
+ * Note: When captureDrawlistBytes is enabled, the engine may emit a drawlist
+ * record whose payload is the raw drawlist byte stream rather than a fixed
+ * zr_debug_drawlist_record_t structure.
+ */
+export type DrawlistBytesPayload = Readonly<{
+    kind: "drawlistBytes";
+    bytes: Uint8Array;
+}>;
+/**
+ * Error record payload — captures error context for diagnostics.
+ * Matches zr_debug_error_record_t (120 bytes).
+ *
+ * Why: Aggregates errors with context for post-mortem analysis.
+ */
+export type ErrorRecord = Readonly<{
+    frameId: bigint;
+    errorCode: number;
+    sourceLine: number;
+    occurrenceCount: number;
+    sourceFile: string;
+    message: string;
+}>;
+/**
+ * Drawlist record payload — captures drawlist execution details.
+ * Matches zr_debug_drawlist_record_t (48 bytes).
+ *
+ * Why: Enables verification of drawlist commands and their effects.
+ */
+export type DrawlistRecord = Readonly<{
+    frameId: bigint;
+    totalBytes: number;
+    cmdCount: number;
+    version: number;
+    validationResult: number;
+    executionResult: number;
+    clipStackMaxDepth: number;
+    textRuns: number;
+    fillRects: number;
+}>;
+/**
+ * Performance record payload — captures timing measurements.
+ * Matches zr_debug_perf_record_t (24 bytes).
+ *
+ * Why: Enables identification of performance bottlenecks.
+ */
+export type PerfRecord = Readonly<{
+    frameId: bigint;
+    phase: number;
+    usElapsed: number;
+    bytesProcessed: number;
+}>;
+/**
+ * Union of all debug payload types.
+ */
+export type DebugPayload = FrameRecord | EventRecord | ErrorRecord | DrawlistRecord | DrawlistBytesPayload | PerfRecord;
+/**
+ * Complete debug record with header and parsed payload.
+ */
+export type DebugRecord = Readonly<{
+    header: DebugRecordHeader;
+    payload: DebugPayload | null;
+}>;
+/**
+ * Debug configuration for enabling/configuring tracing.
+ * Matches zr_debug_config_t (32 bytes).
+ *
+ * Note: All fields except 'enabled' are optional and use engine defaults if omitted.
+ */
+export type DebugConfig = Readonly<{
+    /** Master enable flag */
+    enabled: boolean;
+    /** Max records in ring buffer (0 = default) */
+    ringCapacity?: number;
+    /** Minimum severity to capture */
+    minSeverity?: DebugSeverity;
+    /** Bitmask of enabled categories */
+    categoryMask?: number;
+    /** Capture raw event bytes (0/1) */
+    captureRawEvents?: boolean;
+    /** Capture drawlist bytes (0/1) */
+    captureDrawlistBytes?: boolean;
+}>;
+/**
+ * Debug query filter for retrieving records.
+ * Matches zr_debug_query_t (48 bytes).
+ *
+ * All fields are optional; unset fields don't filter.
+ */
+export type DebugQuery = Readonly<{
+    /** Start at this record ID (0 = oldest) */
+    minRecordId?: bigint;
+    /** End at this record ID (0 = newest) */
+    maxRecordId?: bigint;
+    /** Filter by frame range start (0 = no filter) */
+    minFrameId?: bigint;
+    /** Filter by frame range end (0 = no filter) */
+    maxFrameId?: bigint;
+    /** Bitmask of categories to include */
+    categoryMask?: number;
+    /** Minimum severity to include */
+    minSeverity?: DebugSeverity;
+    /** Maximum records to return (0 = no limit) */
+    maxRecords?: number;
+}>;
+/**
+ * Debug query result with statistics.
+ * Matches zr_debug_query_result_t (32 bytes).
+ */
+export type DebugQueryResult = Readonly<{
+    /** Number of records returned */
+    recordsReturned: number;
+    /** Total matching records in buffer */
+    recordsAvailable: number;
+    /** Oldest record ID still in buffer */
+    oldestRecordId: bigint;
+    /** Newest record ID in buffer */
+    newestRecordId: bigint;
+    /** Records overwritten since last query */
+    recordsDropped: number;
+}>;
+/**
+ * Debug statistics snapshot.
+ * Matches zr_debug_stats_t (32 bytes).
+ *
+ * Why: Provides aggregate counts for monitoring without querying individual records.
+ */
+export type DebugStats = Readonly<{
+    /** Total records ever written */
+    totalRecords: bigint;
+    /** Records dropped due to ring overflow */
+    totalDropped: bigint;
+    /** Total error records */
+    errorCount: number;
+    /** Total warning records */
+    warnCount: number;
+    /** Records currently in ring */
+    currentRingUsage: number;
+    /** Ring buffer capacity */
+    ringCapacity: number;
+}>;
+/**
+ * Stable schema identifier for JSON debug bundles.
+ */
+export type DebugBundleSchema = "rezi-debug-bundle-v1";
+/**
+ * Debug record header shape used in exported bundles.
+ * BigInt fields are serialized as decimal strings for JSON compatibility.
+ */
+export type DebugBundleHeader = Readonly<{
+    recordId: string;
+    timestampUs: string;
+    frameId: string;
+    category: DebugCategory;
+    severity: DebugSeverity;
+    code: number;
+    payloadSize: number;
+}>;
+/**
+ * Reasons a payload was intentionally omitted from a bundle.
+ */
+export type DebugBundlePayloadOmittedReason = "capture-raw-events-disabled" | "capture-drawlist-bytes-disabled" | "payload-unavailable";
+/**
+ * Payload snapshot for a trace record inside an exported bundle.
+ */
+export type DebugBundlePayloadSnapshot = Readonly<{
+    included: true;
+    encoding: "hex";
+    data: string;
+    bytesIncluded: number;
+    bytesTotal: number;
+    truncated: boolean;
+}> | Readonly<{
+    included: false;
+    reason: DebugBundlePayloadOmittedReason;
+    bytesTotal: number;
+}>;
+/**
+ * Trace entry included in an exported bundle.
+ */
+export type DebugBundleTraceRecord = Readonly<{
+    header: DebugBundleHeader;
+    payload: DebugBundlePayloadSnapshot | null;
+}>;
+/**
+ * Debug statistics snapshot serialized for bundle export.
+ */
+export type DebugBundleStatsSnapshot = Readonly<{
+    totalRecords: string;
+    totalDropped: string;
+    errorCount: number;
+    warnCount: number;
+    currentRingUsage: number;
+    ringCapacity: number;
+}>;
+/**
+ * Capture flags active when the bundle was exported.
+ */
+export type DebugBundleCaptureFlags = Readonly<{
+    captureRawEvents: boolean;
+    captureDrawlistBytes: boolean;
+}>;
+/**
+ * Bounds applied while building the bundle.
+ */
+export type DebugBundleBounds = Readonly<{
+    maxRecords: number;
+    maxPayloadBytes: number;
+    maxTotalPayloadBytes: number;
+    maxRecentFrames: number;
+}>;
+/**
+ * Query window metadata for the exported trace set.
+ */
+export type DebugBundleQueryWindow = Readonly<{
+    recordsReturned: number;
+    recordsAvailable: number;
+    recordsDropped: number;
+    oldestRecordId: string;
+    newestRecordId: string;
+}>;
+/**
+ * Lightweight frame summary included when frame snapshots are available.
+ */
+export type DebugBundleFrameSummary = Readonly<{
+    frameId: string;
+    timestamp: number;
+    cols: number;
+    rows: number;
+    drawlistBytes: number;
+    drawlistCmds: number;
+    diffBytesEmitted: number;
+    dirtyLines: number;
+    dirtyCells: number;
+    damageRects: number;
+    usDrawlist: number;
+    usDiff: number;
+    usWrite: number;
+}>;
+/**
+ * Deterministic debug export bundle.
+ */
+export type DebugBundle = Readonly<{
+    schema: DebugBundleSchema;
+    captureFlags: DebugBundleCaptureFlags;
+    bounds: DebugBundleBounds;
+    terminalCaps: TerminalCaps | null;
+    stats: DebugBundleStatsSnapshot;
+    queryWindow: DebugBundleQueryWindow;
+    trace: readonly DebugBundleTraceRecord[];
+    recentFrameSummaries?: readonly DebugBundleFrameSummary[];
+}>;
+/**
+ * Options for debug bundle export.
+ */
+export type DebugBundleExportOptions = Readonly<{
+    maxRecords?: number;
+    maxPayloadBytes?: number;
+    maxTotalPayloadBytes?: number;
+    includeRecentFrames?: boolean;
+    maxRecentFrames?: number;
+    terminalCaps?: TerminalCaps | null;
+    includeRawEvents?: boolean;
+    includeDrawlistBytes?: boolean;
+}>;
+/**
+ * Performance phase identifiers for PerfRecord.phase field.
+ */
+export type PerfPhase = "poll" | "submit" | "present";
+/**
+ * Parse error codes for debug record parsing.
+ * Extends the standard ParseErrorCode with debug-specific codes.
+ */
+export type DebugParseErrorCode = "ZR_BAD_MAGIC" | "ZR_UNSUPPORTED_VERSION" | "ZR_TRUNCATED" | "ZR_MISALIGNED" | "ZR_SIZE_MISMATCH" | "ZR_OUT_OF_BOUNDS" | "ZR_INVALID_RECORD" | "ZR_LIMIT" | "ZR_DEBUG_INVALID_CATEGORY" | "ZR_DEBUG_INVALID_SEVERITY";
+/**
+ * Parse error with debug-specific context.
+ */
+export type DebugParseError = Readonly<{
+    code: DebugParseErrorCode;
+    offset: number;
+    detail: string;
+}>;
+/**
+ * Parse result for debug records.
+ */
+export type DebugParseResult<T> = Readonly<{
+    ok: true;
+    value: T;
+}> | Readonly<{
+    ok: false;
+    error: DebugParseError;
+}>;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/debug/types.js

@@ -0,0 +1,13 @@
+/**
+ * packages/core/src/debug/types.ts — Debug trace type definitions.
+ *
+ * Why: Defines TypeScript representations of the Zireael C engine's debug trace
+ * structures. These types form the contract between the binary parsers and the
+ * debug controller, ensuring type-safe handling of debug records.
+ *
+ * C structures reference: include/zr/zr_debug.h
+ *
+ * @see docs/guide/debugging.md
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/debug/types.js.map

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

package/dist/drawApi.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Draw API for raw mode rendering.
+ * @see docs/protocol/zrdl.md
+ */
+import type { TextStyle } from "./widgets/style.js";
+/**
+ * Low-level draw API for raw mode rendering.
+ *
+ * This interface is used via the `app.draw(g => ...)` escape hatch
+ * and corresponds to the DrawlistBuilder operations.
+ *
+ * All coordinates are in cell units (column, row).
+ * All methods validate inputs and fail deterministically on invalid parameters.
+ */
+export interface DrawApi {
+    /**
+     * Clear the framebuffer.
+     */
+    clear(): void;
+    /**
+     * Clear and fill the viewport with a style.
+     *
+     * Why: ZRDL v1 CLEAR carries no style payload. This helper emits CLEAR +
+     * FILL_RECT and is the recommended way to apply a background color in raw mode.
+     */
+    clearTo(cols: number, rows: number, style?: TextStyle): void;
+    /**
+     * Fill a rectangle with an optional style.
+     *
+     * @param x - Left column (int32)
+     * @param y - Top row (int32)
+     * @param w - Width in columns (>= 0)
+     * @param h - Height in rows (>= 0)
+     * @param style - Optional style for the fill
+     */
+    fillRect(x: number, y: number, w: number, h: number, style?: TextStyle): void;
+    /**
+     * Draw text at a position with an optional style.
+     *
+     * @param x - Column position (int32)
+     * @param y - Row position (int32)
+     * @param text - Text to draw (UTF-8 encoded internally)
+     * @param style - Optional text style
+     */
+    drawText(x: number, y: number, text: string, style?: TextStyle): void;
+    /**
+     * Push a clip rectangle onto the clip stack.
+     *
+     * All subsequent draw operations will be clipped to this rectangle
+     * (intersected with any existing clip).
+     *
+     * @param x - Left column (int32)
+     * @param y - Top row (int32)
+     * @param w - Width in columns (>= 0)
+     * @param h - Height in rows (>= 0)
+     */
+    pushClip(x: number, y: number, w: number, h: number): void;
+    /**
+     * Pop the most recent clip rectangle from the clip stack.
+     *
+     * Must be balanced with pushClip calls.
+     */
+    popClip(): void;
+    /** Append/lookup a blob payload and return its resource id (for advanced ZRDL use). */
+    addBlob(bytes: Uint8Array, stableKey?: string): number | null;
+    /** Encode and append a DRAW_TEXT_RUN blob payload from segments. */
+    addTextRunBlob(segments: ReadonlyArray<Readonly<{
+        text: string;
+        style?: TextStyle;
+    }>>, stableKey?: string): number | null;
+    /** Draw a DRAW_TEXT_RUN command referencing a blob resource id. */
+    drawTextRun(x: number, y: number, blobId: number): void;
+}
+//# sourceMappingURL=drawApi.d.ts.map

package/dist/drawApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawApi.d.ts","sourceRoot":"","sources":["../src/drawApi.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAMpD;;;;;;;;GAQG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAE7D;;;;;;;;OAQG;IACH,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAE9E;;;;;;;OAOG;IACH,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAEtE;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3D;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAAC;IAEhB,uFAAuF;IACvF,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAE9D,oEAAoE;IACpE,cAAc,CACZ,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC,EACtE,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CAAC;IAEjB,mEAAmE;IACnE,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACzD"}