@devframes/plugin-assets 0.9.9 → 0.9.10

package/bin.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import process from 'node:process'
-import { createAssetsCli } from './dist/cli.mjs'
+import { createAssetsCli } from './dist/node/cli.mjs'
 
 async function main() {
   await createAssetsCli().parse()

package/dist/{cli.d.mts → node/cli.d.mts}

@@ -1,5 +1,5 @@
 import { CacHandle } from "devframe/adapters/cac";
-//#region src/cli.d.ts
+//#region src/node/cli.d.ts
 declare function createAssetsCli(): CacHandle;
 //#endregion
 export { createAssetsCli };

package/dist/{cli.mjs → node/cli.mjs}

@@ -1,6 +1,6 @@
-import { t as createAssetsDevframe } from "./src-BpDib51Z.mjs";
+import { t as createAssetsDevframe } from "../node-CYRI6r4z.mjs";
 import { createCac } from "devframe/adapters/cac";
-//#region src/cli.ts
+//#region src/node/cli.ts
 function createAssetsCli() {
 	return createCac(createAssetsDevframe({ serveStatic: true }));
 }

package/dist/node/index.d.mts

@@ -1,102 +1,79 @@
-import { n as AssetInfo, r as AssetType } from "../types-BKiX3RbA.mjs";
-import { DevframeNodeContext, RpcStreamingChannel } from "devframe";
-//#region src/node/context.d.ts
-interface AssetsConfig {
-  /** Directory this devframe manages. */
-  dir: string;
-  /** Whether upload / rename / delete / mkdir are registered. */
-  write: boolean;
-  /** Extensions `upload` accepts, or `'*'` to accept any. */
-  uploadExtensions: readonly string[] | '*';
+import { a as DEFAULT_ALLOWED_UPLOAD_EXTENSIONS, i as CodeSnippet, n as AssetInfo, r as AssetType, t as AssetImageMeta } from "../types-Bspm5Ylo.mjs";
+import { DevframeDefinition } from "devframe";
+//#region src/node/index.d.ts
+interface AssetsDevframeOptions {
+  id?: string;
+  name?: string;
+  icon?: string;
   /**
-   * URL base the managed directory is served at. Normally the host
-   * (Vite / Nuxt / …) serves `public/` at `/`, so asset `publicPath`s are
-   * `joinURL(baseURL, path)` and the plugin serves nothing itself.
+   * Directory this devframe manages. Defaults to `<cwd>/public`, the
+   * conventional static-asset folder for Nuxt, Vite, and most static-site
+   * frameworks. Pass an absolute path, or one relative to the devframe's
+   * own `cwd`.
    */
-  baseURL: string;
-  /** The upload streaming channel, created once in `setupAssets` when `write` is enabled. */
-  uploadChannel?: RpcStreamingChannel<Uint8Array>;
-}
-interface AssetsContext extends AssetsConfig {
+  dir?: string;
   /**
-   * Resolve a root-relative path to an absolute one, rejecting lexical
-   * escapes. Symlink-aware containment for reads and mutations lives in
-   * `node/paths` (`resolveAssetReadPath` / `assertAssetMutationPath`), which
-   * the RPC handlers call directly with {@link AssetsContext.dir}.
+   * URL base the **host** serves the managed directory at, used to build
+   * each asset's `publicPath`. Defaults to `/`; Vite, Nuxt, and most
+   * frameworks serve their `public/` folder at the site root. Set this to
+   * match a non-root deployment base (e.g. Nuxt's `app.baseURL`).
    */
-  resolvePath: (relativePath: string) => string;
-}
-/**
- * Record the managed directory and write policy for a context. Called from
- * the devframe's `setup` before any RPC handler runs.
- */
-declare function configureAssets(ctx: DevframeNodeContext, config: AssetsConfig): void;
-/**
- * Per-`DevframeNodeContext` assets state. Each RPC function pulls its
- * managed directory and path resolver from here instead of re-reading
- * `configureAssets`'s config on every call.
- */
-declare function getAssetsContext(ctx: DevframeNodeContext): AssetsContext;
-//#endregion
-//#region src/node/paths.d.ts
-/**
- * Resolve a client-supplied, root-relative path against the managed
- * directory, rejecting anything that would escape it lexically (`..`
- * traversal, a rogue absolute path). The first guard every RPC handler runs;
- * symlink-aware containment is layered on by {@link resolveAssetReadPath}
- * (reads) and {@link assertAssetMutationPath} (mutations).
- */
-declare function resolveAssetPath(root: string, relativePath: string): string;
-//#endregion
-//#region src/node/scanner.d.ts
-/** Classifies a path by extension, driving preview and icon choice. */
-declare function guessAssetType(path: string): AssetType;
-/** Recursively lists every file under `dir`, sorted alphabetically by path. */
-declare function scanAssets(dir: string, baseURL: string, includeFsPath?: boolean): Promise<AssetInfo[]>;
-//#endregion
-//#region src/node/index.d.ts
-interface SetupAssetsOptions {
-  /** Directory this devframe manages. */
-  dir: string;
-  /** Whether upload / rename / delete / mkdir are registered. */
-  write: boolean;
-  /** Extensions `upload` accepts, or `'*'` to accept any. */
-  uploadExtensions: readonly string[] | '*';
+  baseURL?: string;
+  /**
+   * Serve the managed directory's bytes from this devframe itself.
+   * Defaults to `false`: when mounted into a host (Vite/Nuxt/…) that host
+   * already serves `public/` at {@link baseURL}, so the plugin references
+   * those URLs instead of standing up its own route. The standalone CLI
+   * sets this to `true` (it is its own host), serving the directory under
+   * a dedicated base so it doesn't collide with the SPA at `/`.
+   */
+  serveStatic?: boolean;
+  basePath?: string;
+  distDir?: string;
+  /** Preferred standalone CLI port (default 9015). */
+  port?: number;
+  /**
+   * Enable upload, rename, delete, and folder creation from the UI.
+   * Enabled by default; set `false` (or pass `--read-only` on the
+   * standalone CLI) for a browse-only deployment.
+   */
+  write?: boolean;
+  /**
+   * Extensions `upload` accepts, or `'*'` to accept any file. Defaults to
+   * the same allow-list Nuxt DevTools ships.
+   */
+  uploadExtensions?: readonly string[] | '*';
+  /**
+   * Watch the managed directory in dev mode and push live listing updates.
+   * Enabled by default. Set `false` to skip the file watcher, useful when a
+   * host mounts the devframe in a short-lived or repeatedly-recreated
+   * context (tests, some SSR dev servers) where a background watcher isn't
+   * wanted.
+   */
+  watch?: boolean;
   /**
-   * URL base the managed directory is served at, the base every asset's
-   * `publicPath` is resolved against.
+   * Require the trust handshake on the standalone server. Enabled by
+   * default, because this devframe can read, write, and delete real files.
    */
-  baseURL: string;
+  auth?: boolean;
   /**
-   * Whether this devframe should serve the managed directory's bytes
-   * itself. Left `false` when mounted into a host (Vite / Nuxt / …) that
-   * already serves `public/` at {@link baseURL}; set `true` only for the
-   * standalone CLI, which is its own host.
+   * Register the `build` CLI subcommand. Disabled by default: a static
+   * export can only ever list file metadata from a baked snapshot; there
+   * is no live host serving the files, and every write action is inherently
+   * excluded from a static dump, so the command would produce a broken,
+   * write-less shell of the tool. Opt back in if that degraded export is
+   * still useful to you.
    */
-  serveStatic: boolean;
-  /** Start the live file watcher (dev mode only). */
-  watch: boolean;
+  build?: boolean;
 }
 /**
- * Register the assets RPC surface on a devframe node context: ensures the
- * managed directory exists, registers the read RPCs (always) and write
- * RPCs (when enabled), and starts a live file watcher in dev mode.
+ * Create the assets manager devframe, a framework-neutral port of Nuxt
+ * DevTools' Assets tab. Mount it into any host via devframe's adapters, or
+ * run it standalone with the bundled CLI (`devframe-assets`).
  *
- * Raw asset bytes (for `<img>`/`<video>`/download previews) are served by
- * the **host** the plugin is attached to: Vite, Nuxt, or any framework
- * already serves its `public/` dir at {@link SetupAssetsOptions.baseURL}.
- * The plugin only serves them itself when `serveStatic` is set (the
- * standalone CLI, which is its own host).
- *
- * Called from the definition's `setup(ctx)` and reusable by host adapters
- * that wire their own context.
- */
-declare function setupAssets(ctx: DevframeNodeContext, options: SetupAssetsOptions): Promise<void>;
-/**
- * Stop the live file watcher started by {@link setupAssets}. Test harnesses
- * wrap their dev-server `close()` with this (see `test/_utils.ts`), so a
- * leaked chokidar watcher doesn't keep the process alive.
+ * @experimental This plugin is experimental and may change without a major
+ * version bump until it stabilizes.
  */
-declare function disposeAssetsWatcher(ctx: DevframeNodeContext): Promise<void>;
+declare function createAssetsDevframe(options?: AssetsDevframeOptions): DevframeDefinition;
 //#endregion
-export { SetupAssetsOptions, configureAssets, disposeAssetsWatcher, getAssetsContext, guessAssetType, resolveAssetPath, scanAssets, setupAssets };
+export { type AssetImageMeta, type AssetInfo, type AssetType, AssetsDevframeOptions, type CodeSnippet, DEFAULT_ALLOWED_UPLOAD_EXTENSIONS, createAssetsDevframe, createAssetsDevframe as default };

package/dist/node/index.mjs

@@ -1,3 +1,2 @@
-import { n as setupAssets, t as disposeAssetsWatcher } from "../node-Diynhcd3.mjs";
-import { _ as getAssetsContext, d as scanAssets, g as configureAssets, u as guessAssetType, v as resolveAssetPath } from "../rpc-Pau8tZGm.mjs";
-export { configureAssets, disposeAssetsWatcher, getAssetsContext, guessAssetType, resolveAssetPath, scanAssets, setupAssets };
+import { n as DEFAULT_ALLOWED_UPLOAD_EXTENSIONS, t as createAssetsDevframe } from "../node-CYRI6r4z.mjs";
+export { DEFAULT_ALLOWED_UPLOAD_EXTENSIONS, createAssetsDevframe, createAssetsDevframe as default };

package/dist/{rpc → node/rpc}/index.d.mts

@@ -1,6 +1,6 @@
 import { DevframeNodeContext } from "devframe";
 import { RpcDefinitionsToFunctions } from "devframe/rpc";
-//#region src/rpc/functions/capabilities.d.ts
+//#region src/node/rpc/functions/capabilities.d.ts
 interface AssetsCapabilities {
   write: boolean;
   uploadExtensions: readonly string[] | '*';
@@ -48,7 +48,7 @@ declare const capabilities: {
   }>>> | undefined;
 };
 //#endregion
-//#region src/rpc/functions/delete.d.ts
+//#region src/node/rpc/functions/delete.d.ts
 /** One request covers both single- and multi-select delete. */
 declare const deleteAssets: {
   name: "devframes:plugin:assets:delete";
@@ -94,7 +94,7 @@ declare const deleteAssets: {
   }>>> | undefined;
 };
 //#endregion
-//#region src/rpc/functions/list.d.ts
+//#region src/node/rpc/functions/list.d.ts
 declare const assetInfoSchema: import("devframe/utils/simple-schema").SimpleSchema<{
   path: string;
   type: "image" | "font" | "video" | "audio" | "text" | "other";
@@ -175,7 +175,7 @@ declare const list: {
   }[]>>> | undefined;
 };
 //#endregion
-//#region src/rpc/functions/mkdir.d.ts
+//#region src/node/rpc/functions/mkdir.d.ts
 declare const mkdir: {
   name: "devframes:plugin:assets:mkdir";
   type?: "action" | undefined;
@@ -206,7 +206,7 @@ declare const mkdir: {
   }], import("devframe/rpc").Thenable<void>>> | undefined;
 };
 //#endregion
-//#region src/rpc/functions/read-image-meta.d.ts
+//#region src/node/rpc/functions/read-image-meta.d.ts
 declare const readImageMeta: {
   name: "devframes:plugin:assets:read-image-meta";
   type?: "query" | undefined;
@@ -251,7 +251,7 @@ declare const readImageMeta: {
   } | null>>> | undefined;
 };
 //#endregion
-//#region src/rpc/functions/read-text.d.ts
+//#region src/node/rpc/functions/read-text.d.ts
 declare const readText: {
   name: "devframes:plugin:assets:read-text";
   type?: "query" | undefined;
@@ -268,7 +268,7 @@ declare const readText: {
   __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string, number | undefined], import("devframe/rpc").Thenable<string | null>>> | undefined;
 };
 //#endregion
-//#region src/rpc/functions/rename.d.ts
+//#region src/node/rpc/functions/rename.d.ts
 interface RenameArgs {
   /** Root-relative path of the asset to rename. */
   path: string;
@@ -366,7 +366,7 @@ declare const rename: {
   }>>> | undefined;
 };
 //#endregion
-//#region src/rpc/functions/upload.d.ts
+//#region src/node/rpc/functions/upload.d.ts
 /** Streaming channel name, namespaced like every other RPC name in this plugin. */
 declare const UPLOAD_CHANNEL = "devframes:plugin:assets:upload";
 /**
@@ -418,7 +418,7 @@ declare const upload: {
   }>>> | undefined;
 };
 //#endregion
-//#region src/rpc/index.d.ts
+//#region src/node/rpc/index.d.ts
 /** Read-only RPC, always registered. */
 declare const readFunctions: readonly [{
   name: "devframes:plugin:assets:list";

package/dist/{rpc → node/rpc}/index.mjs

@@ -1,2 +1,2 @@
-import { a as readText, c as assetInfoSchema, f as deleteAssets, h as upload, i as rename, l as list, m as UPLOAD_CHANNEL, n as serverFunctions, o as readImageMeta, p as capabilities, r as writeFunctions, s as mkdir, t as readFunctions } from "../rpc-Pau8tZGm.mjs";
+import { a as readText, c as assetInfoSchema, f as deleteAssets, h as upload, i as rename, l as list, m as UPLOAD_CHANNEL, n as serverFunctions, o as readImageMeta, p as capabilities, r as writeFunctions, s as mkdir, t as readFunctions } from "../../rpc-DG9tV_c_.mjs";
 export { UPLOAD_CHANNEL, assetInfoSchema, capabilities, deleteAssets, list, mkdir, readFunctions, readImageMeta, readText, rename, serverFunctions, upload, writeFunctions };

package/dist/node/setup.d.mts

@@ -0,0 +1,102 @@
+import { n as AssetInfo, r as AssetType } from "../types-Bspm5Ylo.mjs";
+import { DevframeNodeContext, RpcStreamingChannel } from "devframe";
+//#region src/node/context.d.ts
+interface AssetsConfig {
+  /** Directory this devframe manages. */
+  dir: string;
+  /** Whether upload / rename / delete / mkdir are registered. */
+  write: boolean;
+  /** Extensions `upload` accepts, or `'*'` to accept any. */
+  uploadExtensions: readonly string[] | '*';
+  /**
+   * URL base the managed directory is served at. Normally the host
+   * (Vite / Nuxt / …) serves `public/` at `/`, so asset `publicPath`s are
+   * `joinURL(baseURL, path)` and the plugin serves nothing itself.
+   */
+  baseURL: string;
+  /** The upload streaming channel, created once in `setupAssets` when `write` is enabled. */
+  uploadChannel?: RpcStreamingChannel<Uint8Array>;
+}
+interface AssetsContext extends AssetsConfig {
+  /**
+   * Resolve a root-relative path to an absolute one, rejecting lexical
+   * escapes. Symlink-aware containment for reads and mutations lives in
+   * `node/paths` (`resolveAssetReadPath` / `assertAssetMutationPath`), which
+   * the RPC handlers call directly with {@link AssetsContext.dir}.
+   */
+  resolvePath: (relativePath: string) => string;
+}
+/**
+ * Record the managed directory and write policy for a context. Called from
+ * the devframe's `setup` before any RPC handler runs.
+ */
+declare function configureAssets(ctx: DevframeNodeContext, config: AssetsConfig): void;
+/**
+ * Per-`DevframeNodeContext` assets state. Each RPC function pulls its
+ * managed directory and path resolver from here instead of re-reading
+ * `configureAssets`'s config on every call.
+ */
+declare function getAssetsContext(ctx: DevframeNodeContext): AssetsContext;
+//#endregion
+//#region src/node/paths.d.ts
+/**
+ * Resolve a client-supplied, root-relative path against the managed
+ * directory, rejecting anything that would escape it lexically (`..`
+ * traversal, a rogue absolute path). The first guard every RPC handler runs;
+ * symlink-aware containment is layered on by {@link resolveAssetReadPath}
+ * (reads) and {@link assertAssetMutationPath} (mutations).
+ */
+declare function resolveAssetPath(root: string, relativePath: string): string;
+//#endregion
+//#region src/node/scanner.d.ts
+/** Classifies a path by extension, driving preview and icon choice. */
+declare function guessAssetType(path: string): AssetType;
+/** Recursively lists every file under `dir`, sorted alphabetically by path. */
+declare function scanAssets(dir: string, baseURL: string, includeFsPath?: boolean): Promise<AssetInfo[]>;
+//#endregion
+//#region src/node/setup.d.ts
+interface SetupAssetsOptions {
+  /** Directory this devframe manages. */
+  dir: string;
+  /** Whether upload / rename / delete / mkdir are registered. */
+  write: boolean;
+  /** Extensions `upload` accepts, or `'*'` to accept any. */
+  uploadExtensions: readonly string[] | '*';
+  /**
+   * URL base the managed directory is served at, the base every asset's
+   * `publicPath` is resolved against.
+   */
+  baseURL: string;
+  /**
+   * Whether this devframe should serve the managed directory's bytes
+   * itself. Left `false` when mounted into a host (Vite / Nuxt / …) that
+   * already serves `public/` at {@link baseURL}; set `true` only for the
+   * standalone CLI, which is its own host.
+   */
+  serveStatic: boolean;
+  /** Start the live file watcher (dev mode only). */
+  watch: boolean;
+}
+/**
+ * Register the assets RPC surface on a devframe node context: ensures the
+ * managed directory exists, registers the read RPCs (always) and write
+ * RPCs (when enabled), and starts a live file watcher in dev mode.
+ *
+ * Raw asset bytes (for `<img>`/`<video>`/download previews) are served by
+ * the **host** the plugin is attached to: Vite, Nuxt, or any framework
+ * already serves its `public/` dir at {@link SetupAssetsOptions.baseURL}.
+ * The plugin only serves them itself when `serveStatic` is set (the
+ * standalone CLI, which is its own host).
+ *
+ * Called from the definition's `setup(ctx)` and reusable by host adapters
+ * that wire their own context.
+ */
+declare function setupAssets(ctx: DevframeNodeContext, options: SetupAssetsOptions): Promise<void>;
+/**
+ * Stop the live file watcher started by {@link setupAssets}. Test harnesses
+ * wrap their dev-server `close()` with this (see `test/_utils.ts`), so a
+ * leaked chokidar watcher doesn't keep the process alive.
+ */
+declare function disposeAssetsWatcher(ctx: DevframeNodeContext): Promise<void>;
+//#endregion
+export { SetupAssetsOptions, configureAssets, disposeAssetsWatcher, getAssetsContext, guessAssetType, resolveAssetPath, scanAssets, setupAssets };

package/dist/node/setup.mjs

@@ -0,0 +1,3 @@
+import { n as setupAssets, t as disposeAssetsWatcher } from "../setup-BIpnpKP0.mjs";
+import { _ as getAssetsContext, d as scanAssets, g as configureAssets, u as guessAssetType, v as resolveAssetPath } from "../rpc-DG9tV_c_.mjs";
+export { configureAssets, disposeAssetsWatcher, getAssetsContext, guessAssetType, resolveAssetPath, scanAssets, setupAssets };

package/dist/{src-BpDib51Z.mjs → node-CYRI6r4z.mjs}

@@ -1,14 +1,14 @@
-import { n as setupAssets } from "./node-Diynhcd3.mjs";
+import { n as setupAssets } from "./setup-BIpnpKP0.mjs";
 import process from "node:process";
 import { defineDevframe } from "devframe";
 import { resolve } from "pathe";
 //#region package.json
 var name = "@devframes/plugin-assets";
-var version = "0.9.9";
+var version = "0.9.10";
 var description = "Devframe plugin for browsing, previewing, uploading, and managing static assets in a directory.";
 var homepage = "https://github.com/devframes/devframe#readme";
 //#endregion
-//#region src/types.ts
+//#region src/node/types.ts
 /** Mirrors Nuxt DevTools' own default upload allow-list. */
 const DEFAULT_ALLOWED_UPLOAD_EXTENSIONS = [
 	"png",
@@ -32,7 +32,7 @@ const DEFAULT_ALLOWED_UPLOAD_EXTENSIONS = [
 	"eot"
 ];
 //#endregion
-//#region src/index.ts
+//#region src/node/index.ts
 const remoteAssets = {
 	package: `${name}--assets`,
 	version

package/dist/{rpc-Pau8tZGm.mjs → rpc-DG9tV_c_.mjs}

@@ -1,13 +1,13 @@
 import { dirname, extname, join, normalize, resolve } from "pathe";
 import { createWriteStream } from "node:fs";
 import fsp from "node:fs/promises";
+import { defineDiagnostics } from "devframe/utils/nostics";
 import { createDefineWrapperWithContext } from "devframe/rpc";
 import { s } from "devframe/utils/simple-schema";
-import { defineDiagnostics } from "devframe/utils/nostics";
 import { glob } from "tinyglobby";
 import { joinURL } from "ufo";
 import { imageMeta } from "image-meta";
-//#region src/diagnostics.ts
+//#region src/node/diagnostics.ts
 /**
 * Uses the plugin's own `DP_ASSETS_` prefix per the built-in plugin
 * convention, keeping it collision-free with devframe core (`DF`) and the
@@ -137,7 +137,7 @@ function getAssetsContext(ctx) {
 	return built;
 }
 //#endregion
-//#region src/rpc/functions/upload.ts
+//#region src/node/rpc/functions/upload.ts
 const defineAssetsRpc$7 = createDefineWrapperWithContext();
 /** Streaming channel name, namespaced like every other RPC name in this plugin. */
 const UPLOAD_CHANNEL = "devframes:plugin:assets:upload";
@@ -311,7 +311,7 @@ async function scanAssets(dir, baseURL, includeFsPath = false) {
 	}))).filter((info) => info !== void 0).sort((a, b) => a.path.localeCompare(b.path));
 }
 //#endregion
-//#region src/rpc/functions/list.ts
+//#region src/node/rpc/functions/list.ts
 const defineAssetsRpc$4 = createDefineWrapperWithContext();
 const assetInfoSchema = s.object({
 	path: s.string(),
@@ -414,7 +414,7 @@ handler: (async (path) => {
 	}
 });
 //#endregion
-//#region src/rpc/functions/read-text.ts
+//#region src/node/rpc/functions/read-text.ts
 const defineAssetsRpc$1 = createDefineWrapperWithContext();
 const DEFAULT_LIMIT = 5e3;
 const readText = defineAssetsRpc$1({
@@ -489,7 +489,7 @@ handler: (async ({ path, newName }) => {
 	}
 });
 //#endregion
-//#region src/rpc/index.ts
+//#region src/node/rpc/index.ts
 /** Read-only RPC, always registered. */
 const readFunctions = [
 	list,

package/dist/{node-Diynhcd3.mjs → setup-BIpnpKP0.mjs}

@@ -1,10 +1,10 @@
-import { g as configureAssets, m as UPLOAD_CHANNEL, r as writeFunctions, t as readFunctions } from "./rpc-Pau8tZGm.mjs";
+import { g as configureAssets, m as UPLOAD_CHANNEL, r as writeFunctions, t as readFunctions } from "./rpc-DG9tV_c_.mjs";
 import process from "node:process";
 import { existsSync } from "node:fs";
 import fsp from "node:fs/promises";
 import { watch } from "chokidar";
 import { debounce } from "perfect-debounce";
-//#region src/constants.ts
+//#region src/node/constants.ts
 /** Broadcast whenever a file is added, removed, or changed under the managed directory. */
 const CHANGED_EVENT = "devframes:plugin:assets:changed";
 /** Preferred standalone CLI port. */
@@ -41,7 +41,7 @@ function watchAssetsDir(ctx, dir) {
 	};
 }
 //#endregion
-//#region src/node/index.ts
+//#region src/node/setup.ts
 const watchers = /* @__PURE__ */ new WeakMap();
 /**
 * Register the assets RPC surface on a devframe node context: ensures the

package/dist/{types-BKiX3RbA.d.mts → types-Bspm5Ylo.d.mts}

@@ -1,4 +1,4 @@
-//#region src/types.d.ts
+//#region src/node/types.d.ts
 /** Broad category guessed from a file's extension, driving preview/icon choice. */
 type AssetType = 'image' | 'font' | 'video' | 'audio' | 'text' | 'other';
 /** One file under the managed directory. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/plugin-assets",
   "type": "module",
-  "version": "0.9.9",
+  "version": "0.9.10",
   "description": "Devframe plugin for browsing, previewing, uploading, and managing static assets in a directory.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -21,14 +21,13 @@
   ],
   "sideEffects": false,
   "exports": {
-    ".": "./dist/index.mjs",
-    "./client": "./dist/client/index.mjs",
-    "./cli": "./dist/cli.mjs",
-    "./node": "./dist/node/index.mjs",
-    "./rpc": "./dist/rpc/index.mjs",
+    ".": "./dist/node/index.mjs",
+    "./cli": "./dist/node/cli.mjs",
+    "./node": "./dist/node/setup.mjs",
+    "./rpc": "./dist/node/rpc/index.mjs",
     "./package.json": "./package.json"
   },
-  "types": "./dist/index.d.mts",
+  "types": "./dist/node/index.d.mts",
   "bin": {
     "devframe-assets": "./bin.mjs"
   },
@@ -37,9 +36,9 @@
     "dist"
   ],
   "peerDependencies": {
-    "@devframes/plugin-assets--assets": "0.9.9",
-    "@devframes/service-shiki": "0.9.9",
-    "devframe": "0.9.9",
+    "@devframes/plugin-assets--assets": "0.9.10",
+    "@devframes/service-shiki": "0.9.10",
+    "devframe": "0.9.10",
     "vite": "^7.0.0 || ^8.0.0"
   },
   "peerDependenciesMeta": {
@@ -54,7 +53,7 @@
     }
   },
   "dependencies": {
-    "@devframes/service-open": "0.9.9",
+    "@devframes/service-open": "0.9.10",
     "cac": "^7.0.0",
     "chokidar": "^5.0.0",
     "image-meta": "^0.2.2",
@@ -65,9 +64,9 @@
   },
   "devDependencies": {
     "@antfu/design": "^0.4.0",
-    "@devframes/plugin-assets--assets": "0.9.9",
-    "@devframes/service-shiki": "0.9.9",
-    "@devframes/vite": "0.9.9",
+    "@devframes/plugin-assets--assets": "0.9.10",
+    "@devframes/service-shiki": "0.9.10",
+    "@devframes/vite": "0.9.10",
     "@iconify-json/ph": "^1.2.2",
     "@storybook/addon-a11y": "^10.5.10",
     "@storybook/addon-docs": "^10.5.10",
@@ -75,7 +74,7 @@
     "@types/node": "^26.4.0",
     "@vitejs/plugin-vue": "^6.0.8",
     "colorjs.io": "^0.7.1",
-    "devframe": "0.9.9",
+    "devframe": "0.9.10",
     "floating-vue": "^5.2.2",
     "h3": "^2.0.1-rc.29",
     "reka-ui": "^2.10.4",
@@ -87,9 +86,11 @@
     "vue": "^3.5.42"
   },
   "scripts": {
-    "build": "tsdown && vite build --config src/spa/vite.config.ts",
-    "dev": "vite --config src/spa/vite.config.ts --host 0.0.0.0",
+    "build": "tsdown && vite build --config app/vite.config.ts",
+    "build:app": "vite build --config app/vite.config.ts",
     "watch": "tsdown --watch",
+    "dev": "vite --config app/vite.config.ts --host",
+    "play": "pnpm run build && node playgrounds/server.mjs",
     "storybook": "storybook dev -p 6013 --host 0.0.0.0",
     "storybook:build": "storybook build",
     "test": "vitest run",

package/dist/client/index.d.mts

@@ -1,6 +0,0 @@
-import { i as CodeSnippet, n as AssetInfo, r as AssetType, t as AssetImageMeta } from "../types-BKiX3RbA.mjs";
-import { DevframeRpcClientOptions } from "devframe/client";
-//#region src/client/index.d.ts
-declare function connectAssets(options?: DevframeRpcClientOptions): Promise<import("devframe/client").DevframeRpcClient>;
-//#endregion
-export { type AssetImageMeta, type AssetInfo, type AssetType, type CodeSnippet, connectAssets };

package/dist/client/index.mjs

@@ -1,7 +0,0 @@
-import { connectDevframe } from "devframe/client";
-//#region src/client/index.ts
-function connectAssets(options) {
-	return connectDevframe(options);
-}
-//#endregion
-export { connectAssets };

package/dist/index.d.mts

@@ -1,79 +0,0 @@
-import { a as DEFAULT_ALLOWED_UPLOAD_EXTENSIONS, i as CodeSnippet, n as AssetInfo, r as AssetType, t as AssetImageMeta } from "./types-BKiX3RbA.mjs";
-import { DevframeDefinition } from "devframe";
-//#region src/index.d.ts
-interface AssetsDevframeOptions {
-  id?: string;
-  name?: string;
-  icon?: string;
-  /**
-   * Directory this devframe manages. Defaults to `<cwd>/public`, the
-   * conventional static-asset folder for Nuxt, Vite, and most static-site
-   * frameworks. Pass an absolute path, or one relative to the devframe's
-   * own `cwd`.
-   */
-  dir?: string;
-  /**
-   * URL base the **host** serves the managed directory at, used to build
-   * each asset's `publicPath`. Defaults to `/`; Vite, Nuxt, and most
-   * frameworks serve their `public/` folder at the site root. Set this to
-   * match a non-root deployment base (e.g. Nuxt's `app.baseURL`).
-   */
-  baseURL?: string;
-  /**
-   * Serve the managed directory's bytes from this devframe itself.
-   * Defaults to `false`: when mounted into a host (Vite/Nuxt/…) that host
-   * already serves `public/` at {@link baseURL}, so the plugin references
-   * those URLs instead of standing up its own route. The standalone CLI
-   * sets this to `true` (it is its own host), serving the directory under
-   * a dedicated base so it doesn't collide with the SPA at `/`.
-   */
-  serveStatic?: boolean;
-  basePath?: string;
-  distDir?: string;
-  /** Preferred standalone CLI port (default 9015). */
-  port?: number;
-  /**
-   * Enable upload, rename, delete, and folder creation from the UI.
-   * Enabled by default; set `false` (or pass `--read-only` on the
-   * standalone CLI) for a browse-only deployment.
-   */
-  write?: boolean;
-  /**
-   * Extensions `upload` accepts, or `'*'` to accept any file. Defaults to
-   * the same allow-list Nuxt DevTools ships.
-   */
-  uploadExtensions?: readonly string[] | '*';
-  /**
-   * Watch the managed directory in dev mode and push live listing updates.
-   * Enabled by default. Set `false` to skip the file watcher, useful when a
-   * host mounts the devframe in a short-lived or repeatedly-recreated
-   * context (tests, some SSR dev servers) where a background watcher isn't
-   * wanted.
-   */
-  watch?: boolean;
-  /**
-   * Require the trust handshake on the standalone server. Enabled by
-   * default, because this devframe can read, write, and delete real files.
-   */
-  auth?: boolean;
-  /**
-   * Register the `build` CLI subcommand. Disabled by default: a static
-   * export can only ever list file metadata from a baked snapshot; there
-   * is no live host serving the files, and every write action is inherently
-   * excluded from a static dump, so the command would produce a broken,
-   * write-less shell of the tool. Opt back in if that degraded export is
-   * still useful to you.
-   */
-  build?: boolean;
-}
-/**
- * Create the assets manager devframe, a framework-neutral port of Nuxt
- * DevTools' Assets tab. Mount it into any host via devframe's adapters, or
- * run it standalone with the bundled CLI (`devframe-assets`).
- *
- * @experimental This plugin is experimental and may change without a major
- * version bump until it stabilizes.
- */
-declare function createAssetsDevframe(options?: AssetsDevframeOptions): DevframeDefinition;
-//#endregion
-export { type AssetImageMeta, type AssetInfo, type AssetType, AssetsDevframeOptions, type CodeSnippet, DEFAULT_ALLOWED_UPLOAD_EXTENSIONS, createAssetsDevframe, createAssetsDevframe as default };

package/dist/index.mjs

@@ -1,2 +0,0 @@
-import { n as DEFAULT_ALLOWED_UPLOAD_EXTENSIONS, t as createAssetsDevframe } from "./src-BpDib51Z.mjs";
-export { DEFAULT_ALLOWED_UPLOAD_EXTENSIONS, createAssetsDevframe, createAssetsDevframe as default };