@devframes/hub 0.5.3 → 0.6.0-beta.1

package/dist/settings-B9YjSEcl.d.mts

@@ -0,0 +1,348 @@
+import { ConnectionMeta, EventEmitter } from "devframe/types";
+
+//#region src/types/json-render.d.ts
+interface JsonRenderElement {
+  type: string;
+  props?: Record<string, unknown>;
+  children?: string[];
+  /** json-render event bindings (e.g. `{ press: { action: "my:action" } }`) */
+  on?: Record<string, unknown>;
+  /** json-render visibility condition */
+  visible?: unknown;
+  /** json-render repeat binding */
+  repeat?: unknown;
+  /** Allow additional json-render element fields */
+  [key: string]: unknown;
+}
+interface JsonRenderSpec {
+  root: string;
+  elements: Record<string, JsonRenderElement>;
+  /** Initial client-side state model for $state/$bindState expressions */
+  state?: Record<string, unknown>;
+}
+interface JsonRenderer {
+  /** Replace the entire spec */
+  updateSpec: (spec: JsonRenderSpec) => void | Promise<void>;
+  /** Update json-render state values (shallow merge into spec.state) */
+  updateState: (state: Record<string, unknown>) => void | Promise<void>;
+  /** Internal: shared state key used by the client to subscribe */
+  readonly _stateKey: string;
+}
+//#endregion
+//#region src/types/docks.d.ts
+interface DevframeDocksHost {
+  readonly views: Map<string, DevframeDockUserEntry>;
+  readonly events: EventEmitter<{
+    'dock:entry:updated': (entry: DevframeDockUserEntry) => void;
+  }>;
+  register: <T extends DevframeDockUserEntry>(entry: T, force?: boolean) => {
+    update: (patch: Partial<T>) => void;
+  };
+  update: (entry: DevframeDockUserEntry) => void;
+  values: (options?: {
+    includeBuiltin?: boolean;
+  }) => DevframeDockEntry[];
+}
+type DevframeDockEntryCategory = 'app' | 'framework' | 'web' | 'advanced' | 'default' | '~builtin' | (string & {});
+type DevframeDockEntryIcon = string | {
+  light: string;
+  dark: string;
+};
+interface DevframeDockEntryBase {
+  id: string;
+  title: string;
+  icon: DevframeDockEntryIcon;
+  /**
+   * The default order of the entry in the dock.
+   * The higher the number the earlier it appears.
+   * @default 0
+   */
+  defaultOrder?: number;
+  /**
+   * The category of the entry
+   * @default 'default'
+   */
+  category?: DevframeDockEntryCategory;
+  /**
+   * Conditional visibility expression.
+   * When set, the dock entry is only visible when the expression evaluates to true.
+   * Uses the same syntax as command `when` clauses.
+   *
+   * Set to `'false'` to unconditionally hide the entry.
+   *
+   * @example 'clientType == embedded'
+   * @see {@link import('devframe/utils/when').evaluateWhen}
+   */
+  when?: string;
+  /**
+   * Badge text to display on the dock icon (e.g., unread count)
+   */
+  badge?: string;
+  /**
+   * Id of the group this entry belongs to. When set, hosts collapse this entry
+   * under the matching group's button instead of showing it directly on the
+   * dock bar.
+   *
+   * This is a flat pointer — membership, not containment. The entry stays an
+   * independently-registered, top-level entry; only its rendering is grouped
+   * downstream. If the referenced group is never registered, the entry renders
+   * as a normal top-level entry (orphan tolerance).
+   *
+   * @see {@link DevframeViewGroup}
+   */
+  groupId?: string;
+}
+interface ClientScriptEntry {
+  /**
+   * The filepath or module name to import from
+   */
+  importFrom: string;
+  /**
+   * The name to import the module as
+   *
+   * @default 'default'
+   */
+  importName?: string;
+}
+interface DevframeViewIframe extends DevframeDockEntryBase {
+  type: 'iframe';
+  url: string;
+  /**
+   * The id of the iframe, if multiple tabs is assigned with the same id, the iframe will be shared.
+   *
+   * When not provided, it would be treated as a unique frame.
+   */
+  frameId?: string;
+  /**
+   * Optional client script to import into the iframe
+   */
+  clientScript?: ClientScriptEntry;
+  /**
+   * Enable remote-UI mode: the hub injects a connection descriptor
+   * (WS URL + pre-approved auth token) into the iframe URL so a hosted
+   * page can connect back via `connectRemoteDevframe()` from
+   * `@devframes/hub/client` — without needing to ship a dist with the
+   * plugin.
+   *
+   * Requires dev mode (no effect in build mode — no WS server exists).
+   * When enabled, the dock is automatically hidden in build mode unless
+   * the author provides an explicit `when` clause.
+   */
+  remote?: boolean | RemoteDockOptions;
+}
+interface RemoteDockOptions {
+  /**
+   * How to pass the connection descriptor to the hosted page.
+   *
+   * - `'fragment'` (default): appended as a URL fragment.
+   *   Not sent in HTTP requests or Referer headers — safest for auth tokens.
+   * - `'query'`: appended as a URL query parameter. Use when your hosting
+   *   platform rewrites fragments or your SPA router repurposes the fragment
+   *   for navigation. The token will appear in server access logs and
+   *   outbound Referer headers.
+   *
+   * @default 'fragment'
+   */
+  transport?: 'fragment' | 'query';
+  /**
+   * Reject WS handshakes whose `Origin` header doesn't match the dock URL
+   * origin. Turn off when the same hosted app is served from multiple
+   * origins (e.g. preview deploys).
+   *
+   * @default true
+   */
+  originLock?: boolean;
+}
+interface RemoteConnectionInfo extends ConnectionMeta {
+  backend: 'websocket';
+  websocket: string;
+  v: 1;
+  authToken: string;
+  origin: string;
+}
+type DevframeViewLauncherStatus = 'idle' | 'loading' | 'success' | 'error';
+interface DevframeViewLauncher extends DevframeDockEntryBase {
+  type: 'launcher';
+  launcher: {
+    icon?: DevframeDockEntryIcon;
+    title: string;
+    status?: DevframeViewLauncherStatus;
+    error?: string;
+    description?: string;
+    buttonStart?: string;
+    buttonLoading?: string;
+    onLaunch: () => Promise<void>;
+  };
+}
+interface DevframeViewAction extends DevframeDockEntryBase {
+  type: 'action';
+  action: ClientScriptEntry;
+}
+interface DevframeViewCustomRender extends DevframeDockEntryBase {
+  type: 'custom-render';
+  renderer: ClientScriptEntry;
+}
+interface DevframeViewBuiltin extends DevframeDockEntryBase {
+  type: '~builtin';
+  id: '~terminals' | '~messages' | '~client-auth-notice' | '~settings' | '~popup';
+}
+interface DevframeViewJsonRender extends DevframeDockEntryBase {
+  type: 'json-render';
+  /** JsonRenderer handle created by ctx.createJsonRenderer() */
+  ui: JsonRenderer;
+}
+/**
+ * A dock group: a single dock-bar button that collapses every entry whose
+ * {@link DevframeDockEntryBase.groupId} matches this group's `id`.
+ *
+ * A group carries its own `title`/`icon`/`category`/`defaultOrder`/`when`
+ * (inherited from {@link DevframeDockEntryBase}) and has no view payload of its
+ * own — hosts render its members in a popover / sub-navigation. It flows
+ * through the same `register`/`update`/`values` machinery as every other entry,
+ * keyed by `id`.
+ *
+ * Grouping is one level deep: a group entry must not itself set `groupId`.
+ */
+interface DevframeViewGroup extends DevframeDockEntryBase {
+  type: 'group';
+  /**
+   * Member id auto-opened when the group button is activated. When unset,
+   * activating the group only reveals its members (popover-only); no view
+   * opens until a member is chosen.
+   */
+  defaultChildId?: string;
+}
+type DevframeDockUserEntry = DevframeViewIframe | DevframeViewAction | DevframeViewCustomRender | DevframeViewLauncher | DevframeViewJsonRender | DevframeViewGroup;
+type DevframeDockEntry = DevframeDockUserEntry | DevframeViewBuiltin;
+type DevframeDockEntriesGrouped = [category: string, entries: DevframeDockEntry[]][];
+//#endregion
+//#region src/types/commands.d.ts
+interface DevframeCommandKeybinding {
+  /**
+   * Keyboard shortcut string.
+   * Use "Mod" for platform-aware modifier (Cmd on macOS, Ctrl elsewhere).
+   * Examples: "Mod+K", "Mod+Shift+P", "Alt+N"
+   */
+  key: string;
+}
+interface DevframeCommandBase {
+  /**
+   * Unique namespaced ID, e.g. "vite:open-in-editor"
+   */
+  id: string;
+  title: string;
+  description?: string;
+  /**
+   * Icon for the command. Either an Iconify icon string (e.g. "ph:pencil-duotone")
+   * or a theme-specific pair `{ light, dark }` — the same shape as dock icons.
+   */
+  icon?: DevframeDockEntryIcon;
+  category?: string;
+  /**
+   * Whether to show in command palette. Default: true
+   *
+   * - `true` — show the command and flatten its children into search results
+   * - `false` — hide the command entirely from the palette
+   * - `'without-children'` — show the command but don't flatten children into top-level search (children are still accessible via drill-down)
+   */
+  showInPalette?: boolean | 'without-children';
+  /**
+   * Optional context expression for conditional visibility.
+   * When set, the command is only shown in the palette and only executable
+   * when the expression evaluates to true.
+   */
+  when?: string;
+  /**
+   * Default keyboard shortcut(s) for this command
+   */
+  keybindings?: DevframeCommandKeybinding[];
+}
+/**
+ * Server command input — what plugins pass to `ctx.commands.register()`.
+ */
+interface DevframeServerCommandInput extends DevframeCommandBase {
+  /**
+   * Handler for this command. Optional if the command only serves as a group for children.
+   */
+  handler?: (...args: any[]) => any | Promise<any>;
+  /**
+   * Static sub-commands. Two levels max (parent → children).
+   * Each child must have a globally unique `id`.
+   */
+  children?: DevframeServerCommandInput[];
+}
+/**
+ * Serializable server command entry — sent over RPC (no handler).
+ */
+interface DevframeServerCommandEntry extends DevframeCommandBase {
+  source: 'server';
+  children?: DevframeServerCommandEntry[];
+}
+/**
+ * Client command — registered in the webcomponent context.
+ */
+interface DevframeClientCommand extends DevframeCommandBase {
+  source: 'client';
+  /**
+   * Action for this command. Optional if the command only serves as a group for children.
+   * Return sub-commands for dynamic nested palette menus (runtime submenus).
+   */
+  action?: (...args: any[]) => void | DevframeClientCommand[] | Promise<void | DevframeClientCommand[]>;
+  /**
+   * Static sub-commands. Two levels max (parent → children).
+   */
+  children?: DevframeClientCommand[];
+}
+/**
+ * Union of command entries visible in the palette.
+ */
+type DevframeCommandEntry = DevframeServerCommandEntry | DevframeClientCommand;
+interface DevframeCommandHandle {
+  readonly id: string;
+  update: (patch: Partial<Omit<DevframeServerCommandInput, 'id'>>) => void;
+  unregister: () => void;
+}
+interface DevframeCommandsHostEvents {
+  'command:registered': (command: DevframeServerCommandEntry) => void;
+  'command:unregistered': (id: string) => void;
+}
+interface DevframeCommandsHost {
+  readonly commands: Map<string, DevframeServerCommandInput>;
+  readonly events: EventEmitter<DevframeCommandsHostEvents>;
+  /**
+   * Register a command (with optional children).
+   */
+  register: (command: DevframeServerCommandInput) => DevframeCommandHandle;
+  /**
+   * Unregister a command by ID (removes parent and all children).
+   */
+  unregister: (id: string) => boolean;
+  /**
+   * Execute a command by ID. Searches top-level and children.
+   * Throws if not found or if command has no handler.
+   */
+  execute: (id: string, ...args: any[]) => Promise<unknown>;
+  /**
+   * Returns serializable list (no handlers), preserving tree structure.
+   */
+  list: () => DevframeServerCommandEntry[];
+}
+interface DevframeCommandShortcutOverrides {
+  /**
+   * Command ID → keybinding overrides. Empty array = shortcut disabled.
+   */
+  [commandId: string]: DevframeCommandKeybinding[];
+}
+//#endregion
+//#region src/types/settings.d.ts
+interface DevframeDocksUserSettings {
+  docksHidden: string[];
+  docksCategoriesHidden: string[];
+  docksPinned: string[];
+  docksCustomOrder: Record<string, number>;
+  showIframeAddressBar: boolean;
+  closeOnOutsideClick: boolean;
+  commandShortcuts: DevframeCommandShortcutOverrides;
+}
+//#endregion
+export { JsonRenderElement as A, DevframeViewGroup as C, DevframeViewLauncherStatus as D, DevframeViewLauncher as E, JsonRenderer as M, RemoteConnectionInfo as O, DevframeViewCustomRender as S, DevframeViewJsonRender as T, DevframeDockEntryIcon as _, DevframeCommandHandle as a, DevframeViewAction as b, DevframeCommandsHost as c, DevframeServerCommandInput as d, ClientScriptEntry as f, DevframeDockEntryCategory as g, DevframeDockEntryBase as h, DevframeCommandEntry as i, JsonRenderSpec as j, RemoteDockOptions as k, DevframeCommandsHostEvents as l, DevframeDockEntry as m, DevframeClientCommand as n, DevframeCommandKeybinding as o, DevframeDockEntriesGrouped as p, DevframeCommandBase as r, DevframeCommandShortcutOverrides as s, DevframeDocksUserSettings as t, DevframeServerCommandEntry as u, DevframeDockUserEntry as v, DevframeViewIframe as w, DevframeViewBuiltin as x, DevframeDocksHost as y };

