perf(deps): shrink the install footprint (#392)

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'),
@@ -41,6 +42,7 @@ export const alias = {
   'devframe/utils/shared-state': r('devframe/src/utils/shared-state.ts'),
   'devframe/utils/streaming-channel': r('devframe/src/utils/streaming-channel.ts'),
   'devframe/utils/structured-clone': r('devframe/src/utils/structured-clone.ts'),
+  'devframe/utils/url': r('devframe/src/utils/url.ts'),
   'devframe/utils/when': r('devframe/src/utils/when.ts'),
   'devframe/adapters/cac': r('devframe/src/adapters/cac.ts'),
   'devframe/adapters/dev': r('devframe/src/adapters/dev.ts'),

docs/app/pages/logos.vue

@@ -1,6 +1,5 @@
 <script setup lang="ts">
 // Shadows the comark-docs layer's brand-assets page with devframe's assets.
-import { joinURL } from 'ufo'
 import logoSvg from '../../public/logo.svg?raw'
 
 definePageMeta({
@@ -11,7 +10,7 @@ const title = 'Brand assets'
 const description = 'Logos and assets for Devframe. Download SVG or PNG, or copy the raw SVG source directly.'
 
 const site = useSiteConfig()
-const canonicalUrl = computed(() => joinURL(site.url, '/logos'))
+const canonicalUrl = computed(() => new URL('/logos', site.url).href)
 
 useRobotsRule('index, follow')
 

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.
@@ -123,6 +134,20 @@ state.mutate((draft) => {
 state.value() // => count is 1
 ```
 
+### `devframe/utils/url`
+
+URL path-joining and slash-normalization helpers (browser-safe, zero-dep).
+
+```ts
+import { joinURL, withBase, withProtocol, withTrailingSlash } from 'devframe/utils/url'
+
+joinURL('/__devframe', '__renderers', 'vue.mjs') // '/__devframe/__renderers/vue.mjs'
+withBase('meta.json', '/__devframe/') // '/__devframe/meta.json'
+withProtocol('http://localhost:7777/ws', 'ws://') // 'ws://localhost:7777/ws'
+```
+
+Also exports `withLeadingSlash`, `withoutLeadingSlash`, `withoutTrailingSlash`, and `cleanDoubleSlashes`.
+
 ### `devframe/utils/streaming-channel`
 
 Sink/reader primitives for streamed RPC payloads, via `ctx.rpc.streaming`; see [Streaming](/guide/streaming).

docs/package.json

@@ -20,8 +20,7 @@
     "comark-docs": "catalog:docs",
     "d3-shape": "catalog:frontend",
     "nuxt": "catalog:build",
-    "shiki": "catalog:deps",
-    "ufo": "catalog:deps"
+    "shiki": "catalog:deps"
   },
   "devDependencies": {
     "@types/d3-shape": "catalog:types"

packages/agentic/package.json

@@ -41,12 +41,11 @@
   "dependencies": {
     "@modelcontextprotocol/client": "catalog:deps",
     "@modelcontextprotocol/server": "catalog:deps",
-    "@standard-schema/spec": "catalog:deps",
     "h3": "catalog:deps",
-    "pathe": "catalog:deps",
-    "ufo": "catalog:deps"
+    "pathe": "catalog:deps"
   },
   "devDependencies": {
+    "@standard-schema/spec": "catalog:deps",
     "@types/node": "catalog:types",
     "devframe": "workspace:*",
     "tsdown": "catalog:build",

packages/agentic/src/connect/index.ts

@@ -6,7 +6,7 @@ import { StdioServerTransport } from '@modelcontextprotocol/server/stdio'
 import { diagnostics, listLiveDevframeInstances, probeDevframeOrigin } from 'devframe/internal'
 import { toAgentToolName } from 'devframe/utils/agent-tool-name'
 import { Diagnostic } from 'devframe/utils/nostics'
-import { joinURL } from 'ufo'
+import { joinURL } from 'devframe/utils/url'
 
 export interface ConnectServerOptions {
   /**

packages/agentic/src/index.ts

@@ -12,3 +12,6 @@ throw new Error(
   + '  • import from "devframe/adapters/mcp" to serve a devframe over MCP\n'
   + '  • run "devframe connect" for the stdio discovery gateway\n',
 )
+
+// An explicit empty module so dts emit has something to say about this entry.
+export {}

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",
@@ -62,6 +63,7 @@
     "./utils/shared-state": "./dist/utils/shared-state.mjs",
     "./utils/streaming-channel": "./dist/utils/streaming-channel.mjs",
     "./utils/structured-clone": "./dist/utils/structured-clone.mjs",
+    "./utils/url": "./dist/utils/url.mjs",
     "./utils/when": "./dist/utils/when.mjs",
     "./package.json": "./package.json"
   },
@@ -93,22 +95,21 @@
     }
   },
   "dependencies": {
-    "@standard-schema/spec": "catalog:deps",
-    "birpc": "catalog:deps",
     "crossws": "catalog:deps",
     "h3": "catalog:deps",
-    "mrmime": "catalog:deps",
     "nostics": "catalog:deps",
-    "pathe": "catalog:deps",
-    "ufo": "catalog:deps"
+    "pathe": "catalog:deps"
   },
   "devDependencies": {
     "@devframes/agentic": "workspace:*",
+    "@standard-schema/spec": "catalog:deps",
+    "birpc": "catalog:deps",
     "cac": "catalog:deps",
     "get-port-please": "catalog:deps",
     "immer": "catalog:deps",
     "launch-editor": "catalog:deps",
     "mlly": "catalog:build",
+    "mrmime": "catalog:deps",
     "obug": "catalog:deps",
     "ohash": "catalog:deps",
     "p-limit": "catalog:deps",

packages/devframe/src/adapters/_shared.ts

@@ -2,8 +2,8 @@ import type { AgenticMcpModule } from '../node/agentic'
 import type { DevframeAgentHost } from '../types/agent'
 import type { ConnectionMeta } from '../types/context'
 import type { DevframeDefinition, DevframeDeploymentKind, McpAuthorization, McpSetting } from '../types/devframe'
+import { cleanDoubleSlashes, withLeadingSlash, withoutLeadingSlash, withTrailingSlash } from 'devframe/utils/url'
 import { getPort } from 'get-port-please'
-import { cleanDoubleSlashes, withLeadingSlash, withoutLeadingSlash, withTrailingSlash } from 'ufo'
 import { DEVFRAME_MCP_ROUTE } from '../constants'
 import { importAgenticMcp, isAgenticInstalled, warnAgenticMcpMissingOnce } from '../node/agentic'
 

packages/devframe/src/adapters/dev.ts

@@ -6,8 +6,8 @@ import type { StaticAssetsSource } from '../types/remote-assets'
 import type { DevframeNodeRpcSession, DevframeNodeRpcSessionMeta } from '../types/rpc'
 import { createServer } from 'node:http'
 import { open } from 'devframe/utils/open'
+import { withBase } from 'devframe/utils/url'
 import { H3, toNodeHandler } from 'h3'
-import { withBase } from 'ufo'
 import { diagnostics } from '../node/diagnostics'
 import { normalizeHttpServerUrl } from '../node/utils'
 import { normalizeBasePath, resolveBasePath, resolveDevServerPort } from './_shared'