@gridland/web 0.1.0

package/dist/next-plugin.d.cts

@@ -0,0 +1,22 @@
+type WebpackConfig = any;
+type WebpackInstance = any;
+interface NextConfig {
+    webpack?: (config: WebpackConfig, context: {
+        isServer: boolean;
+        webpack: WebpackInstance;
+    }) => WebpackConfig;
+    [key: string]: any;
+}
+/**
+ * Next.js plugin that configures webpack for Gridland.
+ * Equivalent to `gridlandWebPlugin()` for Vite — handles module aliases,
+ * FFI shims, tree-sitter stubs, Node.js built-in stubs, and circular
+ * dependency fixes.
+ *
+ * Requires @opentui/core, @opentui/react, and @opentui/ui as peer dependencies.
+ *
+ * @param nextConfig - Optional additional Next.js config to merge
+ */
+declare function withGridland(nextConfig?: NextConfig): NextConfig;
+
+export { withGridland };

package/dist/next-plugin.d.ts

@@ -0,0 +1,22 @@
+type WebpackConfig = any;
+type WebpackInstance = any;
+interface NextConfig {
+    webpack?: (config: WebpackConfig, context: {
+        isServer: boolean;
+        webpack: WebpackInstance;
+    }) => WebpackConfig;
+    [key: string]: any;
+}
+/**
+ * Next.js plugin that configures webpack for Gridland.
+ * Equivalent to `gridlandWebPlugin()` for Vite — handles module aliases,
+ * FFI shims, tree-sitter stubs, Node.js built-in stubs, and circular
+ * dependency fixes.
+ *
+ * Requires @opentui/core, @opentui/react, and @opentui/ui as peer dependencies.
+ *
+ * @param nextConfig - Optional additional Next.js config to merge
+ */
+declare function withGridland(nextConfig?: NextConfig): NextConfig;
+
+export { withGridland };

package/dist/next-plugin.js

