feat(devframe): expose bundled perfect-debounce as devframe/utils/debounce

New browser-safe util re-exports perfect-debounce's debounce (bundled into
devframe's dist). @devframes/hub and @devframes/plugin-assets now import it
through the devframe peer instead of declaring their own perfect-debounce
dependency, so the bytes live once and integrations reuse it with no new
install. perfect-debounce is now declared only by devframe.

Author: antfubot

alias.ts

@@ -28,6 +28,7 @@ export const alias = {
   'devframe/utils/agent-tool-name': r('devframe/src/utils/agent-tool-name.ts'),
   'devframe/utils/colors': r('devframe/src/utils/colors.ts'),
   'devframe/utils/crypto-token': r('devframe/src/utils/crypto-token.ts'),
+  'devframe/utils/debounce': r('devframe/src/utils/debounce.ts'),
   'devframe/utils/events': r('devframe/src/utils/events.ts'),
   'devframe/utils/hash': r('devframe/src/utils/hash.ts'),
   'devframe/utils/launch-editor': r('devframe/src/utils/launch-editor.ts'),

docs/content/8.references/8.utilities.md

@@ -96,6 +96,17 @@ randomDigits(6) // '047204', uniform, leading zeros preserved
 timingSafeEqual(input, secret) // constant-time string comparison
 ```
 
+### `devframe/utils/debounce`
+
+Promise-aware debounce, bundled in so integrations reuse it without adding a `perfect-debounce` dependency.
+
+```ts
+import { debounce } from 'devframe/utils/debounce'
+
+const save = debounce((state: State) => write(state), 100)
+save(next) // coalesces bursts; returns a promise, plus `.cancel()` / `.flush()` / `.isPending()`
+```
+
 ### `devframe/utils/events`
 
 Typed event emitter.

packages/devframe/package.json

@@ -48,6 +48,7 @@
     "./utils/agent-tool-name": "./dist/utils/agent-tool-name.mjs",
     "./utils/colors": "./dist/utils/colors.mjs",
     "./utils/crypto-token": "./dist/utils/crypto-token.mjs",
+    "./utils/debounce": "./dist/utils/debounce.mjs",
     "./utils/events": "./dist/utils/events.mjs",
     "./utils/get-port": "./dist/utils/get-port.mjs",
     "./utils/hash": "./dist/utils/hash.mjs",

packages/devframe/src/node/storage.ts

@@ -1,8 +1,8 @@
 import fs from 'node:fs'
 import process from 'node:process'
+import { debounce } from 'devframe/utils/debounce'
 import { createSharedState } from 'devframe/utils/shared-state'
 import { dirname } from 'pathe'
-import { debounce } from 'perfect-debounce'
 import { diagnostics } from './diagnostics'
 
 export interface CreateStorageOptions<T extends object> {

packages/devframe/src/utils/debounce.ts

@@ -0,0 +1,8 @@
+/**
+ * Promise-aware debounce, bundled in so any integration can reuse it through
+ * `devframe/utils/debounce` without adding its own `perfect-debounce`
+ * dependency. Thin re-export of `perfect-debounce`'s `debounce`; the bytes
+ * live once in devframe's dist.
+ */
+export type { DebouncedReturn, DebounceOptions } from 'perfect-debounce'
+export { debounce } from 'perfect-debounce'

packages/devframe/tsdown.config.ts

@@ -78,6 +78,7 @@ const clientEntries = {
   'utils/agent-tool-name': 'src/utils/agent-tool-name.ts',
   'utils/colors': 'src/utils/colors.ts',
   'utils/crypto-token': 'src/utils/crypto-token.ts',
+  'utils/debounce': 'src/utils/debounce.ts',
   'utils/events': 'src/utils/events.ts',
   'utils/hash': 'src/utils/hash.ts',
   'utils/nanoid': 'src/utils/nanoid.ts',
@@ -164,6 +165,7 @@ export default defineConfig([
             resolve(distDir, 'utils/agent-tool-name.mjs'),
             resolve(distDir, 'utils/colors.mjs'),
             resolve(distDir, 'utils/crypto-token.mjs'),
+            resolve(distDir, 'utils/debounce.mjs'),
             resolve(distDir, 'utils/events.mjs'),
             resolve(distDir, 'utils/hash.mjs'),
             resolve(distDir, 'utils/nanoid.mjs'),

packages/hub/package.json

@@ -62,7 +62,6 @@
     "@types/node": "catalog:types",
     "devframe": "workspace:*",
     "get-port-please": "catalog:deps",
-    "perfect-debounce": "catalog:deps",
     "tsdown": "catalog:build",
     "valibot": "catalog:deps"
   }

packages/hub/src/node/context.ts

@@ -7,7 +7,7 @@ import type { DevframeTerminalsHost } from '../types/terminals'
 import type { InstallDevframeOptions } from './install-devframe'
 import { createHostContext } from 'devframe/node'
 import { getInternalContext } from 'devframe/node/hub-internals'
-import { debounce } from 'perfect-debounce'
+import { debounce } from 'devframe/utils/debounce'
 import { HUB_EVENTS } from '../events'
 import { DevframeCommandsHost as CommandsHostImpl } from './host-commands'
 import { DevframeDocksHost as DocksHostImpl } from './host-docks'

packages/hub/tsdown.config.ts

@@ -26,7 +26,6 @@ export default defineConfig({
       '@standard-schema/spec',
       'acorn',
       'get-port-please',
-      'perfect-debounce',
     ],
   },
 })

plugins/assets/package.json

@@ -70,7 +70,6 @@
     "chokidar": "catalog:deps",
     "image-meta": "catalog:deps",
     "pathe": "catalog:deps",
-    "perfect-debounce": "catalog:deps",
     "tinyglobby": "catalog:deps"
   },
   "devDependencies": {