@textjs/app 0.0.0-stage → 1.0.3

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyGH,yCAAyC;AACzC,MAAM,UAAU,YAAY,CAAC,MAAkB;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC;AAyBD,MAAM,UAAU,cAAc,CAAC,MAAkB;IAC/C,OAAO;QACL,QAAQ,EAAE,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE;QAChC,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI;QAC3C,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,KAAK;QACpD,QAAQ,EAAE,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC5C,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;QACzB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/F,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAA4B;IAC5D,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,GAAG;QAAE,OAAO,EAAE,CAAC;IAC7C,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC;IACvE,OAAO,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,44 @@
+import { type TextTheme, type ThemeName } from "@textjs/react";
+import type { RouterHistory, RouterLocation } from "./history.js";
+import type { ResolvedMetadata, RouteManifest, RouteMatch } from "./routing.js";
+export interface NavigateOptions {
+    /** Accepted for Next.js parity; console frames have no document scroll. */
+    scroll?: boolean;
+}
+export interface AppRouterInstance {
+    push(href: string, options?: NavigateOptions): void;
+    replace(href: string, options?: NavigateOptions): void;
+    back(): void;
+    forward(): void;
+    /** Re-render the current route and reset its error boundaries. */
+    refresh(): void;
+    /** Preload a lazy route's modules. */
+    prefetch(href: string): void;
+}
+export interface RouterState {
+    location: RouterLocation;
+    match: RouteMatch;
+    metadata: ResolvedMetadata;
+    router: AppRouterInstance;
+    history: RouterHistory;
+    manifest: RouteManifest;
+    /** Bumped by `router.refresh()`. */
+    refreshKey: number;
+}
+export declare const RouterContext: import("react").Context<RouterState | null>;
+export declare function useRouterState(): RouterState;
+export declare function useOptionalRouterState(): RouterState | null;
+/** App-wide shell controls (theme presets, wireframe) shared by DevTools and user settings pages. */
+export interface AppShellState {
+    theme: TextTheme;
+    themeName: ThemeName | string;
+    setTheme(theme: TextTheme | ThemeName): void;
+    cycleTheme(): void;
+    wireframe: boolean;
+    setWireframe(enabled: boolean): void;
+}
+export declare const AppShellContext: import("react").Context<AppShellState | null>;
+/** Theme preset controls for the running app. */
+export declare function useAppTheme(): AppShellState;
+export declare function useOptionalAppShell(): AppShellState | null;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAE9E,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE7E,MAAM,WAAW,eAAe;IAC9B,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACpD,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACvD,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,IAAI,IAAI,CAAC;IAChB,kEAAkE;IAClE,OAAO,IAAI,IAAI,CAAC;IAChB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,aAAa,CAAC;IACxB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,aAAa,6CAAgF,CAAC;AAE3G,wBAAgB,cAAc,IAAI,WAAW,CAM5C;AAED,wBAAgB,sBAAsB,IAAI,WAAW,GAAG,IAAI,CAE3D;AAED,qGAAqG;AACrG,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,SAAS,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;IAC7C,UAAU,IAAI,IAAI,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACtC;AAED,eAAO,MAAM,eAAe,+CAAsF,CAAC;AAEnH,iDAAiD;AACjD,wBAAgB,WAAW,IAAI,aAAa,CAI3C;AAED,wBAAgB,mBAAmB,IAAI,aAAa,GAAG,IAAI,CAE1D"}

package/dist/context.js