@@ -0,0 +1,112 @@
+// src/next-plugin.ts
+import path from "path";
+function withGridland(nextConfig = {}) {
+  const pkgRoot = path.resolve(__dirname, "..");
+  const opentuiRoot = path.resolve(pkgRoot, "../../opentui");
+  const coreRoot = path.resolve(opentuiRoot, "packages/core");
+  const reactRoot = path.resolve(opentuiRoot, "packages/react");
+  const uiRoot = path.resolve(opentuiRoot, "packages/ui");
+  function shimPath(p) {
+    return path.resolve(pkgRoot, p);
+  }
+  const coreFileShims = {
+    zig: "src/shims/zig-stub.ts",
+    buffer: "src/browser-buffer.ts",
+    "text-buffer": "src/shims/text-buffer-shim.ts",
+    "text-buffer-view": "src/shims/text-buffer-view-shim.ts",
+    "syntax-style": "src/shims/syntax-style-shim.ts",
+    renderer: "src/shims/renderer-stub.ts",
+    console: "src/shims/console-stub.ts",
+    "edit-buffer": "src/shims/edit-buffer-stub.ts",
+    "editor-view": "src/shims/editor-view-stub.ts",
+    NativeSpanFeed: "src/shims/native-span-feed-stub.ts",
+    "post/filters": "src/shims/filters-stub.ts",
+    "animation/Timeline": "src/shims/timeline-stub.ts"
+  };
+  const userWebpack = nextConfig.webpack;
+  return {
+    ...nextConfig,
+    webpack: (config, context) => {
+      const { isServer, webpack } = context;
+      if (userWebpack) {
+        config = userWebpack(config, context);
+      }
+      const sharedAliases = {
+        // @opentui packages — core-shims includes all exports @opentui/react needs
+        "@opentui/core": shimPath("src/core-shims/index.ts"),
+        "@opentui/react": path.resolve(reactRoot, "src/index.ts"),
+        "@opentui/ui": path.resolve(uiRoot, "src/index.ts"),
+        // FFI shims (no Zig/Bun on server or client in browser context)
+        "bun:ffi": shimPath("src/shims/bun-ffi.ts"),
+        "bun-ffi-structs": shimPath("src/shims/bun-ffi-structs.ts"),
+        bun: shimPath("src/shims/bun-ffi.ts"),
+        // Tree-sitter stubs — IMPORTANT: longer prefix must come first to avoid
+        // "tree-sitter" matching "tree-sitter-styled-text" (webpack prefix match)
+        "tree-sitter-styled-text": shimPath("src/shims/tree-sitter-styled-text-stub.ts"),
+        "web-tree-sitter": shimPath("src/shims/tree-sitter-stub.ts"),
+        "hast-styled-text": shimPath("src/shims/hast-stub.ts"),
+        // Internal tree-sitter source directories (pulled in via renderable imports)
+        [path.resolve(coreRoot, "src/lib/tree-sitter-styled-text")]: shimPath("src/shims/tree-sitter-styled-text-stub.ts"),
+        [path.resolve(coreRoot, "src/lib/tree-sitter")]: shimPath("src/shims/tree-sitter-stub.ts"),
+        [path.resolve(coreRoot, "src/lib/hast-styled-text")]: shimPath("src/shims/hast-stub.ts"),
+        // Devtools polyfill stub (original uses top-level await for ws import)
+        [path.resolve(reactRoot, "src/reconciler/devtools-polyfill")]: shimPath("src/shims/devtools-polyfill-stub.ts")
+      };
+      for (const [key, shimFile] of Object.entries(coreFileShims)) {
+        sharedAliases[path.resolve(coreRoot, "src", key)] = shimPath(shimFile);
+      }
+      config.resolve = config.resolve || {};
+      config.resolve.alias = {
+        ...config.resolve.alias,
+        ...sharedAliases
+      };
+      const renderablesDir = path.resolve(coreRoot, "src/renderables");
+      config.plugins.push(
+        new webpack.NormalModuleReplacementPlugin(/^\.\.\/index$/, (resource) => {
+          if (resource.context === renderablesDir) {
+            resource.request = shimPath("src/shims/slider-deps.ts");
+          }
+        })
+      );
+      if (!isServer) {
+        const clientAliases = {
+          "node:console": shimPath("src/shims/console.ts"),
+          "events$": shimPath("src/shims/events-shim.ts"),
+          "fs/promises": shimPath("src/shims/node-fs.ts"),
+          "fs$": shimPath("src/shims/node-fs.ts"),
+          "path$": shimPath("src/shims/node-path.ts"),
+          "util$": shimPath("src/shims/node-util.ts"),
+          "os$": shimPath("src/shims/node-os.ts"),
+          "stream$": shimPath("src/shims/node-stream.ts"),
+          "url$": shimPath("src/shims/node-url.ts")
+        };
+        config.resolve.alias = {
+          ...config.resolve.alias,
+          ...clientAliases
+        };
+        config.resolve.modules = [
+          ...config.resolve.modules || [],
+          path.resolve(pkgRoot, "node_modules"),
+          path.resolve(pkgRoot, "../../node_modules")
+        ];
+        config.plugins.push(
+          new webpack.NormalModuleReplacementPlugin(/^node:/, (resource) => {
+            resource.request = resource.request.replace(/^node:/, "");
+          }),
+          new webpack.NormalModuleReplacementPlugin(/^bun:/, (resource) => {
+            resource.request = resource.request.replace(/^bun:/, "");
+          })
+        );
+      }
+      config.experiments = {
+        ...config.experiments,
+        topLevelAwait: true
+      };
+      return config;
+    }
+  };
+}
+export {
+  withGridland
+};
+//# sourceMappingURL=next-plugin.js.map

