@hozu/devtools 0.10.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 olevatorr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,18 @@
+<img src="https://raw.githubusercontent.com/olevatorr/Hozu/main/docs/assets/logo.png" alt="Hozu logo" width="72">
+
+# @hozu/devtools
+
+Hozu DevTools: select something on the screen and get a request that names its file, line and the Hozu way
+to change it. `hozu dev` shows it; production builds never contain it.
+
+Part of [Hozu](https://github.com/olevatorr/Hozu#readme), an AI-first web framework. Most apps start from
+`npm create hozu@latest`, which installs the right packages and sets up Claude Code or `AGENTS.md` agents.
+
+```sh
+npm install @hozu/devtools
+```
+
+Requires Node 22.18 or newer. Documentation: the [README](https://github.com/olevatorr/Hozu#readme) and the
+agent skill that `create-hozu` writes into each app.
+
+MIT © olevatorr

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { type HozuRequest, joinRequests, openRequestsLine, type RequestItem, requestMarkdown, type Scope, scopesFor, titleOf, } from './prompt.ts';
+export { deleteRequest, finishRequest, listRequests, readRequest, type SavedRequest, saveRequest, } from './requests.ts';
+export { currentUtility, parseTheme, type StyleProp, type Theme, utilityFor } from './theme.ts';
+export declare const devtoolsDir: string;
+export declare const devtoolsEntry = "/_hozu/devtools/overlay/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,WAAW,EAChB,YAAY,EACZ,gBAAgB,EAChB,KAAK,WAAW,EAChB,eAAe,EACf,KAAK,KAAK,EACV,SAAS,EACT,OAAO,GACR,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,EACX,KAAK,YAAY,EACjB,WAAW,GACZ,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE/F,eAAO,MAAM,WAAW,QAAgD,CAAA;AACxE,eAAO,MAAM,aAAa,qCAAqC,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+import { fileURLToPath } from 'node:url';
+export { joinRequests, openRequestsLine, requestMarkdown, scopesFor, titleOf, } from './prompt.js';
+export { deleteRequest, finishRequest, listRequests, readRequest, saveRequest, } from './requests.js';
+export { currentUtility, parseTheme, utilityFor } from './theme.js';
+export const devtoolsDir = fileURLToPath(new URL('./', import.meta.url));
+export const devtoolsEntry = '/_hozu/devtools/overlay/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EAEL,YAAY,EACZ,gBAAgB,EAEhB,eAAe,EAEf,SAAS,EACT,OAAO,GACR,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,EAEX,WAAW,GACZ,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,cAAc,EAAE,UAAU,EAA8B,UAAU,EAAE,MAAM,YAAY,CAAA;AAE/F,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AACxE,MAAM,CAAC,MAAM,aAAa,GAAG,kCAAkC,CAAA"}

package/dist/overlay/api.d.ts

@@ -0,0 +1,30 @@
+import type { DevNode, DevPageTree, DevPreview } from '@hozu/core/ir';
+import type { Theme } from '../theme.ts';
+export interface SavedSummary {
+    number: string;
+    file: string;
+    title: string;
+    status: 'open' | 'done';
+    locations: string[];
+}
+export declare function node(id: string): Promise<DevNode | null>;
+export declare function page(path: string): Promise<DevNode | null>;
+export declare function save(markdown: string): Promise<{
+    number: string;
+    file: string;
+}>;
+export declare function saved(): Promise<SavedSummary[]>;
+export interface SavedRequest extends SavedSummary {
+    markdown: string;
+    result: string | null;
+}
+export declare const one: (number: string) => Promise<SavedRequest>;
+export declare const remove: (number: string) => Promise<{
+    deleted: string;
+}>;
+export declare const finish: (number: string, result: string) => Promise<SavedSummary>;
+export declare const theme: () => Promise<Theme | null>;
+export declare const tree: (path: string) => Promise<DevPageTree | null>;
+export declare function held(): DevPreview | null;
+export declare function hold(preview: DevPreview | null, reload?: () => void): void;
+//# sourceMappingURL=api.d.ts.map

package/dist/overlay/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/overlay/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AACrE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAID,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CASxD;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAUhE;AAED,wBAAsB,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAQtF;AAED,wBAAsB,KAAK,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAOrD;AAED,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAeD,eAAO,MAAM,GAAG,WAAY,MAAM,0BAA+D,CAAA;AACjG,eAAO,MAAM,MAAM,WAAY,MAAM;aAAqB,MAAM;EAA8C,CAAA;AAC9G,eAAO,MAAM,MAAM,WAAY,MAAM,UAAU,MAAM,0BACyB,CAAA;AAG9E,eAAO,MAAM,KAAK,6BAGK,CAAA;AAEvB,eAAO,MAAM,IAAI,SAAU,MAAM,KAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAGxC,CAAA;AAItB,wBAAgB,IAAI,IAAI,UAAU,GAAG,IAAI,CAQxC;AAED,wBAAgB,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,EAAE,MAAM,GAAE,MAAM,IAA8B,QAM5F"}

package/dist/overlay/api.js

@@ -0,0 +1,83 @@
+const cache = new Map();
+export function node(id) {
+    let found = cache.get(id);
+    if (!found) {
+        found = fetch(`/_hozu/dev/node?id=${encodeURIComponent(id)}`)
+            .then((r) => (r.ok ? r.json() : null))
+            .catch(() => null);
+        cache.set(id, found);
+    }
+    return found;
+}
+export async function page(path) {
+    try {
+        const response = await fetch(`/_hozu/dev/page?path=${encodeURIComponent(path)}`);
+        if (!response.ok)
+            return null;
+        const found = (await response.json());
+        cache.set(found.id, Promise.resolve(found));
+        return found;
+    }
+    catch {
+        return null;
+    }
+}
+export async function save(markdown) {
+    const response = await fetch('/_hozu/dev/requests', {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ markdown }),
+    });
+    if (!response.ok)
+        throw new Error(await response.text());
+    return response.json();
+}
+export async function saved() {
+    try {
+        const response = await fetch('/_hozu/dev/requests');
+        return response.ok ? response.json() : [];
+    }
+    catch {
+        return [];
+    }
+}
+const send = async (path, method, body) => {
+    const response = await fetch(path, {
+        method,
+        headers: { 'content-type': 'application/json' },
+        ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+    });
+    if (!response.ok)
+        throw new Error((await response.json().catch(() => ({}))).error ?? response.statusText);
+    return response.json();
+};
+export const one = (number) => send(`/_hozu/dev/requests/${number}`, 'GET');
+export const remove = (number) => send(`/_hozu/dev/requests/${number}`, 'DELETE');
+export const finish = (number, result) => send(`/_hozu/dev/requests/${number}/done`, 'POST', { result });
+let themed = null;
+export const theme = () => (themed ??= fetch('/_hozu/dev/theme')
+    .then((r) => (r.ok ? r.json() : null))
+    .catch(() => null));
+export const tree = (path) => fetch(`/_hozu/dev/tree?path=${encodeURIComponent(path)}`)
+    .then((r) => (r.ok ? r.json() : null))
+    .catch(() => null);
+const COOKIE = 'hozu-dev-state';
+export function held() {
+    const raw = new RegExp(`(?:^|;\\s*)${COOKIE}=([^;]+)`).exec(document.cookie)?.[1];
+    if (!raw)
+        return null;
+    try {
+        return JSON.parse(decodeURIComponent(raw));
+    }
+    catch {
+        return null;
+    }
+}
+export function hold(preview, reload = () => location.reload()) {
+    // biome-ignore lint/suspicious/noDocumentCookie: the server must read it on the next load; cookieStore is not in every browser
+    document.cookie = preview
+        ? `${COOKIE}=${encodeURIComponent(JSON.stringify(preview))}; path=/; SameSite=Strict`
+        : `${COOKIE}=; path=/; max-age=0; SameSite=Strict`;
+    reload();
+}
+//# sourceMappingURL=api.js.map

package/dist/overlay/api.js.map

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

package/dist/overlay/app.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=app.d.ts.map

package/dist/overlay/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/overlay/app.ts"],"names":[],"mappings":""}