tempest-react-sdk 0.53.0 → 0.54.0

package/dist/ws/use-web-socket.js

@@ -2,54 +2,49 @@ import { useLatestRef as e } from "../hooks/use-latest-ref.js";
 import { createWebSocket as t } from "./create-web-socket.js";
 import { useCallback as n, useEffect as r, useRef as i, useState as a } from "react";
 //#region src/ws/use-web-socket.ts
-function o(e) {
-	try {
-		return JSON.parse(e);
-	} catch {
-		return e;
-	}
-}
-function s(s, c = {}) {
-	let { enabled: l = !0, protocols: u, maxRetries: d, initialBackoff: f, maxBackoff: p, jitter: m, handshakeTimeout: h, silenceTimeout: g, waitForOnline: _, pingInterval: v, respondToPing: y, queueWhileClosed: b, maxQueuedMessages: x } = c, [S, C] = a("idle"), [w, T] = a(null), E = i(null), D = e(c), O = Array.isArray(u) ? u.join(",") : u ?? "";
+function o(o, s = {}) {
+	let { enabled: c = !0, protocols: l, maxRetries: u, initialBackoff: d, maxBackoff: f, jitter: p, handshakeTimeout: m, silenceTimeout: h, waitForOnline: g, pingInterval: _, respondToPing: v, queueWhileClosed: y, maxQueuedMessages: b } = s, [x, S] = a("idle"), [C, w] = a(null), T = i(null), E = e(s), D = Array.isArray(l) ? l.join(",") : l ?? "";
 	return r(() => {
-		if (!l || !s) {
-			C("idle");
+		if (!c || !o) {
+			S("idle");
 			return;
 		}
-		let e = t(s, {
-			protocols: D.current.protocols,
-			maxRetries: d,
-			initialBackoff: f,
-			maxBackoff: p,
-			jitter: m,
-			handshakeTimeout: h,
-			silenceTimeout: g,
-			waitForOnline: _,
-			pingInterval: v,
-			pingPayload: D.current.pingPayload,
-			respondToPing: y,
-			pongPayload: D.current.pongPayload,
-			queueWhileClosed: b,
-			maxQueuedMessages: x,
-			parser: (e) => (D.current.parser ?? o)(e),
-			onStatusChange: C,
-			onOpen: (e) => D.current.onOpen?.(e),
-			onClose: (e) => D.current.onClose?.(e),
-			onError: (e) => D.current.onError?.(e),
-			onReconnecting: (e, t) => D.current.onReconnecting?.(e, t),
-			onReconnected: () => D.current.onReconnected?.(),
-			onLost: (e) => D.current.onLost?.(e),
+		let e = E.current.parser !== void 0, n = E.current.onParseError !== void 0, r = t(o, {
+			protocols: E.current.protocols,
+			maxRetries: u,
+			initialBackoff: d,
+			maxBackoff: f,
+			jitter: p,
+			handshakeTimeout: m,
+			silenceTimeout: h,
+			waitForOnline: g,
+			pingInterval: _,
+			pingPayload: E.current.pingPayload,
+			respondToPing: v,
+			pongPayload: E.current.pongPayload,
+			queueWhileClosed: y,
+			maxQueuedMessages: b,
+			parser: e ? (e) => E.current.parser?.(e) : void 0,
+			onParseError: n ? (e, t) => E.current.onParseError?.(e, t) : void 0,
+			onStatusChange: S,
+			onOpen: (e) => E.current.onOpen?.(e),
+			onClose: (e) => E.current.onClose?.(e),
+			onError: (e) => E.current.onError?.(e),
+			onReconnecting: (e, t) => E.current.onReconnecting?.(e, t),
+			onReconnected: () => E.current.onReconnected?.(),
+			onLost: (e) => E.current.onLost?.(e),
 			onMessage: (e) => {
-				T(e), D.current.onMessage?.(e);
+				w(e), E.current.onMessage?.(e);
 			}
 		});
-		return E.current = e, () => {
-			e.close(), E.current = null;
+		return T.current = r, () => {
+			r.close(), T.current = null;
 		};
 	}, [
-		s,
-		l,
-		O,
+		o,
+		c,
+		D,
+		u,
 		d,
 		f,
 		p,
@@ -60,21 +55,20 @@ function s(s, c = {}) {
 		v,
 		y,
 		b,
-		x,
-		D
+		E
 	]), {
-		status: S,
-		lastMessage: w,
-		send: n((e) => E.current?.send(e) ?? !1, []),
+		status: x,
+		lastMessage: C,
+		send: n((e) => T.current?.send(e) ?? !1, []),
 		reconnect: n(() => {
-			E.current?.reconnect();
+			T.current?.reconnect();
 		}, []),
 		setSilenceTimeout: n((e) => {
-			E.current?.setSilenceTimeout(e);
+			T.current?.setSilenceTimeout(e);
 		}, [])
 	};
 }
 //#endregion
-export { s as useWebSocket };
+export { o as useWebSocket };
 
 //# sourceMappingURL=use-web-socket.js.map

package/dist/ws/use-web-socket.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-web-socket.js","names":[],"sources":["../../src/ws/use-web-socket.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"@/hooks/use-latest-ref\";\nimport {\n    createWebSocket,\n    type CreateWebSocketOptions,\n    type WebSocketController,\n    type WebSocketMessage,\n    type WebSocketStatus,\n} from \"./create-web-socket\";\n\nexport interface UseWebSocketOptions<T> extends Omit<CreateWebSocketOptions<T>, \"onStatusChange\"> {\n    /** When false, the socket is not opened. Default: true. */\n    enabled?: boolean;\n}\n\nexport interface UseWebSocketResult<T> {\n    status: WebSocketStatus;\n    /**\n     * Last decoded frame received.\n     *\n     * A snapshot, not a stream: two frames arriving in the same tick collapse\n     * into a single render and only the later one is ever visible. One server\n     * action often emits several frames in a row, so anything that must see\n     * every message has to use `onMessage`, which fires once per frame. Read\n     * `lastMessage` for \"what is the current state\" rendering only.\n     */\n    lastMessage: WebSocketMessage<T> | null;\n    /** Send a payload through the active connection. Returns false when not open. */\n    send: (payload: string | Blob | BufferSource) => boolean;\n    /** Force a reconnect, resetting the retry counter. */\n    reconnect: () => void;\n    /**\n     * Change the silence watchdog at runtime, in ms. `0` disables it.\n     *\n     * For a server that announces its own heartbeat interval in the first frame,\n     * so the tolerated silence is not hard-coded on both ends.\n     */\n    setSilenceTimeout: (ms: number) => void;\n}\n\n/** Mirror of `createWebSocket`'s default parser: JSON, raw string on failure. */\nfunction defaultParse<T>(raw: string): T {\n    try {\n        return JSON.parse(raw) as T;\n    } catch {\n        return raw as unknown as T;\n    }\n}\n\n/**\n * React hook around {@link createWebSocket}. Manages the connection lifecycle\n * for the host component and tears it down on unmount.\n *\n * Every callback is read through a ref, so `onOpen` / `onMessage` / `onClose` /\n * `onError` / `onReconnecting` / `onReconnected` / `onLost` always run the\n * latest closure — an inline arrow function is fine and never reopens the\n * socket. Connection-shaping options (`protocols`, `maxRetries`,\n * `initialBackoff`, `maxBackoff`, `jitter`, `handshakeTimeout`,\n * `silenceTimeout`, `waitForOnline`, `pingInterval`, `queueWhileClosed`) are\n * baked into the connection, so changing one reopens it with the new value\n * rather than being silently ignored.\n *\n * @param url - Full ws:// or wss:// URL.\n * @param options - Connection configuration and callbacks.\n * @returns Status, last frame, and the `send` / `reconnect` controls.\n */\nexport function useWebSocket<T = unknown>(\n    url: string,\n    options: UseWebSocketOptions<T> = {},\n): UseWebSocketResult<T> {\n    const {\n        enabled = true,\n        protocols,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        jitter,\n        handshakeTimeout,\n        silenceTimeout,\n        waitForOnline,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n    } = options;\n    const [status, setStatus] = useState<WebSocketStatus>(\"idle\");\n    const [lastMessage, setLastMessage] = useState<WebSocketMessage<T> | null>(null);\n    const controllerRef = useRef<WebSocketController | null>(null);\n\n    const optionsRef = useLatestRef(options);\n\n    const protocolsKey = Array.isArray(protocols) ? protocols.join(\",\") : (protocols ?? \"\");\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        const controller = createWebSocket<T>(url, {\n            protocols: optionsRef.current.protocols,\n            maxRetries,\n            initialBackoff,\n            maxBackoff,\n            jitter,\n            handshakeTimeout,\n            silenceTimeout,\n            waitForOnline,\n            pingInterval,\n            pingPayload: optionsRef.current.pingPayload,\n            respondToPing,\n            pongPayload: optionsRef.current.pongPayload,\n            queueWhileClosed,\n            maxQueuedMessages,\n            parser: (raw) => (optionsRef.current.parser ?? defaultParse<T>)(raw),\n            onStatusChange: setStatus,\n            onOpen: (event) => optionsRef.current.onOpen?.(event),\n            onClose: (event) => optionsRef.current.onClose?.(event),\n            onError: (event) => optionsRef.current.onError?.(event),\n            onReconnecting: (attempt, total) => optionsRef.current.onReconnecting?.(attempt, total),\n            onReconnected: () => optionsRef.current.onReconnected?.(),\n            onLost: (reason) => optionsRef.current.onLost?.(reason),\n            onMessage: (message) => {\n                setLastMessage(message);\n                optionsRef.current.onMessage?.(message);\n            },\n        });\n        controllerRef.current = controller;\n\n        return () => {\n            controller.close();\n            controllerRef.current = null;\n        };\n    }, [\n        url,\n        enabled,\n        protocolsKey,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        jitter,\n        handshakeTimeout,\n        silenceTimeout,\n        waitForOnline,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n        optionsRef,\n    ]);\n\n    const send = useCallback((payload: string | Blob | BufferSource): boolean => {\n        return controllerRef.current?.send(payload) ?? false;\n    }, []);\n\n    const reconnect = useCallback((): void => {\n        controllerRef.current?.reconnect();\n    }, []);\n\n    const setSilenceTimeout = useCallback((ms: number): void => {\n        controllerRef.current?.setSilenceTimeout(ms);\n    }, []);\n\n    return { status, lastMessage, send, reconnect, setSilenceTimeout };\n}\n"],"mappings":";;;;AAyCA,SAAS,EAAgB,GAAgB;CACrC,IAAI;EACA,OAAO,KAAK,MAAM,CAAG;CACzB,QAAQ;EACJ,OAAO;CACX;AACJ;AAmBA,SAAgB,EACZ,GACA,IAAkC,CAAC,GACd;CACrB,IAAM,EACF,aAAU,IACV,cACA,eACA,mBACA,eACA,WACA,qBACA,mBACA,kBACA,iBACA,kBACA,qBACA,yBACA,GACE,CAAC,GAAQ,KAAa,EAA0B,MAAM,GACtD,CAAC,GAAa,KAAkB,EAAqC,IAAI,GACzE,IAAgB,EAAmC,IAAI,GAEvD,IAAa,EAAa,CAAO,GAEjC,IAAe,MAAM,QAAQ,CAAS,IAAI,EAAU,KAAK,GAAG,IAAK,KAAa;CAwEpF,OAtEA,QAAgB;EACZ,IAAI,CAAC,KAAW,CAAC,GAAK;GAClB,EAAU,MAAM;GAChB;EACJ;EAEA,IAAM,IAAa,EAAmB,GAAK;GACvC,WAAW,EAAW,QAAQ;GAC9B;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA,aAAa,EAAW,QAAQ;GAChC;GACA,aAAa,EAAW,QAAQ;GAChC;GACA;GACA,SAAS,OAAS,EAAW,QAAQ,UAAU,EAAA,CAAiB,CAAG;GACnE,gBAAgB;GAChB,SAAS,MAAU,EAAW,QAAQ,SAAS,CAAK;GACpD,UAAU,MAAU,EAAW,QAAQ,UAAU,CAAK;GACtD,UAAU,MAAU,EAAW,QAAQ,UAAU,CAAK;GACtD,iBAAiB,GAAS,MAAU,EAAW,QAAQ,iBAAiB,GAAS,CAAK;GACtF,qBAAqB,EAAW,QAAQ,gBAAgB;GACxD,SAAS,MAAW,EAAW,QAAQ,SAAS,CAAM;GACtD,YAAY,MAAY;IAEpB,AADA,EAAe,CAAO,GACtB,EAAW,QAAQ,YAAY,CAAO;GAC1C;EACJ,CAAC;EAGD,OAFA,EAAc,UAAU,SAEX;GAET,AADA,EAAW,MAAM,GACjB,EAAc,UAAU;EAC5B;CACJ,GAAG;EACC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACJ,CAAC,GAcM;EAAE;EAAQ;EAAa,MAZjB,GAAa,MACf,EAAc,SAAS,KAAK,CAAO,KAAK,IAChD,CAAC,CAU0B;EAAM,WARlB,QAAwB;GACtC,EAAc,SAAS,UAAU;EACrC,GAAG,CAAC,CAMgC;EAAW,mBAJrB,GAAa,MAAqB;GACxD,EAAc,SAAS,kBAAkB,CAAE;EAC/C,GAAG,CAAC,CAE2C;CAAkB;AACrE"}
+{"version":3,"file":"use-web-socket.js","names":[],"sources":["../../src/ws/use-web-socket.ts"],"sourcesContent":["import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useLatestRef } from \"@/hooks/use-latest-ref\";\nimport {\n    createWebSocket,\n    type CreateWebSocketOptions,\n    type WebSocketController,\n    type WebSocketMessage,\n    type WebSocketStatus,\n} from \"./create-web-socket\";\n\nexport interface UseWebSocketOptions<T> extends Omit<CreateWebSocketOptions<T>, \"onStatusChange\"> {\n    /** When false, the socket is not opened. Default: true. */\n    enabled?: boolean;\n}\n\nexport interface UseWebSocketResult<T> {\n    status: WebSocketStatus;\n    /**\n     * Last decoded frame received.\n     *\n     * A snapshot, not a stream: two frames arriving in the same tick collapse\n     * into a single render and only the later one is ever visible. One server\n     * action often emits several frames in a row, so anything that must see\n     * every message has to use `onMessage`, which fires once per frame. Read\n     * `lastMessage` for \"what is the current state\" rendering only.\n     */\n    lastMessage: WebSocketMessage<T> | null;\n    /** Send a payload through the active connection. Returns false when not open. */\n    send: (payload: string | Blob | BufferSource) => boolean;\n    /** Force a reconnect, resetting the retry counter. */\n    reconnect: () => void;\n    /**\n     * Change the silence watchdog at runtime, in ms. `0` disables it.\n     *\n     * For a server that announces its own heartbeat interval in the first frame,\n     * so the tolerated silence is not hard-coded on both ends.\n     */\n    setSilenceTimeout: (ms: number) => void;\n}\n\n/**\n * React hook around {@link createWebSocket}. Manages the connection lifecycle\n * for the host component and tears it down on unmount.\n *\n * Every callback is read through a ref, so `onOpen` / `onMessage` / `onClose` /\n * `onError` / `onReconnecting` / `onReconnected` / `onLost` always run the\n * latest closure — an inline arrow function is fine and never reopens the\n * socket. Connection-shaping options (`protocols`, `maxRetries`,\n * `initialBackoff`, `maxBackoff`, `jitter`, `handshakeTimeout`,\n * `silenceTimeout`, `waitForOnline`, `pingInterval`, `queueWhileClosed`) are\n * baked into the connection, so changing one reopens it with the new value\n * rather than being silently ignored.\n *\n * @param url - Full ws:// or wss:// URL.\n * @param options - Connection configuration and callbacks.\n * @returns Status, last frame, and the `send` / `reconnect` controls.\n */\nexport function useWebSocket<T = unknown>(\n    url: string,\n    options: UseWebSocketOptions<T> = {},\n): UseWebSocketResult<T> {\n    const {\n        enabled = true,\n        protocols,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        jitter,\n        handshakeTimeout,\n        silenceTimeout,\n        waitForOnline,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n    } = options;\n    const [status, setStatus] = useState<WebSocketStatus>(\"idle\");\n    const [lastMessage, setLastMessage] = useState<WebSocketMessage<T> | null>(null);\n    const controllerRef = useRef<WebSocketController | null>(null);\n\n    const optionsRef = useLatestRef(options);\n\n    const protocolsKey = Array.isArray(protocols) ? protocols.join(\",\") : (protocols ?? \"\");\n\n    useEffect(() => {\n        if (!enabled || !url) {\n            setStatus(\"idle\");\n            return;\n        }\n\n        /*\n         * Presence is read once, when the socket opens, and decides whether the\n         * forwarder is passed at all. A forwarder is always truthy, so wrapping\n         * an absent `parser` — or an absent `onParseError` — would tell\n         * `decodeFrame` the caller had supplied one and silently pick the wrong\n         * branch.\n         */\n        const hasParser = optionsRef.current.parser !== undefined;\n        const hasParseError = optionsRef.current.onParseError !== undefined;\n\n        const controller = createWebSocket<T>(url, {\n            protocols: optionsRef.current.protocols,\n            maxRetries,\n            initialBackoff,\n            maxBackoff,\n            jitter,\n            handshakeTimeout,\n            silenceTimeout,\n            waitForOnline,\n            pingInterval,\n            pingPayload: optionsRef.current.pingPayload,\n            respondToPing,\n            pongPayload: optionsRef.current.pongPayload,\n            queueWhileClosed,\n            maxQueuedMessages,\n            parser: hasParser ? (raw) => optionsRef.current.parser?.(raw) as T : undefined,\n            onParseError: hasParseError\n                ? (error, raw) => optionsRef.current.onParseError?.(error, raw)\n                : undefined,\n            onStatusChange: setStatus,\n            onOpen: (event) => optionsRef.current.onOpen?.(event),\n            onClose: (event) => optionsRef.current.onClose?.(event),\n            onError: (event) => optionsRef.current.onError?.(event),\n            onReconnecting: (attempt, total) => optionsRef.current.onReconnecting?.(attempt, total),\n            onReconnected: () => optionsRef.current.onReconnected?.(),\n            onLost: (reason) => optionsRef.current.onLost?.(reason),\n            onMessage: (message) => {\n                setLastMessage(message);\n                optionsRef.current.onMessage?.(message);\n            },\n        });\n        controllerRef.current = controller;\n\n        return () => {\n            controller.close();\n            controllerRef.current = null;\n        };\n    }, [\n        url,\n        enabled,\n        protocolsKey,\n        maxRetries,\n        initialBackoff,\n        maxBackoff,\n        jitter,\n        handshakeTimeout,\n        silenceTimeout,\n        waitForOnline,\n        pingInterval,\n        respondToPing,\n        queueWhileClosed,\n        maxQueuedMessages,\n        optionsRef,\n    ]);\n\n    const send = useCallback((payload: string | Blob | BufferSource): boolean => {\n        return controllerRef.current?.send(payload) ?? false;\n    }, []);\n\n    const reconnect = useCallback((): void => {\n        controllerRef.current?.reconnect();\n    }, []);\n\n    const setSilenceTimeout = useCallback((ms: number): void => {\n        controllerRef.current?.setSilenceTimeout(ms);\n    }, []);\n\n    return { status, lastMessage, send, reconnect, setSilenceTimeout };\n}\n"],"mappings":";;;;AAyDA,SAAgB,EACZ,GACA,IAAkC,CAAC,GACd;CACrB,IAAM,EACF,aAAU,IACV,cACA,eACA,mBACA,eACA,WACA,qBACA,mBACA,kBACA,iBACA,kBACA,qBACA,yBACA,GACE,CAAC,GAAQ,KAAa,EAA0B,MAAM,GACtD,CAAC,GAAa,KAAkB,EAAqC,IAAI,GACzE,IAAgB,EAAmC,IAAI,GAEvD,IAAa,EAAa,CAAO,GAEjC,IAAe,MAAM,QAAQ,CAAS,IAAI,EAAU,KAAK,GAAG,IAAK,KAAa;CAqFpF,OAnFA,QAAgB;EACZ,IAAI,CAAC,KAAW,CAAC,GAAK;GAClB,EAAU,MAAM;GAChB;EACJ;EASA,IAAM,IAAY,EAAW,QAAQ,WAAW,KAAA,GAC1C,IAAgB,EAAW,QAAQ,iBAAiB,KAAA,GAEpD,IAAa,EAAmB,GAAK;GACvC,WAAW,EAAW,QAAQ;GAC9B;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA,aAAa,EAAW,QAAQ;GAChC;GACA,aAAa,EAAW,QAAQ;GAChC;GACA;GACA,QAAQ,KAAa,MAAQ,EAAW,QAAQ,SAAS,CAAG,IAAS,KAAA;GACrE,cAAc,KACP,GAAO,MAAQ,EAAW,QAAQ,eAAe,GAAO,CAAG,IAC5D,KAAA;GACN,gBAAgB;GAChB,SAAS,MAAU,EAAW,QAAQ,SAAS,CAAK;GACpD,UAAU,MAAU,EAAW,QAAQ,UAAU,CAAK;GACtD,UAAU,MAAU,EAAW,QAAQ,UAAU,CAAK;GACtD,iBAAiB,GAAS,MAAU,EAAW,QAAQ,iBAAiB,GAAS,CAAK;GACtF,qBAAqB,EAAW,QAAQ,gBAAgB;GACxD,SAAS,MAAW,EAAW,QAAQ,SAAS,CAAM;GACtD,YAAY,MAAY;IAEpB,AADA,EAAe,CAAO,GACtB,EAAW,QAAQ,YAAY,CAAO;GAC1C;EACJ,CAAC;EAGD,OAFA,EAAc,UAAU,SAEX;GAET,AADA,EAAW,MAAM,GACjB,EAAc,UAAU;EAC5B;CACJ,GAAG;EACC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACJ,CAAC,GAcM;EAAE;EAAQ;EAAa,MAZjB,GAAa,MACf,EAAc,SAAS,KAAK,CAAO,KAAK,IAChD,CAAC,CAU0B;EAAM,WARlB,QAAwB;GACtC,EAAc,SAAS,UAAU;EACrC,GAAG,CAAC,CAMgC;EAAW,mBAJrB,GAAa,MAAqB;GACxD,EAAc,SAAS,kBAAkB,CAAE;EAC/C,GAAG,CAAC,CAE2C;CAAkB;AACrE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tempest-react-sdk",
-  "version": "0.53.0",
+  "version": "0.54.0",
   "description": "SDK público da Tempest com componentes, hooks e integrações para projetos React.",
   "type": "module",
   "license": "MIT",
@@ -101,12 +101,13 @@
       "require": "./dist/icons-virtual.cjs"
     },
     "./styles.css": "./dist/styles.css",
+    "./styles/*.css": "./dist/styles/*.css",
     "./package.json": "./package.json",
     "./utilities.css": "./dist/utilities.css"
   },
   "scripts": {
     "dev": "vite build --watch",
-    "build": "tsc -b tsconfig.build.json && node --max-old-space-size=6144 ./node_modules/vite/bin/vite.js build && node scripts/copy-css-assets.mjs",
+    "build": "tsc -b tsconfig.build.json && node --max-old-space-size=6144 ./node_modules/vite/bin/vite.js build && node scripts/copy-css-assets.mjs && node scripts/split-css.mjs",
     "postbuild": "node scripts/check-dist-guards.mjs",
     "typecheck": "tsc -b tsconfig.json --noEmit",
     "lint": "eslint .",
@@ -118,6 +119,8 @@
     "clean": "rm -rf dist coverage",
     "size": "size-limit",
     "docs:llms": "node scripts/gen-llms.mjs",
+    "docs:shots": "node scripts/docs-shots.mjs",
+    "docs:gallery": "node scripts/docs-gallery.mjs",
     "gen:geodata": "node scripts/gen-br-geodata.mjs",
     "gen:icons": "node scripts/gen-icons.mjs",
     "vendor:vision": "node scripts/vendor-vision.mjs",