package/dist/next-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/next-plugin.ts"],"sourcesContent":["import path from \"path\"\n\ntype WebpackConfig = any\ntype WebpackInstance = any\n\ninterface NextConfig {\n  webpack?: (config: WebpackConfig, context: { isServer: boolean; webpack: WebpackInstance }) => WebpackConfig\n  [key: string]: any\n}\n\n/**\n * Next.js plugin that configures webpack for Gridland.\n * Equivalent to `gridlandWebPlugin()` for Vite — handles module aliases,\n * FFI shims, tree-sitter stubs, Node.js built-in stubs, and circular\n * dependency fixes.\n *\n * Requires @opentui/core, @opentui/react, and @opentui/ui as peer dependencies.\n *\n * @param nextConfig - Optional additional Next.js config to merge\n */\nexport function withGridland(nextConfig: NextConfig = {}): NextConfig {\n  // __dirname works natively in CJS; tsup shims it for ESM via import.meta.url\n  const pkgRoot = path.resolve(__dirname, \"..\")\n\n  // Resolve opentui package roots from the git submodule\n  const opentuiRoot = path.resolve(pkgRoot, \"../../opentui\")\n  const coreRoot = path.resolve(opentuiRoot, \"packages/core\")\n  const reactRoot = path.resolve(opentuiRoot, \"packages/react\")\n  const uiRoot = path.resolve(opentuiRoot, \"packages/ui\")\n\n  function shimPath(p: string) {\n    return path.resolve(pkgRoot, p)\n  }\n\n  // Core shims — same mappings as the Vite plugin\n  const coreFileShims: Record<string, string> = {\n    zig: \"src/shims/zig-stub.ts\",\n    buffer: \"src/browser-buffer.ts\",\n    \"text-buffer\": \"src/shims/text-buffer-shim.ts\",\n    \"text-buffer-view\": \"src/shims/text-buffer-view-shim.ts\",\n    \"syntax-style\": \"src/shims/syntax-style-shim.ts\",\n    renderer: \"src/shims/renderer-stub.ts\",\n    console: \"src/shims/console-stub.ts\",\n    \"edit-buffer\": \"src/shims/edit-buffer-stub.ts\",\n    \"editor-view\": \"src/shims/editor-view-stub.ts\",\n    NativeSpanFeed: \"src/shims/native-span-feed-stub.ts\",\n    \"post/filters\": \"src/shims/filters-stub.ts\",\n    \"animation/Timeline\": \"src/shims/timeline-stub.ts\",\n  }\n\n  const userWebpack = nextConfig.webpack\n\n  return {\n    ...nextConfig,\n    webpack: (config: WebpackConfig, context: { isServer: boolean; webpack: WebpackInstance }) => {\n      const { isServer, webpack } = context\n\n      // Chain user's webpack config first if provided\n      if (userWebpack) {\n        config = userWebpack(config, context)\n      }\n\n      // Aliases needed on BOTH server and client (opentui packages, FFI stubs,\n      // tree-sitter stubs, core file shims). The server doesn't actually render\n      // the TUI but still walks the module graph for \"use client\" components.\n      const sharedAliases: Record<string, string> = {\n        // @opentui packages — core-shims includes all exports @opentui/react needs\n        \"@opentui/core\": shimPath(\"src/core-shims/index.ts\"),\n        \"@opentui/react\": path.resolve(reactRoot, \"src/index.ts\"),\n        \"@opentui/ui\": path.resolve(uiRoot, \"src/index.ts\"),\n\n        // FFI shims (no Zig/Bun on server or client in browser context)\n        \"bun:ffi\": shimPath(\"src/shims/bun-ffi.ts\"),\n        \"bun-ffi-structs\": shimPath(\"src/shims/bun-ffi-structs.ts\"),\n        bun: shimPath(\"src/shims/bun-ffi.ts\"),\n\n        // Tree-sitter stubs — IMPORTANT: longer prefix must come first to avoid\n        // \"tree-sitter\" matching \"tree-sitter-styled-text\" (webpack prefix match)\n        \"tree-sitter-styled-text\": shimPath(\"src/shims/tree-sitter-styled-text-stub.ts\"),\n        \"web-tree-sitter\": shimPath(\"src/shims/tree-sitter-stub.ts\"),\n        \"hast-styled-text\": shimPath(\"src/shims/hast-stub.ts\"),\n        // Internal tree-sitter source directories (pulled in via renderable imports)\n        [path.resolve(coreRoot, \"src/lib/tree-sitter-styled-text\")]:\n          shimPath(\"src/shims/tree-sitter-styled-text-stub.ts\"),\n        [path.resolve(coreRoot, \"src/lib/tree-sitter\")]:\n          shimPath(\"src/shims/tree-sitter-stub.ts\"),\n        [path.resolve(coreRoot, \"src/lib/hast-styled-text\")]:\n          shimPath(\"src/shims/hast-stub.ts\"),\n\n        // Devtools polyfill stub (original uses top-level await for ws import)\n        [path.resolve(reactRoot, \"src/reconciler/devtools-polyfill\")]:\n          shimPath(\"src/shims/devtools-polyfill-stub.ts\"),\n      }\n\n      // Core file shims (opentui source → browser shim)\n      for (const [key, shimFile] of Object.entries(coreFileShims)) {\n        sharedAliases[path.resolve(coreRoot, \"src\", key)] = shimPath(shimFile)\n      }\n\n      config.resolve = config.resolve || {}\n      config.resolve.alias = {\n        ...config.resolve.alias,\n        ...sharedAliases,\n      }\n\n      // Slider circular dependency fix: Slider.ts imports from \"../index\" which\n      // creates barrel → renderables → Slider → barrel cycle. Redirect to a\n      // minimal deps file that provides only what Slider needs.\n      const renderablesDir = path.resolve(coreRoot, \"src/renderables\")\n      config.plugins.push(\n        new webpack.NormalModuleReplacementPlugin(/^\\.\\.\\/index$/, (resource: any) => {\n          if (resource.context === renderablesDir) {\n            resource.request = shimPath(\"src/shims/slider-deps.ts\")\n          }\n        }),\n      )\n\n      if (!isServer) {\n        // Client-only: Node.js built-in stubs, events shim, console shim.\n        // Use \"$\" suffix for exact match to prevent \"fs\" from matching \"fs/promises\".\n        const clientAliases: Record<string, string> = {\n          \"node:console\": shimPath(\"src/shims/console.ts\"),\n          \"events$\": shimPath(\"src/shims/events-shim.ts\"),\n          \"fs/promises\": shimPath(\"src/shims/node-fs.ts\"),\n          \"fs$\": shimPath(\"src/shims/node-fs.ts\"),\n          \"path$\": shimPath(\"src/shims/node-path.ts\"),\n          \"util$\": shimPath(\"src/shims/node-util.ts\"),\n          \"os$\": shimPath(\"src/shims/node-os.ts\"),\n          \"stream$\": shimPath(\"src/shims/node-stream.ts\"),\n          \"url$\": shimPath(\"src/shims/node-url.ts\"),\n        }\n\n        config.resolve.alias = {\n          ...config.resolve.alias,\n          ...clientAliases,\n        }\n\n        // Allow webpack to resolve modules from our workspace node_modules\n        config.resolve.modules = [\n          ...(config.resolve.modules || []),\n          path.resolve(pkgRoot, \"node_modules\"),\n          path.resolve(pkgRoot, \"../../node_modules\"),\n        ]\n\n        // Strip `node:` and `bun:` prefixes from imports so they resolve\n        // through aliases. Webpack 5 treats these as unhandled URL schemes.\n        config.plugins.push(\n          new webpack.NormalModuleReplacementPlugin(/^node:/, (resource: any) => {\n            resource.request = resource.request.replace(/^node:/, \"\")\n          }),\n          new webpack.NormalModuleReplacementPlugin(/^bun:/, (resource: any) => {\n            resource.request = resource.request.replace(/^bun:/, \"\")\n          }),\n        )\n      }\n\n      // Enable top-level await (used by opentui source code)\n      config.experiments = {\n        ...config.experiments,\n        topLevelAwait: true,\n      }\n\n      return config\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/next.d.ts