@@ -0,0 +1,26 @@
+import { useContext } from "react";
+import { sharedContext } from "@textjs/react";
+import { txError } from "@textjs/core";
+export const RouterContext = sharedContext("routerContext", null, "TextRouterContext");
+export function useRouterState() {
+    const state = useContext(RouterContext);
+    if (state === null) {
+        throw txError("TX014", "Navigation hooks");
+    }
+    return state;
+}
+export function useOptionalRouterState() {
+    return useContext(RouterContext);
+}
+export const AppShellContext = sharedContext("appShellContext", null, "TextAppShellContext");
+/** Theme preset controls for the running app. */
+export function useAppTheme() {
+    const state = useContext(AppShellContext);
+    if (state === null)
+        throw txError("TX014", "useAppTheme()");
+    return state;
+}
+export function useOptionalAppShell() {
+    return useContext(AppShellContext);
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,aAAa,EAAkC,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA+BvC,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAqB,eAAe,EAAE,IAAI,EAAE,mBAAmB,CAAC,CAAC;AAE3G,MAAM,UAAU,cAAc;IAC5B,MAAM,KAAK,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IACxC,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,MAAM,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,UAAU,CAAC,aAAa,CAAC,CAAC;AACnC,CAAC;AAYD,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAuB,iBAAiB,EAAE,IAAI,EAAE,qBAAqB,CAAC,CAAC;AAEnH,iDAAiD;AACjD,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAC1C,IAAI,KAAK,KAAK,IAAI;QAAE,MAAM,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IAC5D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,UAAU,CAAC,eAAe,CAAC,CAAC;AACrC,CAAC"}

package/dist/dev-errors.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Development error store feeding the in-console Redbox and the `[▼ !]` pill.
+ */
+export type DevErrorKind = "runtime" | "build" | "unhandled";
+export interface DevErrorLocation {
+    file: string;
+    line?: number;
+    column?: number;
+}
+export interface DevError {
+    id: number;
+    kind: DevErrorKind;
+    /** e.g. `TypeError`, `Build Error`. */
+    name: string;
+    message: string;
+    stack: string[];
+    location?: DevErrorLocation;
+    /** Code frame snippet (Vite / esbuild / Babel format). */
+    frame?: string;
+    plugin?: string;
+    componentStack?: string;
+}
+export interface DevErrorSnapshot {
+    errors: readonly DevError[];
+    /** Whether the Redbox is showing (Esc hides it until the next error). */
+    visible: boolean;
+    /** Bumped whenever errors are cleared (lets boundaries recover after a fix). */
+    generation: number;
+}
+/** Minimal shape of Vite's `ErrorPayload["err"]`. */
+export interface ViteErrorLike {
+    message: string;
+    stack?: string;
+    id?: string;
+    frame?: string;
+    plugin?: string;
+    loc?: {
+        file?: string;
+        line: number;
+        column: number;
+    };
+}
+/** Strip the dev server origin, `/@fs` and cache-busting queries from a stack URL. */
+export declare function cleanSourcePath(file: string): string;
+export declare function parseStack(stack: string | undefined): string[];
+export declare function locationFromStack(lines: readonly string[]): DevErrorLocation | undefined;
+export declare function toDevError(error: unknown, kind: DevErrorKind, id: number, componentStack?: string | null): DevError;
+export declare class DevErrorStore {
+    private snapshot;
+    private readonly listeners;
+    private nextId;
+    readonly subscribe: (listener: () => void) => (() => void);
+    readonly getSnapshot: () => DevErrorSnapshot;
+    private set;
+    private push;
+    /** Report a runtime render / event error. */
+    reportRuntime(error: unknown, componentStack?: string | null, kind?: DevErrorKind): DevError;
+    /** Report a Vite build / transform error (`vite:error`). */
+    reportBuild(err: ViteErrorLike): DevError;
+    /** Hide the Redbox (errors stay listed in DevTools until cleared). */
+    dismiss(): void;
+    show(): void;
+    /** Clear errors (all, or one kind) — e.g. after a successful HMR update. */
+    clear(kind?: DevErrorKind): void;
+}
+/** The process-wide store used by `text dev`. */
+export declare const devErrors: DevErrorStore;
+//# sourceMappingURL=dev-errors.d.ts.map

package/dist/dev-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-errors.d.ts","sourceRoot":"","sources":["../src/dev-errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC5B,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAC;IACjB,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD;AAID,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQpD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAM9D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,gBAAgB,GAAG,SAAS,CAOxF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAcnH;AAUD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAmE;IACnF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,MAAM,CAAK;IAEnB,QAAQ,CAAC,SAAS,GAAI,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAGvD;IAEF,QAAQ,CAAC,WAAW,QAAO,gBAAgB,CAAkB;IAE7D,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,IAAI;IAWZ,6CAA6C;IAC7C,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,GAAE,YAAwB,GAAG,QAAQ;IAIvG,4DAA4D;IAC5D,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,QAAQ;IAgBzC,sEAAsE;IACtE,OAAO,IAAI,IAAI;IAIf,IAAI,IAAI,IAAI;IAIZ,4EAA4E;IAC5E,KAAK,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,IAAI;CAKjC;AAED,iDAAiD;AACjD,eAAO,MAAM,SAAS,eAAsB,CAAC"}

package/dist/dev-errors.js

@@ -0,0 +1,121 @@
+/**
+ * Development error store feeding the in-console Redbox and the `[▼ !]` pill.
+ */
+const STACK_LOCATION = /\(?((?:https?:\/\/[^/\s]+)?(\/[^\s()]*?|[A-Za-z]:\\[^\s()]*?)):(\d+):(\d+)\)?\s*$/;
+/** Strip the dev server origin, `/@fs` and cache-busting queries from a stack URL. */
+export function cleanSourcePath(file) {
+    let f = file.replace(/^https?:\/\/[^/]+/, "");
+    f = f.replace(/^\/@fs/, "");
+    f = f.replace(/\?[^:]*$/, "");
+    const proc = globalThis.process;
+    const cwd = typeof proc?.cwd === "function" ? proc.cwd() : "";
+    if (cwd && f.startsWith(`${cwd}/`))
+        f = f.slice(cwd.length + 1);
+    return f.replace(/^\//, "");
+}
+export function parseStack(stack) {
+    if (!stack)
+        return [];
+    return stack
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l.startsWith("at ") || /@.+:\d+:\d+$/.test(l));
+}
+export function locationFromStack(lines) {
+    for (const line of lines) {
+        if (/node_modules|react-dom|react-reconciler|scheduler|\/@textjs\/|packages\/(react|core)\/src/.test(line))
+            continue;
+        const m = STACK_LOCATION.exec(line);
+        if (m)
+            return { file: cleanSourcePath(m[1]), line: Number(m[3]), column: Number(m[4]) };
+    }
+    return undefined;
+}
+export function toDevError(error, kind, id, componentStack) {
+    if (error instanceof Error) {
+        const stack = parseStack(error.stack);
+        return {
+            id,
+            kind,
+            name: error.name || "Error",
+            message: error.message,
+            stack,
+            location: locationFromStack(stack),
+            componentStack: componentStack ?? undefined,
+        };
+    }
+    return { id, kind, name: "Error", message: typeof error === "string" ? error : safeString(error), stack: [], componentStack: componentStack ?? undefined };
+}
+function safeString(v) {
+    try {
+        return JSON.stringify(v) ?? String(v);
+    }
+    catch {
+        return String(v);
+    }
+}
+export class DevErrorStore {
+    snapshot = { errors: [], visible: false, generation: 0 };
+    listeners = new Set();
+    nextId = 1;
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    };
+    getSnapshot = () => this.snapshot;
+    set(next) {
+        this.snapshot = next;
+        for (const l of [...this.listeners])
+            l();
+    }
+    push(entry) {
+        const errors = this.snapshot.errors;
+        const dup = errors.find((e) => e.kind === entry.kind && e.message === entry.message && e.location?.file === entry.location?.file);
+        if (dup) {
+            if (!this.snapshot.visible)
+                this.set({ ...this.snapshot, visible: true });
+            return dup;
+        }
+        this.set({ ...this.snapshot, errors: [...errors, entry].slice(-20), visible: true });
+        return entry;
+    }
+    /** Report a runtime render / event error. */
+    reportRuntime(error, componentStack, kind = "runtime") {
+        return this.push(toDevError(error, kind, this.nextId++, componentStack));
+    }
+    /** Report a Vite build / transform error (`vite:error`). */
+    reportBuild(err) {
+        const stack = parseStack(err.stack);
+        const file = err.loc?.file ?? err.id;
+        const message = err.message.replace(/\x1b\[[0-9;]*m/g, "");
+        return this.push({
+            id: this.nextId++,
+            kind: "build",
+            name: "Build Error",
+            message,
+            stack,
+            location: file ? { file: cleanSourcePath(file), line: err.loc?.line, column: err.loc?.column } : undefined,
+            frame: err.frame?.replace(/\x1b\[[0-9;]*m/g, ""),
+            plugin: err.plugin,
+        });
+    }
+    /** Hide the Redbox (errors stay listed in DevTools until cleared). */
+    dismiss() {
+        if (this.snapshot.visible)
+            this.set({ ...this.snapshot, visible: false });
+    }
+    show() {
+        if (!this.snapshot.visible && this.snapshot.errors.length > 0)
+            this.set({ ...this.snapshot, visible: true });
+    }
+    /** Clear errors (all, or one kind) — e.g. after a successful HMR update. */
+    clear(kind) {
+        const errors = kind ? this.snapshot.errors.filter((e) => e.kind !== kind) : [];
+        if (errors.length === this.snapshot.errors.length)
+            return;
+        this.set({ errors, visible: this.snapshot.visible && errors.length > 0, generation: this.snapshot.generation + 1 });
+    }
+}
+/** The process-wide store used by `text dev`. */
+export const devErrors = new DevErrorStore();
+//# sourceMappingURL=dev-errors.js.map

package/dist/dev-errors.js.map

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

package/dist/devtools.d.ts

@@ -0,0 +1,64 @@
+/**
+ * `@textjs/app/devtools` — the in-console Dev Overlay (`[▼]` pill and inspector), and the
+ * Next.js-style Redbox error overlay, all rendered inside `console.log`.
+ */
+import { type ReactNode } from "react";
+import { type KeyEvent } from "@textjs/react";
+import { type AppShellState } from "./context.js";
+import { type DevErrorStore } from "./dev-errors.js";
+import { type RouteMatch } from "./routing.js";
+export { devErrors, DevErrorStore, type DevError, type DevErrorKind, type DevErrorSnapshot, type ViteErrorLike } from "./dev-errors.js";
+/** `F2` or `` Ctrl+` `` toggles the Dev Overlay inspector. */
+export declare function isDevToolsShortcut(e: {
+    key: string;
+    code?: string;
+    ctrl: boolean;
+    meta: boolean;
+    alt: boolean;
+}): boolean;
+/** Current route details (pattern, params, `○ Static` / `ƒ Dynamic`) for inspectors. */
+export declare function useRouteInfo(): {
+    match: RouteMatch;
+    title: string | undefined;
+    pathname: string;
+};
+export interface TextDevOverlayProps {
+    /** Start with the inspector open. */
+    initialOpen?: boolean;
+    /** Also mount `<RedboxOverlay />` (default `true`). */
+    redbox?: boolean;
+    store?: DevErrorStore;
+    /** Draw the `[▼]` pill (default `true`). Without it, the shortcut still opens the inspector. */
+    pill?: boolean;
+    /** Keys that toggle the inspector (default `isDevToolsShortcut`: `F2` or `` Ctrl+` ``). */
+    shortcut?: (e: KeyEvent) => boolean;
+    /** Theme and wireframe controls for apps without the App Router, which otherwise provides them. */
+    shell?: AppShellState;
+}
+/**
+ * The `[▼]` pill in the bottom-left corner of the console frame. `F2` or
+ * `` Ctrl+` `` opens the Dev Overlay inspector.
+ */
+export declare function TextDevOverlay({ initialOpen, redbox, store, pill, shortcut, shell }: TextDevOverlayProps): ReactNode;
+export interface RedboxOverlayProps {
+    store?: DevErrorStore;
+}
+/** The Next.js-style Redbox, rendered inside `console.log`. `Esc` dismisses. */
+export declare function RedboxOverlay({ store }: RedboxOverlayProps): ReactNode;
+/** The subset of Vite's `import.meta.hot` used by the Redbox. */
+export interface HotContextLike {
+    on(event: string, callback: (payload: any) => void): void;
+    off?(event: string, callback: (payload: any) => void): void;
+}
+/**
+ * Show Vite build / syntax errors in the in-console Redbox and clear them
+ * (recovering crashed routes) once an HMR update applies cleanly.
+ */
+export declare function connectViteHmr(hot: HotContextLike, store?: DevErrorStore): () => void;
+interface ErrorTarget {
+    addEventListener(type: string, listener: (event: any) => void): void;
+    removeEventListener(type: string, listener: (event: any) => void): void;
+}
+/** Report uncaught exceptions and unhandled rejections to the Redbox. */
+export declare function installGlobalErrorHandlers(target?: ErrorTarget | undefined, store?: DevErrorStore): () => void;
+//# sourceMappingURL=devtools.d.ts.map

package/dist/devtools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools.d.ts","sourceRoot":"","sources":["../src/devtools.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAwE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE7G,OAAO,EAcL,KAAK,QAAQ,EAEd,MAAM,eAAe,CAAC;AACvB,OAAO,EAA+D,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAC5G,OAAO,EAA4B,KAAK,aAAa,EAAsB,MAAM,cAAc,CAAC;AAEhG,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAE1D,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAErI,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,CAAC,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAGzH;AAED,wFAAwF;AACxF,wBAAgB,YAAY,IAAI;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAGjG;AAmBD,MAAM,WAAW,mBAAmB;IAClC,qCAAqC;IACrC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,gGAAgG;IAChG,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,KAAK,OAAO,CAAC;IACpC,mGAAmG;IACnG,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,WAAmB,EAAE,MAAa,EAAE,KAAiB,EAAE,IAAW,EAAE,QAA6B,EAAE,KAAK,EAAE,EAAE,mBAAmB,GAAG,SAAS,CA4B3K;AA0ID,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,EAAE,KAAiB,EAAE,EAAE,kBAAkB,GAAG,SAAS,CAIlF;AAsHD,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1D,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;CAC7D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,GAAE,aAAyB,GAAG,MAAM,IAAI,CAchG;AAED,UAAU,WAAW;IACnB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;IACrE,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;CACzE;AAED,yEAAyE;AACzE,wBAAgB,0BAA0B,CAAC,MAAM,GAAE,WAAW,GAAG,SAA8D,EAAE,KAAK,GAAE,aAAyB,GAAG,MAAM,IAAI,CAe7K"}

package/dist/devtools.js

@@ -0,0 +1,186 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * `@textjs/app/devtools` — the in-console Dev Overlay (`[▼]` pill and inspector), and the
+ * Next.js-style Redbox error overlay, all rendered inside `console.log`.
+ */
+import { useContext, useLayoutEffect, useMemo, useState, useSyncExternalStore } from "react";
+import { BRAND_MARK, ENGINE_NAME, VERSION } from "@textjs/core";
+import { Badge, Box, createScope, Divider, ScopeContext, ScrollBox, Text, useApp, useConsoleStats, useInput, useRuntime, useTheme, useViewport, } from "@textjs/react";
+import { useOptionalAppShell, useOptionalRouterState, useRouterState } from "./context.js";
+import { devErrors } from "./dev-errors.js";
+import { isNavigationError } from "./navigation-errors.js";
+import { formatParams } from "./routing.js";
+export { devErrors, DevErrorStore } from "./dev-errors.js";
+/** `F2` or `` Ctrl+` `` toggles the Dev Overlay inspector. */
+export function isDevToolsShortcut(e) {
+    if (e.key === "f2" && !e.ctrl && !e.meta && !e.alt)
+        return true;
+    return e.ctrl && !e.meta && (e.key === "`" || e.code === "Backquote");
+}
+/** Current route details (pattern, params, `○ Static` / `ƒ Dynamic`) for inspectors. */
+export function useRouteInfo() {
+    const s = useRouterState();
+    return { match: s.match, title: s.metadata.title, pathname: s.location.pathname };
+}
+/** A focus + input trap for an overlay layer (like `<Modal>`, without the panel chrome). */
+function useOverlayScope() {
+    const rt = useRuntime();
+    const parent = useContext(ScopeContext);
+    const scope = useMemo(() => createScope(parent, true), [parent]);
+    useLayoutEffect(() => rt.focus.pushTrap(scope), [rt, scope]);
+    return scope;
+}
+function useErrors(store) {
+    return useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot);
+}
+/**
+ * The `[▼]` pill in the bottom-left corner of the console frame. `F2` or
+ * `` Ctrl+` `` opens the Dev Overlay inspector.
+ */
+export function TextDevOverlay({ initialOpen = false, redbox = true, store = devErrors, pill = true, shortcut = isDevToolsShortcut, shell }) {
+    const theme = useTheme();
+    const [open, setOpen] = useState(initialOpen);
+    const errors = useErrors(store);
+    const hasErrors = errors.errors.length > 0;
+    useInput((e) => {
+        if (!shortcut(e))
+            return;
+        e.stopPropagation();
+        setOpen((v) => !v);
+    }, { global: true, priority: 1000 });
+    return (_jsxs(_Fragment, { children: [pill ? (_jsx(Box, { position: "absolute", left: 0, bottom: 0, zIndex: 40, height: 1, flexDirection: "row", wireframeLabel: "devtools-pill", children: _jsx(Text, { bg: hasErrors ? theme.danger : theme.elevated, fg: hasErrors ? "#ffffff" : theme.muted, bold: hasErrors, wrap: "nowrap", children: hasErrors ? `[${BRAND_MARK} !]` : `[${BRAND_MARK}]` }) })) : null, open ? _jsx(DevToolsPanel, { store: store, shell: shell, onClose: () => setOpen(false) }) : null, redbox && !open ? _jsx(RedboxOverlay, { store: store }) : null] }));
+}
+function Row({ label, children, color }) {
+    const theme = useTheme();
+    return (_jsxs(Box, { height: 1, flexDirection: "row", flexShrink: 0, children: [_jsx(Text, { color: theme.subtle, wrap: "nowrap", width: 10, flexShrink: 0, children: label }), _jsx(Text, { color: color ?? theme.fg, wrap: "truncate-end", flexShrink: 1, children: children })] }));
+}
+function Section({ title, children }) {
+    const theme = useTheme();
+    return (_jsxs(Box, { flexDirection: "column", flexGrow: 1, flexBasis: 0, minWidth: 24, children: [_jsx(Text, { color: theme.muted, bold: true, wrap: "nowrap", children: title }), children] }));
+}
+function ms(n) {
+    return `${n.toFixed(2)}ms`;
+}
+function DevToolsPanel(props) {
+    const scope = useOverlayScope();
+    return (_jsx(ScopeContext, { value: scope, children: _jsx(DevToolsPanelBody, { ...props }) }));
+}
+function DevToolsPanelBody({ store, shell: shellProp, onClose }) {
+    const theme = useTheme();
+    const app = useApp();
+    const viewport = useViewport();
+    const stats = useConsoleStats({ interval: 250 });
+    const contextShell = useOptionalAppShell();
+    const shell = shellProp ?? contextShell;
+    const router = useOptionalRouterState();
+    const errors = useErrors(store);
+    const [localWireframe, setLocalWireframe] = useState(false);
+    const wireframe = shell ? shell.wireframe : localWireframe;
+    useInput((e) => {
+        if (e.ctrl || e.meta || e.alt)
+            return;
+        if (e.key === "escape")
+            onClose();
+        else if (e.key === "w") {
+            if (shell)
+                shell.setWireframe(!wireframe);
+            else {
+                app.renderer.setWireframe(!localWireframe);
+                setLocalWireframe(!localWireframe);
+            }
+        }
+        else if (e.key === "t")
+            shell?.cycleTheme();
+        else if (e.key === "r")
+            viewport.setResponsive(!viewport.responsive);
+        else if (e.key === "return" && errors.errors.length > 0) {
+            store.show();
+            onClose();
+        }
+        else
+            return;
+        e.stopPropagation();
+    });
+    const match = router?.match;
+    const typeLabel = match ? (match.notFound ? "⚠ Not Found" : match.dynamic ? "ƒ Dynamic" : "○ Static") : "—";
+    return (_jsx(Box, { position: "absolute", top: 0, left: 0, right: 0, bottom: 0, zIndex: 45, backdropDim: 0.45, flexDirection: "column", justifyContent: "flex-end", wireframeLabel: "devtools", children: _jsx(Box, { flexDirection: "column", flexShrink: 0, border: "rounded", borderColor: theme.borderFocus, bg: theme.elevated, fg: theme.fg, paddingX: 1, title: ` ${BRAND_MARK} Dev Overlay · ${ENGINE_NAME} `, titleColor: theme.fg, bottomTitle: " W wireframe \u00B7 T theme \u00B7 R viewport \u00B7 esc close ", bottomTitleColor: theme.subtle, bottomTitleAlign: "right", children: _jsxs(Box, { flexDirection: "row", flexWrap: "wrap", columnGap: 2, children: [_jsxs(Section, { title: "ROUTE", children: [_jsx(Row, { label: "type", color: match?.dynamic ? theme.warning : theme.success, children: typeLabel }), _jsx(Row, { label: "pattern", children: match?.pattern ?? "—" }), _jsx(Row, { label: "pathname", children: router?.location.pathname ?? (typeof location !== "undefined" ? location.pathname : "—") }), _jsx(Row, { label: "params", children: match ? formatParams(match.params) : "{}" }), _jsx(Row, { label: "title", children: router?.metadata.title ?? "—" }), _jsx(Row, { label: "segments", children: match ? String(match.chain.length) : "0" })] }), _jsxs(Section, { title: "FRAME", children: [_jsx(Row, { label: "grid", children: `${stats.cols}×${stats.rows} cells` }), _jsx(Row, { label: "spans", children: `${stats.spanCount} %c spans` }), _jsx(Row, { label: "total", children: ms(stats.totalMs) }), _jsx(Row, { label: "phases", children: `${stats.layoutMs.toFixed(2)} / ${stats.rasterMs.toFixed(2)} / ${stats.encodeMs.toFixed(2)}` }), _jsx(Row, { label: "yoga", children: `${stats.yogaNodes} nodes` }), _jsx(Row, { label: "gated", color: theme.success, children: `${stats.skippedFrames} noop frames` })] }), _jsxs(Section, { title: "TOGGLES", children: [_jsx(Row, { label: "[W] wire", color: wireframe ? theme.success : theme.muted, children: wireframe ? "on" : "off" }), _jsx(Row, { label: "[T] theme", color: theme.accent, children: shell ? shell.theme.name : theme.name }), _jsx(Row, { label: "[R] view", children: viewport.responsive ? "responsive" : `fixed ${viewport.cols}×${viewport.rows}` }), _jsx(Row, { label: "issues", color: errors.errors.length > 0 ? theme.danger : theme.success, children: errors.errors.length > 0 ? `${errors.errors.length} · enter to open` : "0 · all clear" }), _jsx(Row, { label: "engine", children: `${ENGINE_NAME} ${VERSION}` })] })] }) }) }));
+}
+/** The Next.js-style Redbox, rendered inside `console.log`. `Esc` dismisses. */
+export function RedboxOverlay({ store = devErrors }) {
+    const snap = useErrors(store);
+    if (!snap.visible || snap.errors.length === 0)
+        return null;
+    return _jsx(RedboxLayer, { store: store, errors: snap.errors });
+}
+function RedboxLayer({ store, errors }) {
+    const scope = useOverlayScope();
+    return (_jsx(ScopeContext, { value: scope, children: _jsx(RedboxBody, { store: store, errors: errors }) }));
+}
+function RedboxBody({ store, errors }) {
+    const theme = useTheme();
+    const [index, setIndex] = useState(errors.length - 1);
+    const i = Math.max(0, Math.min(errors.length - 1, index));
+    const err = errors[i];
+    useInput((e) => {
+        if (e.key === "escape")
+            store.dismiss();
+        else if (e.key === "left")
+            setIndex(Math.max(0, i - 1));
+        else if (e.key === "right")
+            setIndex(Math.min(errors.length - 1, i + 1));
+        else
+            return;
+        e.stopPropagation();
+    });
+    const heading = err.kind === "build" ? "Build Error" : err.kind === "unhandled" ? "Unhandled Runtime Error" : "Unhandled Runtime Error";
+    const loc = err.location ? `${err.location.file}${err.location.line !== undefined ? `:${err.location.line}` : ""}${err.location.column !== undefined ? `:${err.location.column}` : ""}` : null;
+    const frame = err.frame ? err.frame.replace(/\n+$/, "").split("\n") : [];
+    const componentStack = err.componentStack
+        ? err.componentStack
+            .split("\n")
+            .map((l) => l.trim())
+            .filter(Boolean)
+        : [];
+    return (_jsx(Box, { position: "absolute", top: 0, left: 0, right: 0, bottom: 0, zIndex: 60, backdropDim: 0.75, alignItems: "center", justifyContent: "center", flexDirection: "column", wireframeLabel: "redbox", children: _jsxs(Box, { flexDirection: "column", width: "94%", height: "92%", border: "rounded", borderColor: theme.danger, bg: theme.elevated, fg: theme.fg, paddingX: 2, paddingY: 1, overflow: "hidden", title: ` ✕ ${heading} `, titleColor: theme.danger, bottomTitle: " esc dismiss \u00B7 \u2190/\u2192 errors \u00B7 \u2191/\u2193 scroll ", bottomTitleColor: theme.subtle, bottomTitleAlign: "right", children: [_jsxs(Box, { height: 1, flexDirection: "row", flexShrink: 0, children: [_jsx(Badge, { variant: "danger", children: `${i + 1} of ${errors.length} ${errors.length === 1 ? "error" : "errors"}` }), _jsx(Box, { flexGrow: 1 }), _jsx(Text, { color: theme.subtle, wrap: "nowrap", children: `${BRAND_MARK} Text.js ${VERSION} (${ENGINE_NAME})` })] }), _jsx(Box, { height: 1, flexShrink: 0 }), _jsx(Text, { color: theme.danger, bold: true, flexShrink: 0, children: err.kind === "build" ? err.message : `${err.name}: ${err.message}` }), loc ? (_jsx(Text, { color: theme.accent, underline: true, wrap: "truncate-start", flexShrink: 0, children: loc })) : null, err.plugin ? (_jsx(Text, { color: theme.subtle, flexShrink: 0, children: `plugin: ${err.plugin}` })) : null, frame.length > 0 ? (_jsx(Box, { flexDirection: "column", flexShrink: 0, marginTop: 1, bg: theme.codeBg, paddingX: 1, maxHeight: 10, overflow: "hidden", children: frame.map((line, n) => (_jsx(Text, { wrap: "nowrap", color: line.trimStart().startsWith(">") ? theme.danger : /^\s*\|\s*\^/.test(line) ? theme.danger : theme.muted, bold: line.trimStart().startsWith(">"), children: line || " " }, n))) })) : null, _jsx(Box, { height: 1, flexShrink: 0, marginTop: 1, children: _jsx(Divider, { title: "Call Stack" }) }), _jsxs(ScrollBox, { flexGrow: 1, focusable: true, autoFocus: true, children: [err.stack.length === 0 && componentStack.length === 0 ? (_jsx(Text, { color: theme.subtle, italic: true, children: "No stack trace available." })) : null, err.stack.map((line, n) => (_jsx(Text, { color: theme.muted, wrap: "truncate-middle", children: line }, `s${n}`))), componentStack.length > 0 ? (_jsx(Text, { color: theme.subtle, bold: true, children: "Component Stack" })) : null, componentStack.map((line, n) => (_jsx(Text, { color: theme.subtle, wrap: "truncate-middle", children: line }, `c${n}`)))] })] }) }));
+}
+/**
+ * Show Vite build / syntax errors in the in-console Redbox and clear them
+ * (recovering crashed routes) once an HMR update applies cleanly.
+ */
+export function connectViteHmr(hot, store = devErrors) {
+    const onError = (payload) => {
+        if (payload?.err)
+            store.reportBuild(payload.err);
+    };
+    const onBeforeUpdate = () => store.clear("build");
+    const onAfterUpdate = () => store.clear();
+    hot.on("vite:error", onError);
+    hot.on("vite:beforeUpdate", onBeforeUpdate);
+    hot.on("vite:afterUpdate", onAfterUpdate);
+    return () => {
+        hot.off?.("vite:error", onError);
+        hot.off?.("vite:beforeUpdate", onBeforeUpdate);
+        hot.off?.("vite:afterUpdate", onAfterUpdate);
+    };
+}
+/** Report uncaught exceptions and unhandled rejections to the Redbox. */
+export function installGlobalErrorHandlers(target = typeof window !== "undefined" ? window : undefined, store = devErrors) {
+    if (!target)
+        return () => undefined;
+    const onError = (e) => {
+        const error = e.error ?? e.message;
+        if (error !== undefined && !isNavigationError(error))
+            store.reportRuntime(error, null, "unhandled");
+    };
+    const onRejection = (e) => {
+        if (!isNavigationError(e.reason))
+            store.reportRuntime(e.reason, null, "unhandled");
+    };
+    target.addEventListener("error", onError);
+    target.addEventListener("unhandledrejection", onRejection);
+    return () => {
+        target.removeEventListener("error", onError);
+        target.removeEventListener("unhandledrejection", onRejection);
+    };
+}
+//# sourceMappingURL=devtools.js.map

package/dist/devtools.js.map

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

package/dist/frame-mirror.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Browser half of the dev frame mirror: while an editor is watching
+ * (`textjs:mirror { active: true }`), encode each emitted frame as a row delta
+ * and send it over the Vite HMR socket; apply forwarded input. Idle otherwise.
+ */
+import type { ConsoleRoot } from "@textjs/react";
+import { type InputMessage } from "./frame-protocol.js";
+import type { RouterHistory } from "./history.js";
+export interface MirrorHotContext {
+    on(event: string, callback: (payload: any) => void): void;
+    off?(event: string, callback: (payload: any) => void): void;
+    send(event: string, data?: unknown): void;
+    /** `import.meta.hot.dispose`: the mirror disconnects when the module is replaced. */
+    dispose?(callback: (data: any) => void): void;
+}
+/** Apply a forwarded input message to a root. */
+export declare function applyInputMessage(root: ConsoleRoot, msg: InputMessage, history?: RouterHistory): void;
+export declare function connectFrameMirror(root: ConsoleRoot, hot: MirrorHotContext, history?: RouterHistory): () => void;
+//# sourceMappingURL=frame-mirror.d.ts.map

package/dist/frame-mirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-mirror.d.ts","sourceRoot":"","sources":["../src/frame-mirror.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAmI,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACtL,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;IAC1D,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;IAC5D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1C,qFAAqF;IACrF,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,GAAG,IAAI,CAAC;CAC/C;AAMD,iDAAiD;AACjD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAerG;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM,IAAI,CAuGhH"}