package/dist/types/index.d.mts

@@ -1,4 +1,4 @@
-import { A as JsonRenderer, C as DevframeViewJsonRender, D as RemoteDockOptions, E as RemoteConnectionInfo, F as DevframeMessageFilePosition, I as DevframeMessageHandle, L as DevframeMessageLevel, M as DevframeMessageEntry, N as DevframeMessageEntryFrom, O as JsonRenderElement, P as DevframeMessageEntryInput, R as DevframeMessagesClient, S as DevframeViewIframe, T as DevframeViewLauncherStatus, _ as DevframeDocksHost, a as DevframeChildProcessTerminalSession, b as DevframeViewCustomRender, c as DevframeTerminalStatus, d as DevframeDockEntriesGrouped, f as DevframeDockEntry, g as DevframeDockUserEntry, h as DevframeDockEntryIcon, i as DevframeChildProcessExecuteOptions, j as DevframeMessageElementPosition, k as JsonRenderSpec, l as DevframeTerminalsHost, m as DevframeDockEntryCategory, n as DevframeHubContext, o as DevframeTerminalSession, p as DevframeDockEntryBase, s as DevframeTerminalSessionBase, t as CreateHubContextOptions, u as ClientScriptEntry, v as DevframeViewAction, w as DevframeViewLauncher, x as DevframeViewGroup, y as DevframeViewBuiltin, z as DevframeMessagesHost } from "../context-Dox-G9vt.mjs";
-import { a as DevframeCommandHandle, c as DevframeCommandsHost, d as DevframeServerCommandInput, i as DevframeCommandEntry, l as DevframeCommandsHostEvents, n as DevframeClientCommand, o as DevframeCommandKeybinding, r as DevframeCommandBase, s as DevframeCommandShortcutOverrides, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry } from "../settings-Bp5Ax6Os.mjs";
-import { C as RpcStreamingChannel, E as Thenable, S as RpcSharedStateHost, T as RpcStreamingHost, _ as RpcBroadcastOptions, a as DevframeDiagnosticsLogger, b as RpcFunctionsHost, c as DevframeRpcClientFunctions, d as DevframeViewHost, f as EntriesToObject, g as PartialWithoutId, h as EventsMap, i as DevframeDiagnosticsHost, l as DevframeRpcServerFunctions, m as EventUnsubscribe, n as DevframeCapabilities, o as DevframeHost, p as EventEmitter, r as DevframeDiagnosticsDefinition, s as DevframeNodeRpcSession, t as ConnectionMeta, u as DevframeRpcSharedStates, v as RpcDefinitionsFilter, w as RpcStreamingChannelOptions, x as RpcSharedStateGetOptions, y as RpcDefinitionsToFunctions } from "../index-BWTfvdqa.mjs";
-export { ClientScriptEntry, ConnectionMeta, CreateHubContextOptions, DevframeCapabilities, DevframeChildProcessExecuteOptions, DevframeChildProcessTerminalSession, DevframeClientCommand, DevframeCommandBase, DevframeCommandEntry, DevframeCommandHandle, DevframeCommandKeybinding, DevframeCommandShortcutOverrides, DevframeCommandsHost, DevframeCommandsHostEvents, DevframeDiagnosticsDefinition, DevframeDiagnosticsHost, DevframeDiagnosticsLogger, DevframeDockEntriesGrouped, DevframeDockEntry, DevframeDockEntryBase, DevframeDockEntryCategory, DevframeDockEntryIcon, DevframeDockUserEntry, DevframeDocksHost, DevframeDocksUserSettings, DevframeHost, DevframeHubContext, DevframeMessageElementPosition, DevframeMessageEntry, DevframeMessageEntryFrom, DevframeMessageEntryInput, DevframeMessageFilePosition, DevframeMessageHandle, DevframeMessageLevel, DevframeMessagesClient, DevframeMessagesHost, DevframeNodeRpcSession, DevframeRpcClientFunctions, DevframeRpcServerFunctions, DevframeRpcSharedStates, DevframeServerCommandEntry, DevframeServerCommandInput, DevframeTerminalSession, DevframeTerminalSessionBase, DevframeTerminalStatus, DevframeTerminalsHost, DevframeViewAction, DevframeViewBuiltin, DevframeViewCustomRender, DevframeViewGroup, DevframeViewHost, DevframeViewIframe, DevframeViewJsonRender, DevframeViewLauncher, DevframeViewLauncherStatus, EntriesToObject, EventEmitter, EventUnsubscribe, EventsMap, JsonRenderElement, JsonRenderSpec, JsonRenderer, PartialWithoutId, RemoteConnectionInfo, RemoteDockOptions, RpcBroadcastOptions, RpcDefinitionsFilter, RpcDefinitionsToFunctions, RpcFunctionsHost, RpcSharedStateGetOptions, RpcSharedStateHost, RpcStreamingChannel, RpcStreamingChannelOptions, RpcStreamingHost, Thenable };
+import { C as DevframeMessagesListDelta, S as DevframeMessagesLevelShortcuts, _ as DevframeMessageHandle, a as DevframeChildProcessTerminalSession, b as DevframeMessagesClient, c as DevframeTerminalSession, d as DevframeTerminalsHost, f as DevframeMessageElementPosition, g as DevframeMessageFilePosition, h as DevframeMessageEntryInput, i as DevframeChildProcessExecuteOptions, l as DevframeTerminalSessionBase, m as DevframeMessageEntryFrom, n as DevframeHubContext, o as DevframePtyExecuteOptions, p as DevframeMessageEntry, s as DevframePtyTerminalSession, t as CreateHubContextOptions, u as DevframeTerminalStatus, v as DevframeMessageLevel, x as DevframeMessagesHost, y as DevframeMessageShortcutInput } from "../context-DVh4gk8f.mjs";
+import { A as JsonRenderElement, C as DevframeViewGroup, D as DevframeViewLauncherStatus, E as DevframeViewLauncher, M as JsonRenderer, O as RemoteConnectionInfo, S as DevframeViewCustomRender, T as DevframeViewJsonRender, _ as DevframeDockEntryIcon, a as DevframeCommandHandle, b as DevframeViewAction, c as DevframeCommandsHost, d as DevframeServerCommandInput, f as ClientScriptEntry, g as DevframeDockEntryCategory, h as DevframeDockEntryBase, i as DevframeCommandEntry, j as JsonRenderSpec, k as RemoteDockOptions, l as DevframeCommandsHostEvents, m as DevframeDockEntry, n as DevframeClientCommand, o as DevframeCommandKeybinding, p as DevframeDockEntriesGrouped, r as DevframeCommandBase, s as DevframeCommandShortcutOverrides, t as DevframeDocksUserSettings, u as DevframeServerCommandEntry, v as DevframeDockUserEntry, w as DevframeViewIframe, x as DevframeViewBuiltin, y as DevframeDocksHost } from "../settings-B9YjSEcl.mjs";
+import { C as RpcStreamingChannel, E as Thenable, S as RpcSharedStateHost, T as RpcStreamingHost, _ as RpcBroadcastOptions, a as DevframeDiagnosticsLogger, b as RpcFunctionsHost, c as DevframeRpcClientFunctions, d as DevframeViewHost, f as EntriesToObject, g as PartialWithoutId, h as EventsMap, i as DevframeDiagnosticsHost, l as DevframeRpcServerFunctions, m as EventUnsubscribe, n as DevframeCapabilities, o as DevframeHost, p as EventEmitter, r as DevframeDiagnosticsDefinition, s as DevframeNodeRpcSession, t as ConnectionMeta, u as DevframeRpcSharedStates, v as RpcDefinitionsFilter, w as RpcStreamingChannelOptions, x as RpcSharedStateGetOptions, y as RpcDefinitionsToFunctions } from "../index-Dic9q4eN.mjs";
+export { ClientScriptEntry, ConnectionMeta, CreateHubContextOptions, DevframeCapabilities, DevframeChildProcessExecuteOptions, DevframeChildProcessTerminalSession, DevframeClientCommand, DevframeCommandBase, DevframeCommandEntry, DevframeCommandHandle, DevframeCommandKeybinding, DevframeCommandShortcutOverrides, DevframeCommandsHost, DevframeCommandsHostEvents, DevframeDiagnosticsDefinition, DevframeDiagnosticsHost, DevframeDiagnosticsLogger, DevframeDockEntriesGrouped, DevframeDockEntry, DevframeDockEntryBase, DevframeDockEntryCategory, DevframeDockEntryIcon, DevframeDockUserEntry, DevframeDocksHost, DevframeDocksUserSettings, DevframeHost, DevframeHubContext, DevframeMessageElementPosition, DevframeMessageEntry, DevframeMessageEntryFrom, DevframeMessageEntryInput, DevframeMessageFilePosition, DevframeMessageHandle, DevframeMessageLevel, DevframeMessageShortcutInput, DevframeMessagesClient, DevframeMessagesHost, DevframeMessagesLevelShortcuts, DevframeMessagesListDelta, DevframeNodeRpcSession, DevframePtyExecuteOptions, DevframePtyTerminalSession, DevframeRpcClientFunctions, DevframeRpcServerFunctions, DevframeRpcSharedStates, DevframeServerCommandEntry, DevframeServerCommandInput, DevframeTerminalSession, DevframeTerminalSessionBase, DevframeTerminalStatus, DevframeTerminalsHost, DevframeViewAction, DevframeViewBuiltin, DevframeViewCustomRender, DevframeViewGroup, DevframeViewHost, DevframeViewIframe, DevframeViewJsonRender, DevframeViewLauncher, DevframeViewLauncherStatus, EntriesToObject, EventEmitter, EventUnsubscribe, EventsMap, JsonRenderElement, JsonRenderSpec, JsonRenderer, PartialWithoutId, RemoteConnectionInfo, RemoteDockOptions, RpcBroadcastOptions, RpcDefinitionsFilter, RpcDefinitionsToFunctions, RpcFunctionsHost, RpcSharedStateGetOptions, RpcSharedStateHost, RpcStreamingChannel, RpcStreamingChannelOptions, RpcStreamingHost, Thenable };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/hub",
   "type": "module",
-  "version": "0.5.3",
+  "version": "0.6.0-beta.1",
   "description": "Framework-neutral hub layer for devframe — docks, terminals, messages, commands.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -33,22 +33,26 @@
     "dist"
   ],
   "peerDependencies": {
-    "devframe": "0.5.3"
+    "devframe": "0.6.0-beta.1"
   },
   "dependencies": {
     "birpc": "^4.0.0",
-    "nostics": "^0.2.0",
+    "destr": "^2.0.5",
+    "nostics": "^1.1.4",
     "pathe": "^2.0.3",
     "perfect-debounce": "^2.1.0",
-    "tinyexec": "^1.2.2"
+    "tinyexec": "^1.2.2",
+    "zigpty": "^0.2.1"
   },
   "devDependencies": {
+    "@types/node": "^25.9.1",
     "mlly": "^1.8.2",
     "tsdown": "^0.22.0",
-    "devframe": "0.5.3"
+    "devframe": "0.6.0-beta.1"
   },
   "scripts": {
     "build": "tsdown",
-    "watch": "tsdown --watch"
+    "watch": "tsdown --watch",
+    "typecheck": "tsc --noEmit"
   }
 }