@@ -0,0 +1,337 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode, CSSProperties } from 'react';
+import { EventEmitter } from 'events';
+
+declare class RGBA {
+    buffer: Float32Array;
+    constructor(buffer: Float32Array);
+    static fromArray(array: Float32Array): RGBA;
+    static fromValues(r: number, g: number, b: number, a?: number): RGBA;
+    static fromInts(r: number, g: number, b: number, a?: number): RGBA;
+    static fromHex(hex: string): RGBA;
+    get r(): number;
+    set r(v: number);
+    get g(): number;
+    set g(v: number);
+    get b(): number;
+    set b(v: number);
+    get a(): number;
+    set a(v: number);
+    toInts(): [number, number, number, number];
+    map<R>(fn: (value: number) => R): R[];
+    toString(): string;
+    equals(other?: RGBA): boolean;
+}
+
+type CursorStyle = "block" | "line" | "underline";
+type MousePointerStyle = "default" | "pointer" | "text" | "crosshair" | "move" | "not-allowed";
+type WidthMethod$1 = "wcwidth" | "unicode";
+interface CursorStyleOptions {
+    style?: CursorStyle;
+    blinking?: boolean;
+    color?: RGBA;
+    cursor?: MousePointerStyle;
+}
+interface RenderContext {
+    addToHitGrid: (x: number, y: number, width: number, height: number, id: number) => void;
+    pushHitGridScissorRect: (x: number, y: number, width: number, height: number) => void;
+    popHitGridScissorRect: () => void;
+    clearHitGridScissorRects: () => void;
+    width: number;
+    height: number;
+    requestRender: () => void;
+    setCursorPosition: (x: number, y: number, visible: boolean) => void;
+    setCursorStyle: (options: CursorStyleOptions) => void;
+    setCursorColor: (color: RGBA) => void;
+    setMousePointer: (shape: MousePointerStyle) => void;
+    widthMethod: WidthMethod$1;
+    capabilities: any | null;
+    requestLive: () => void;
+    dropLive: () => void;
+    hasSelection: boolean;
+    getSelection: () => any | null;
+    requestSelectionUpdate: () => void;
+    currentFocusedRenderable: any | null;
+    focusRenderable: (renderable: any) => void;
+    registerLifecyclePass: (renderable: any) => void;
+    unregisterLifecyclePass: (renderable: any) => void;
+    getLifecyclePasses: () => Set<any>;
+    keyInput: any;
+    _internalKeyInput: any;
+    clearSelection: () => void;
+    startSelection: (renderable: any, x: number, y: number) => void;
+    updateSelection: (currentRenderable: any | undefined, x: number, y: number, options?: {
+        finishDragging?: boolean;
+    }) => void;
+    on: (event: string, listener: (...args: any[]) => void) => any;
+    off: (event: string, listener: (...args: any[]) => void) => any;
+    emit: (event: string, ...args: any[]) => boolean;
+    removeAllListeners: (event?: string) => any;
+}
+interface CapturedSpan {
+    text: string;
+    fg: RGBA;
+    bg: RGBA;
+    attributes: number;
+    width: number;
+}
+interface CapturedLine {
+    spans: CapturedSpan[];
+}
+
+type WidthMethod = "wcwidth" | "unicode";
+interface BorderDrawOptions {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    borderStyle?: string;
+    customBorderChars?: Uint32Array;
+    border: boolean | string[];
+    borderColor: RGBA;
+    backgroundColor: RGBA;
+    shouldFill?: boolean;
+    title?: string;
+    titleAlignment?: "left" | "center" | "right";
+}
+declare class BrowserBuffer {
+    id: string;
+    respectAlpha: boolean;
+    private _width;
+    private _height;
+    private _widthMethod;
+    char: Uint32Array;
+    fg: Float32Array;
+    bg: Float32Array;
+    attributes: Uint32Array;
+    private scissorStack;
+    private opacityStack;
+    linkRegistry: Map<number, string>;
+    private nextLinkId;
+    constructor(width: number, height: number, options?: {
+        respectAlpha?: boolean;
+        id?: string;
+        widthMethod?: WidthMethod;
+    });
+    static create(width: number, height: number, widthMethod: WidthMethod, options?: {
+        respectAlpha?: boolean;
+        id?: string;
+    }): BrowserBuffer;
+    get width(): number;
+    get height(): number;
+    get widthMethod(): WidthMethod;
+    get ptr(): number;
+    get buffers(): {
+        char: Uint32Array<ArrayBufferLike>;
+        fg: Float32Array<ArrayBufferLike>;
+        bg: Float32Array<ArrayBufferLike>;
+        attributes: Uint32Array<ArrayBufferLike>;
+    };
+    setRespectAlpha(respectAlpha: boolean): void;
+    getNativeId(): string;
+    registerLink(url: string): number;
+    getLinkUrl(linkId: number): string | undefined;
+    private isInScissor;
+    private getCurrentOpacityMultiplier;
+    private applyOpacity;
+    clear(bg?: RGBA): void;
+    setCell(x: number, y: number, char: string, fgColor: RGBA, bgColor: RGBA, attr?: number): void;
+    setCellWithAlphaBlending(x: number, y: number, char: string, fgColor: RGBA, bgColor: RGBA, attr?: number): void;
+    drawChar(charCode: number, x: number, y: number, fgColor: RGBA, bgColor: RGBA, attr?: number): void;
+    drawText(text: string, x: number, y: number, fgColor: RGBA, bgColor?: RGBA, attr?: number, _selection?: {
+        start: number;
+        end: number;
+        bgColor?: RGBA;
+        fgColor?: RGBA;
+    } | null): void;
+    fillRect(x: number, y: number, width: number, height: number, bgColor: RGBA): void;
+    drawBox(options: BorderDrawOptions): void;
+    private getDefaultBorderChars;
+    pushScissorRect(x: number, y: number, width: number, height: number): void;
+    popScissorRect(): void;
+    clearScissorRects(): void;
+    pushOpacity(opacity: number): void;
+    popOpacity(): void;
+    getCurrentOpacity(): number;
+    clearOpacity(): void;
+    resize(width: number, height: number): void;
+    getSpanLines(): CapturedLine[];
+    drawTextBufferView(view: any, x: number, y: number): void;
+    drawTextBuffer(textBufferView: any, x: number, y: number): void;
+    drawFrameBuffer(destX: number, destY: number, frameBuffer: BrowserBuffer, sourceX?: number, sourceY?: number, sourceWidth?: number, sourceHeight?: number): void;
+    drawEditorView(editorView: any, x: number, y: number): void;
+    drawSuperSampleBuffer(): void;
+    drawPackedBuffer(): void;
+    drawGrayscaleBuffer(): void;
+    drawGrayscaleBufferSupersampled(): void;
+    drawGrid(): void;
+    encodeUnicode(_text: string): null;
+    freeUnicode(): void;
+    getRealCharBytes(): Uint8Array;
+    destroy(): void;
+}
+
+declare class BrowserKeyHandler extends EventEmitter {
+    constructor();
+    processInput(_data: string): boolean;
+}
+declare class BrowserInternalKeyHandler extends BrowserKeyHandler {
+    private renderableHandlers;
+    onInternal(event: string, handler: Function): void;
+    offInternal(event: string, handler: Function): void;
+    emit(event: string, ...args: any[]): boolean;
+}
+declare class BrowserRenderContext extends EventEmitter implements RenderContext {
+    private _width;
+    private _height;
+    private _widthMethod;
+    private _renderRequested;
+    private _onRenderRequest;
+    private _lifecyclePasses;
+    private _focusedRenderable;
+    keyInput: BrowserKeyHandler;
+    _internalKeyInput: BrowserInternalKeyHandler;
+    constructor(width: number, height: number, widthMethod?: WidthMethod$1);
+    get width(): number;
+    get height(): number;
+    get widthMethod(): WidthMethod$1;
+    get capabilities(): any;
+    get hasSelection(): boolean;
+    get currentFocusedRenderable(): any | null;
+    setOnRenderRequest(callback: () => void): void;
+    resize(width: number, height: number): void;
+    addToHitGrid(_x: number, _y: number, _width: number, _height: number, _id: number): void;
+    pushHitGridScissorRect(_x: number, _y: number, _width: number, _height: number): void;
+    popHitGridScissorRect(): void;
+    clearHitGridScissorRects(): void;
+    requestRender(): void;
+    setCursorPosition(_x: number, _y: number, _visible: boolean): void;
+    setCursorStyle(_options: CursorStyleOptions): void;
+    setCursorColor(_color: RGBA): void;
+    setMousePointer(_shape: MousePointerStyle): void;
+    requestLive(): void;
+    dropLive(): void;
+    getSelection(): any | null;
+    requestSelectionUpdate(): void;
+    focusRenderable(renderable: any): void;
+    registerLifecyclePass(renderable: any): void;
+    unregisterLifecyclePass(renderable: any): void;
+    getLifecyclePasses(): Set<any>;
+    clearSelection(): void;
+    startSelection(_renderable: any, _x: number, _y: number): void;
+    updateSelection(_currentRenderable: any | undefined, _x: number, _y: number, _options?: {
+        finishDragging?: boolean;
+    }): void;
+}
+
+interface SelectionRange {
+    startCol: number;
+    startRow: number;
+    endCol: number;
+    endRow: number;
+}
+declare class SelectionManager {
+    private _startCol;
+    private _startRow;
+    private _endCol;
+    private _endRow;
+    private _active;
+    private _selecting;
+    startSelection(col: number, row: number): void;
+    updateSelection(col: number, row: number): void;
+    endSelection(): void;
+    clearSelection(): void;
+    get active(): boolean;
+    get selecting(): boolean;
+    /** Returns the selection range normalized to reading order (top-left to bottom-right) */
+    getSelectedRange(): SelectionRange | null;
+    isSelected(col: number, row: number): boolean;
+    getSelectedText(buffer: BrowserBuffer): string;
+}
+
+interface CanvasPainterOptions {
+    fontFamily?: string;
+    fontSize?: number;
+}
+declare class CanvasPainter {
+    private cellWidth;
+    private cellHeight;
+    private fontFamily;
+    private fontSize;
+    private baselineOffset;
+    constructor(options?: CanvasPainterOptions);
+    measureCell(ctx: CanvasRenderingContext2D): {
+        width: number;
+        height: number;
+    };
+    getCellSize(): {
+        width: number;
+        height: number;
+    };
+    paint(ctx: CanvasRenderingContext2D, buffer: BrowserBuffer, selection?: SelectionManager): void;
+}
+
+declare class BrowserRenderer {
+    canvas: HTMLCanvasElement;
+    ctx2d: CanvasRenderingContext2D;
+    buffer: BrowserBuffer;
+    renderContext: BrowserRenderContext;
+    root: any;
+    painter: CanvasPainter;
+    selection: SelectionManager;
+    private cols;
+    private rows;
+    private cellWidth;
+    private cellHeight;
+    private rafId;
+    private lastTime;
+    private needsRender;
+    private isDragOver;
+    private cleanupListeners;
+    private mouseDownCell;
+    constructor(canvas: HTMLCanvasElement, cols: number, rows: number);
+    private pixelToCell;
+    private setupDomListeners;
+    start(): void;
+    stop(): void;
+    private loop;
+    resize(cols: number, rows: number): void;
+    private static PREVENT_DEFAULT_KEYS;
+    private static MODIFIER_KEYS;
+    private static KEY_MAP;
+    handleKeyDown(event: KeyboardEvent): void;
+}
+
+interface TUIProps {
+    children: ReactNode;
+    /** CSS styles for the outer container div */
+    style?: CSSProperties;
+    /** CSS class for the outer container div */
+    className?: string;
+    /** Font size in pixels (default: 14) */
+    fontSize?: number;
+    /** Font family (default: monospace stack) */
+    fontFamily?: string;
+    /** Auto-focus the canvas for keyboard input (default: true) */
+    autoFocus?: boolean;
+    /** Called when the renderer is ready */
+    onReady?: (renderer: BrowserRenderer) => void;
+}
+/**
+ * A single React component that renders TUI content to an HTML5 Canvas.
+ * Gridland is built on the opentui engine.
+ *
+ * Usage:
+ * ```tsx
+ * <TUI style={{ width: "100%", height: 400 }}>
+ *   <box border borderStyle="rounded">
+ *     <text>Hello from Gridland!</text>
+ *   </box>
+ * </TUI>
+ * ```
+ *
+ * No dynamic imports, no wrapper chains. Just a component.
+ */
+declare function TUI({ children, style, className, fontSize, fontFamily, autoFocus, onReady, }: TUIProps): react_jsx_runtime.JSX.Element;
+
+export { TUI, type TUIProps };