@devframes/plugin-assets 0.9.1 → 0.9.2

package/dist/cli.mjs

@@ -1,4 +1,4 @@
-import { t as createAssetsDevframe } from "./src-BTiBbgej.mjs";
+import { t as createAssetsDevframe } from "./src-77vCG4mn.mjs";
 import { createCac } from "devframe/adapters/cac";
 //#region src/cli.ts
 function createAssetsCli() {

package/dist/client/index.d.mts

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

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as DEFAULT_ALLOWED_UPLOAD_EXTENSIONS, i as CodeSnippet, n as AssetInfo, r as AssetType, t as AssetImageMeta } from "./types-DPDOYVFh.mjs";
+import { a as DEFAULT_ALLOWED_UPLOAD_EXTENSIONS, i as CodeSnippet, n as AssetInfo, r as AssetType, t as AssetImageMeta } from "./types-BrE0klRv.mjs";
 import { DevframeDefinition } from "devframe";
 //#region src/index.d.ts
 interface AssetsDevframeOptions {

package/dist/index.mjs

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

package/dist/node/index.d.mts

@@ -1,4 +1,4 @@
-import { n as AssetInfo, r as AssetType } from "../types-DPDOYVFh.mjs";
+import { n as AssetInfo, r as AssetType } from "../types-BrE0klRv.mjs";
 import { DevframeNodeContext, RpcStreamingChannel } from "devframe";
 //#region src/node/context.d.ts
 interface AssetsConfig {
@@ -46,7 +46,7 @@ declare function resolveAssetPath(root: string, relativePath: string): string;
 /** 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): Promise<AssetInfo[]>;
+declare function scanAssets(dir: string, baseURL: string, includeFsPath?: boolean): Promise<AssetInfo[]>;
 //#endregion
 //#region src/node/index.d.ts
 interface SetupAssetsOptions {

package/dist/node/index.mjs

@@ -1,3 +1,3 @@
-import { n as setupAssets, t as disposeAssetsWatcher } from "../node-DUay0toc.mjs";
-import { b as getAssetsContext, m as scanAssets, p as guessAssetType, x as resolveAssetPath, y as configureAssets } from "../rpc-BObgi2mL.mjs";
+import { n as setupAssets, t as disposeAssetsWatcher } from "../node-Cit_U9yi.mjs";
+import { _ as getAssetsContext, d as scanAssets, g as configureAssets, u as guessAssetType, v as resolveAssetPath } from "../rpc-BOraEthN.mjs";
 export { configureAssets, disposeAssetsWatcher, getAssetsContext, guessAssetType, resolveAssetPath, scanAssets, setupAssets };

package/dist/{node-DUay0toc.mjs → node-Cit_U9yi.mjs}

@@ -1,7 +1,7 @@
-import { _ as UPLOAD_CHANNEL, i as writeFunctions, n as readFunctions, t as alwaysFunctions, y as configureAssets } from "./rpc-BObgi2mL.mjs";
+import { g as configureAssets, m as UPLOAD_CHANNEL, r as writeFunctions, t as readFunctions } from "./rpc-BOraEthN.mjs";
+import process from "node:process";
 import { existsSync } from "node:fs";
 import fsp from "node:fs/promises";
-import process from "node:process";
 import { watch } from "chokidar";
 import { debounce } from "perfect-debounce";
 //#region src/constants.ts
@@ -60,7 +60,6 @@ async function setupAssets(ctx, options) {
 	});
 	if (options.serveStatic) ctx.views.hostStatic(options.baseURL, options.dir);
 	for (const fn of readFunctions) ctx.rpc.register(fn);
-	for (const fn of alwaysFunctions) ctx.rpc.register(fn);
 	if (options.write) for (const fn of writeFunctions) ctx.rpc.register(fn);
 	if (ctx.mode === "dev" && options.watch) watchers.set(ctx, watchAssetsDir(ctx, options.dir));
 }

package/dist/rpc/index.d.mts

@@ -101,12 +101,14 @@ declare const assetInfoSchema: import("devframe/utils/simple-schema").SimpleSche
   publicPath: string;
   size: number;
   mtime: number;
+  fsPath?: string | undefined;
 }, {
   path: string;
   type: "image" | "font" | "video" | "audio" | "text" | "other";
   publicPath: string;
   size: number;
   mtime: number;
+  fsPath?: string | undefined;
 }>;
 declare const list: {
   name: "devframes:plugin:assets:list";
@@ -119,12 +121,14 @@ declare const list: {
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[], {
     path: string;
     type: "image" | "font" | "video" | "audio" | "text" | "other";
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[]>;
   jsonSerializable?: boolean;
   agent?: import("devframe").RpcFunctionAgentOptions;
@@ -134,6 +138,7 @@ declare const list: {
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[]>>>) | undefined;
   handler?: (() => import("devframe/rpc").Thenable<{
     path: string;
@@ -141,6 +146,7 @@ declare const list: {
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[]>) | undefined;
   dump?: import("devframe/rpc").RpcDump<[], import("devframe/rpc").Thenable<{
     path: string;
@@ -148,6 +154,7 @@ declare const list: {
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[]>, DevframeNodeContext> | undefined;
   snapshot?: boolean;
   __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[], import("devframe/rpc").Thenable<{
@@ -156,6 +163,7 @@ declare const list: {
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[]>>>> | undefined;
   __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[], import("devframe/rpc").Thenable<{
     path: string;
@@ -163,6 +171,7 @@ declare const list: {
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[]>>> | undefined;
 };
 //#endregion
@@ -197,29 +206,6 @@ declare const mkdir: {
   }], import("devframe/rpc").Thenable<void>>> | undefined;
 };
 //#endregion
-//#region src/rpc/functions/open-in-editor.d.ts
-/**
- * Reuses devframe's `launchEditor` utility (the same one backing the core
- * `devframe:open-in-editor` recipe) but resolves the path against the
- * managed directory first, so the client only ever sends a root-relative
- * path — never the server's absolute filesystem layout.
- */
-declare const openInEditor: {
-  name: "devframes:plugin:assets:open-in-editor";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args: readonly [import("devframe/utils/simple-schema").SimpleSchema<string, string>];
-  returns: import("devframe/utils/simple-schema").SimpleSchema<void, void>;
-  jsonSerializable?: boolean;
-  agent?: import("devframe").RpcFunctionAgentOptions;
-  setup?: ((context: DevframeNodeContext) => import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string], import("devframe/rpc").Thenable<void>>>) | undefined;
-  handler?: ((args_0: string) => import("devframe/rpc").Thenable<void>) | undefined;
-  dump?: import("devframe/rpc").RpcDump<[string], import("devframe/rpc").Thenable<void>, DevframeNodeContext> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string], import("devframe/rpc").Thenable<void>>>> | undefined;
-  __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string], import("devframe/rpc").Thenable<void>>> | undefined;
-};
-//#endregion
 //#region src/rpc/functions/read-image-meta.d.ts
 declare const readImageMeta: {
   name: "devframes:plugin:assets:read-image-meta";
@@ -311,12 +297,14 @@ declare const rename: {
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }, {
     path: string;
     type: "image" | "font" | "video" | "audio" | "text" | "other";
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }>;
   jsonSerializable?: boolean;
   agent?: import("devframe").RpcFunctionAgentOptions;
@@ -329,6 +317,7 @@ declare const rename: {
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }>>>) | undefined;
   handler?: ((args_0: {
     path: string;
@@ -339,6 +328,7 @@ declare const rename: {
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }>) | undefined;
   dump?: import("devframe/rpc").RpcDump<[{
     path: string;
@@ -349,6 +339,7 @@ declare const rename: {
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }>, DevframeNodeContext> | undefined;
   snapshot?: boolean;
   __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[{
@@ -360,6 +351,7 @@ declare const rename: {
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }>>>> | undefined;
   __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[{
     path: string;
@@ -370,32 +362,10 @@ declare const rename: {
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }>>> | undefined;
 };
 //#endregion
-//#region src/rpc/functions/reveal-in-folder.d.ts
-/**
- * Reuses devframe's `open` utility (the same one backing the core
- * `devframe:open-in-finder` recipe), opening the asset's containing folder
- * so it's revealed in the OS file manager rather than launched with its
- * default app (which `download` already covers).
- */
-declare const revealInFolder: {
-  name: "devframes:plugin:assets:reveal-in-folder";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args: readonly [import("devframe/utils/simple-schema").SimpleSchema<string, string>];
-  returns: import("devframe/utils/simple-schema").SimpleSchema<void, void>;
-  jsonSerializable?: boolean;
-  agent?: import("devframe").RpcFunctionAgentOptions;
-  setup?: ((context: DevframeNodeContext) => import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string], import("devframe/rpc").Thenable<void>>>) | undefined;
-  handler?: ((args_0: string) => import("devframe/rpc").Thenable<void>) | undefined;
-  dump?: import("devframe/rpc").RpcDump<[string], import("devframe/rpc").Thenable<void>, DevframeNodeContext> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string], import("devframe/rpc").Thenable<void>>>> | undefined;
-  __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string], import("devframe/rpc").Thenable<void>>> | undefined;
-};
-//#endregion
 //#region src/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";
@@ -461,12 +431,14 @@ declare const readFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[], {
     path: string;
     type: "image" | "font" | "video" | "audio" | "text" | "other";
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[]>;
   jsonSerializable?: boolean;
   agent?: import("devframe").RpcFunctionAgentOptions;
@@ -476,6 +448,7 @@ declare const readFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[]>>>) | undefined;
   handler?: (() => import("devframe/rpc").Thenable<{
     path: string;
@@ -483,6 +456,7 @@ declare const readFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[]>) | undefined;
   dump?: import("devframe/rpc").RpcDump<[], import("devframe/rpc").Thenable<{
     path: string;
@@ -490,6 +464,7 @@ declare const readFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[]>, import("devframe").DevframeNodeContext> | undefined;
   snapshot?: boolean;
   __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[], import("devframe/rpc").Thenable<{
@@ -498,6 +473,7 @@ declare const readFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[]>>>> | undefined;
   __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[], import("devframe/rpc").Thenable<{
     path: string;
@@ -505,6 +481,7 @@ declare const readFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[]>>> | undefined;
 }, {
   name: "devframes:plugin:assets:read-image-meta";
@@ -598,39 +575,6 @@ declare const readFunctions: readonly [{
     uploadExtensions: string[] | "*";
   }>>> | undefined;
 }];
-/**
- * Informational actions — launch external apps, never touch the managed
- * directory's contents. Always registered regardless of `write`.
- */
-declare const alwaysFunctions: readonly [{
-  name: "devframes:plugin:assets:open-in-editor";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args: readonly [import("devframe/utils/simple-schema").SimpleSchema<string, string>];
-  returns: import("devframe/utils/simple-schema").SimpleSchema<void, void>;
-  jsonSerializable?: boolean;
-  agent?: import("devframe").RpcFunctionAgentOptions;
-  setup?: ((context: import("devframe").DevframeNodeContext) => import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string], import("devframe/rpc").Thenable<void>>>) | undefined;
-  handler?: ((args_0: string) => import("devframe/rpc").Thenable<void>) | undefined;
-  dump?: import("devframe/rpc").RpcDump<[string], import("devframe/rpc").Thenable<void>, import("devframe").DevframeNodeContext> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string], import("devframe/rpc").Thenable<void>>>> | undefined;
-  __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string], import("devframe/rpc").Thenable<void>>> | undefined;
-}, {
-  name: "devframes:plugin:assets:reveal-in-folder";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args: readonly [import("devframe/utils/simple-schema").SimpleSchema<string, string>];
-  returns: import("devframe/utils/simple-schema").SimpleSchema<void, void>;
-  jsonSerializable?: boolean;
-  agent?: import("devframe").RpcFunctionAgentOptions;
-  setup?: ((context: import("devframe").DevframeNodeContext) => import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string], import("devframe/rpc").Thenable<void>>>) | undefined;
-  handler?: ((args_0: string) => import("devframe/rpc").Thenable<void>) | undefined;
-  dump?: import("devframe/rpc").RpcDump<[string], import("devframe/rpc").Thenable<void>, import("devframe").DevframeNodeContext> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string], import("devframe/rpc").Thenable<void>>>> | undefined;
-  __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string], import("devframe/rpc").Thenable<void>>> | undefined;
-}];
 /** Mutating RPC — registered only when write actions are enabled. */
 declare const writeFunctions: readonly [{
   name: "devframes:plugin:assets:upload";
@@ -691,12 +635,14 @@ declare const writeFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }, {
     path: string;
     type: "image" | "font" | "video" | "audio" | "text" | "other";
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }>;
   jsonSerializable?: boolean;
   agent?: import("devframe").RpcFunctionAgentOptions;
@@ -709,6 +655,7 @@ declare const writeFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }>>>) | undefined;
   handler?: ((args_0: {
     path: string;
@@ -719,6 +666,7 @@ declare const writeFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }>) | undefined;
   dump?: import("devframe/rpc").RpcDump<[{
     path: string;
@@ -729,6 +677,7 @@ declare const writeFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }>, import("devframe").DevframeNodeContext> | undefined;
   snapshot?: boolean;
   __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[{
@@ -740,6 +689,7 @@ declare const writeFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }>>>> | undefined;
   __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[{
     path: string;
@@ -750,6 +700,7 @@ declare const writeFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }>>> | undefined;
 }, {
   name: "devframes:plugin:assets:delete";
@@ -833,12 +784,14 @@ declare const serverFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[], {
     path: string;
     type: "image" | "font" | "video" | "audio" | "text" | "other";
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[]>;
   jsonSerializable?: boolean;
   agent?: import("devframe").RpcFunctionAgentOptions;
@@ -848,6 +801,7 @@ declare const serverFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[]>>>) | undefined;
   handler?: (() => import("devframe/rpc").Thenable<{
     path: string;
@@ -855,6 +809,7 @@ declare const serverFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[]>) | undefined;
   dump?: import("devframe/rpc").RpcDump<[], import("devframe/rpc").Thenable<{
     path: string;
@@ -862,6 +817,7 @@ declare const serverFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[]>, import("devframe").DevframeNodeContext> | undefined;
   snapshot?: boolean;
   __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[], import("devframe/rpc").Thenable<{
@@ -870,6 +826,7 @@ declare const serverFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[]>>>> | undefined;
   __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[], import("devframe/rpc").Thenable<{
     path: string;
@@ -877,6 +834,7 @@ declare const serverFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }[]>>> | undefined;
 }, {
   name: "devframes:plugin:assets:read-image-meta";
@@ -969,34 +927,6 @@ declare const serverFunctions: readonly [{
     write: boolean;
     uploadExtensions: string[] | "*";
   }>>> | undefined;
-}, {
-  name: "devframes:plugin:assets:open-in-editor";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args: readonly [import("devframe/utils/simple-schema").SimpleSchema<string, string>];
-  returns: import("devframe/utils/simple-schema").SimpleSchema<void, void>;
-  jsonSerializable?: boolean;
-  agent?: import("devframe").RpcFunctionAgentOptions;
-  setup?: ((context: import("devframe").DevframeNodeContext) => import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string], import("devframe/rpc").Thenable<void>>>) | undefined;
-  handler?: ((args_0: string) => import("devframe/rpc").Thenable<void>) | undefined;
-  dump?: import("devframe/rpc").RpcDump<[string], import("devframe/rpc").Thenable<void>, import("devframe").DevframeNodeContext> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string], import("devframe/rpc").Thenable<void>>>> | undefined;
-  __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string], import("devframe/rpc").Thenable<void>>> | undefined;
-}, {
-  name: "devframes:plugin:assets:reveal-in-folder";
-  type?: "action" | undefined;
-  cacheable?: boolean;
-  args: readonly [import("devframe/utils/simple-schema").SimpleSchema<string, string>];
-  returns: import("devframe/utils/simple-schema").SimpleSchema<void, void>;
-  jsonSerializable?: boolean;
-  agent?: import("devframe").RpcFunctionAgentOptions;
-  setup?: ((context: import("devframe").DevframeNodeContext) => import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string], import("devframe/rpc").Thenable<void>>>) | undefined;
-  handler?: ((args_0: string) => import("devframe/rpc").Thenable<void>) | undefined;
-  dump?: import("devframe/rpc").RpcDump<[string], import("devframe/rpc").Thenable<void>, import("devframe").DevframeNodeContext> | undefined;
-  snapshot?: boolean;
-  __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string], import("devframe/rpc").Thenable<void>>>> | undefined;
-  __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[string], import("devframe/rpc").Thenable<void>>> | undefined;
 }, {
   name: "devframes:plugin:assets:upload";
   type?: "action" | undefined;
@@ -1056,12 +986,14 @@ declare const serverFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }, {
     path: string;
     type: "image" | "font" | "video" | "audio" | "text" | "other";
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }>;
   jsonSerializable?: boolean;
   agent?: import("devframe").RpcFunctionAgentOptions;
@@ -1074,6 +1006,7 @@ declare const serverFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }>>>) | undefined;
   handler?: ((args_0: {
     path: string;
@@ -1084,6 +1017,7 @@ declare const serverFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }>) | undefined;
   dump?: import("devframe/rpc").RpcDump<[{
     path: string;
@@ -1094,6 +1028,7 @@ declare const serverFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }>, import("devframe").DevframeNodeContext> | undefined;
   snapshot?: boolean;
   __cache?: WeakMap<object, import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[{
@@ -1105,6 +1040,7 @@ declare const serverFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }>>>> | undefined;
   __promise?: import("devframe/rpc").Thenable<import("devframe/rpc").RpcFunctionSetupResult<[{
     path: string;
@@ -1115,6 +1051,7 @@ declare const serverFunctions: readonly [{
     publicPath: string;
     size: number;
     mtime: number;
+    fsPath?: string | undefined;
   }>>> | undefined;
 }, {
   name: "devframes:plugin:assets:delete";
@@ -1191,4 +1128,4 @@ declare module 'devframe' {
   interface DevframeRpcServerFunctions extends RpcDefinitionsToFunctions<typeof serverFunctions> {}
 }
 //#endregion
-export { type AssetsCapabilities, type RenameArgs, UPLOAD_CHANNEL, alwaysFunctions, assetInfoSchema, capabilities, deleteAssets, list, mkdir, openInEditor, readFunctions, readImageMeta, readText, rename, revealInFolder, serverFunctions, upload, writeFunctions };
+export { type AssetsCapabilities, type RenameArgs, UPLOAD_CHANNEL, assetInfoSchema, capabilities, deleteAssets, list, mkdir, readFunctions, readImageMeta, readText, rename, serverFunctions, upload, writeFunctions };

package/dist/rpc/index.mjs

@@ -1,2 +1,2 @@
-import { _ as UPLOAD_CHANNEL, a as revealInFolder, c as readImageMeta, d as assetInfoSchema, f as list, g as capabilities, h as deleteAssets, i as writeFunctions, l as openInEditor, n as readFunctions, o as rename, r as serverFunctions, s as readText, t as alwaysFunctions, u as mkdir, v as upload } from "../rpc-BObgi2mL.mjs";
-export { UPLOAD_CHANNEL, alwaysFunctions, assetInfoSchema, capabilities, deleteAssets, list, mkdir, openInEditor, readFunctions, readImageMeta, readText, rename, revealInFolder, serverFunctions, upload, writeFunctions };
+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-BOraEthN.mjs";
+export { UPLOAD_CHANNEL, assetInfoSchema, capabilities, deleteAssets, list, mkdir, readFunctions, readImageMeta, readText, rename, serverFunctions, upload, writeFunctions };

package/dist/{rpc-BObgi2mL.mjs → rpc-BOraEthN.mjs}

@@ -6,9 +6,7 @@ import { s } from "devframe/utils/simple-schema";
 import { defineDiagnostics } from "devframe/utils/nostics";
 import { glob } from "tinyglobby";
 import { joinURL } from "ufo";
-import { launchEditor } from "devframe/utils/launch-editor";
 import { imageMeta } from "image-meta";
-import { open } from "devframe/utils/open";
 //#region src/diagnostics.ts
 const diagnostics = defineDiagnostics({
 	docsBase: "https://devfra.me/errors",
@@ -93,7 +91,7 @@ function getAssetsContext(ctx) {
 }
 //#endregion
 //#region src/rpc/functions/upload.ts
-const defineAssetsRpc$9 = createDefineWrapperWithContext();
+const defineAssetsRpc$7 = createDefineWrapperWithContext();
 /** Streaming channel name, namespaced like every other RPC name in this plugin. */
 const UPLOAD_CHANNEL = "devframes:plugin:assets:upload";
 function isExtensionAllowed(path, allowed) {
@@ -106,7 +104,7 @@ function isExtensionAllowed(path, allowed) {
 * the `upload` channel opened in `setupAssets` — see the client-side
 * `useUpload` hook for the matching `rpc.streaming.upload()` call.
 */
-const upload = defineAssetsRpc$9({
+const upload = defineAssetsRpc$7({
 	name: "devframes:plugin:assets:upload",
 	type: "action",
 	jsonSerializable: true,
@@ -226,19 +224,24 @@ function toPublicPath(baseURL, posixPath) {
 	const encoded = posixPath.split("/").map(encodeURIComponent).join("/");
 	return joinURL(baseURL, encoded);
 }
-/** Builds an {@link AssetInfo} from an already-resolved `fs.Stats`. */
-function statToAssetInfo(dir, baseURL, relPath, stat) {
+/**
+* Builds an {@link AssetInfo} from an already-resolved `fs.Stats`. Pass
+* `includeFsPath` (dev mode only) to attach the absolute `fsPath` the client
+* hands to the open wire service.
+*/
+function statToAssetInfo(dir, baseURL, relPath, stat, includeFsPath = false) {
 	const posixPath = relPath.replace(/\\/g, "/");
 	return {
 		path: posixPath,
 		type: guessAssetType(posixPath),
 		publicPath: toPublicPath(baseURL, posixPath),
 		size: stat.size,
-		mtime: stat.mtimeMs
+		mtime: stat.mtimeMs,
+		...includeFsPath ? { fsPath: join(dir, relPath) } : {}
 	};
 }
 /** Recursively lists every file under `dir`, sorted alphabetically by path. */
-async function scanAssets(dir, baseURL) {
+async function scanAssets(dir, baseURL, includeFsPath = false) {
 	const files = await glob(["**/*"], {
 		cwd: dir,
 		onlyFiles: true,
@@ -246,7 +249,7 @@ async function scanAssets(dir, baseURL) {
 	});
 	return (await Promise.all(files.map(async (relPath) => {
 		try {
-			return statToAssetInfo(dir, baseURL, relPath, await fsp.lstat(join(dir, relPath)));
+			return statToAssetInfo(dir, baseURL, relPath, await fsp.lstat(join(dir, relPath)), includeFsPath);
 		} catch {
 			return;
 		}
@@ -254,7 +257,7 @@ async function scanAssets(dir, baseURL) {
 }
 //#endregion
 //#region src/rpc/functions/list.ts
-const defineAssetsRpc$6 = createDefineWrapperWithContext();
+const defineAssetsRpc$4 = createDefineWrapperWithContext();
 const assetInfoSchema = s.object({
 	path: s.string(),
 	type: s.picklist([
@@ -267,9 +270,10 @@ const assetInfoSchema = s.object({
 	]),
 	publicPath: s.string(),
 	size: s.number(),
-	mtime: s.number()
+	mtime: s.number(),
+	fsPath: s.optional(s.string())
 });
-const list = defineAssetsRpc$6({
+const list = defineAssetsRpc$4({
 	name: "devframes:plugin:assets:list",
 	type: "query",
 	snapshot: true,
@@ -284,7 +288,7 @@ const list = defineAssetsRpc$6({
 	},
 	setup: (ctx) => {
 		const assets = getAssetsContext(ctx);
-		return { handler: (async () => scanAssets(assets.dir, assets.baseURL)) };
+		return { handler: (async () => scanAssets(assets.dir, assets.baseURL, ctx.mode === "dev")) };
 	}
 });
 const mkdir = createDefineWrapperWithContext()({
@@ -309,31 +313,6 @@ const mkdir = createDefineWrapperWithContext()({
 		}) };
 	}
 });
-/**
-* Reuses devframe's `launchEditor` utility (the same one backing the core
-* `devframe:open-in-editor` recipe) but resolves the path against the
-* managed directory first, so the client only ever sends a root-relative
-* path — never the server's absolute filesystem layout.
-*/
-const openInEditor = createDefineWrapperWithContext()({
-	name: "devframes:plugin:assets:open-in-editor",
-	type: "action",
-	jsonSerializable: true,
-	args: [s.string()],
-	returns: s.void(),
-	agent: {
-		title: "Open an asset in the editor",
-		description: "Open an asset in the user's configured editor.",
-		safety: "action",
-		tags: ["assets"]
-	},
-	setup: (ctx) => {
-		const assets = getAssetsContext(ctx);
-		return { handler: (async (path) => {
-			launchEditor(assets.resolvePath(path));
-		}) };
-	}
-});
 const readImageMeta = createDefineWrapperWithContext()({
 	name: "devframes:plugin:assets:read-image-meta",
 	type: "query",
@@ -369,9 +348,9 @@ const readImageMeta = createDefineWrapperWithContext()({
 });
 //#endregion
 //#region src/rpc/functions/read-text.ts
-const defineAssetsRpc$2 = createDefineWrapperWithContext();
+const defineAssetsRpc$1 = createDefineWrapperWithContext();
 const DEFAULT_LIMIT = 5e3;
-const readText = defineAssetsRpc$2({
+const readText = defineAssetsRpc$1({
 	name: "devframes:plugin:assets:read-text",
 	type: "query",
 	jsonSerializable: true,
@@ -421,7 +400,7 @@ const rename = createDefineWrapperWithContext()({
 			const to = assets.resolvePath(nextRelPath);
 			if (from === to) {
 				const stat = await fsp.lstat(from);
-				return statToAssetInfo(assets.dir, assets.baseURL, path, stat);
+				return statToAssetInfo(assets.dir, assets.baseURL, path, stat, true);
 			}
 			if (await fsp.access(to).then(() => true).catch(() => false)) throw diagnostics.DP_ASSETS_0003({ path: nextRelPath });
 			await fsp.mkdir(dirname(to), { recursive: true });
@@ -432,32 +411,7 @@ const rename = createDefineWrapperWithContext()({
 				throw error;
 			}
 			const stat = await fsp.lstat(to);
-			return statToAssetInfo(assets.dir, assets.baseURL, nextRelPath, stat);
-		}) };
-	}
-});
-/**
-* Reuses devframe's `open` utility (the same one backing the core
-* `devframe:open-in-finder` recipe), opening the asset's containing folder
-* so it's revealed in the OS file manager rather than launched with its
-* default app (which `download` already covers).
-*/
-const revealInFolder = createDefineWrapperWithContext()({
-	name: "devframes:plugin:assets:reveal-in-folder",
-	type: "action",
-	jsonSerializable: true,
-	args: [s.string()],
-	returns: s.void(),
-	agent: {
-		title: "Reveal an asset in the file manager",
-		description: "Open the OS file manager at the asset's containing folder.",
-		safety: "action",
-		tags: ["assets"]
-	},
-	setup: (ctx) => {
-		const assets = getAssetsContext(ctx);
-		return { handler: (async (path) => {
-			await open(dirname(assets.resolvePath(path)));
+			return statToAssetInfo(assets.dir, assets.baseURL, nextRelPath, stat, true);
 		}) };
 	}
 });
@@ -470,11 +424,6 @@ const readFunctions = [
 	readText,
 	capabilities
 ];
-/**
-* Informational actions — launch external apps, never touch the managed
-* directory's contents. Always registered regardless of `write`.
-*/
-const alwaysFunctions = [openInEditor, revealInFolder];
 /** Mutating RPC — registered only when write actions are enabled. */
 const writeFunctions = [
 	upload,
@@ -482,10 +431,6 @@ const writeFunctions = [
 	deleteAssets,
 	mkdir
 ];
-const serverFunctions = [
-	...readFunctions,
-	...alwaysFunctions,
-	...writeFunctions
-];
+const serverFunctions = [...readFunctions, ...writeFunctions];
 //#endregion
-export { UPLOAD_CHANNEL as _, revealInFolder as a, getAssetsContext as b, readImageMeta as c, assetInfoSchema as d, list as f, capabilities as g, deleteAssets as h, writeFunctions as i, openInEditor as l, scanAssets as m, readFunctions as n, rename as o, guessAssetType as p, serverFunctions as r, readText as s, alwaysFunctions as t, mkdir as u, upload as v, resolveAssetPath as x, configureAssets as y };
+export { getAssetsContext as _, readText as a, assetInfoSchema as c, scanAssets as d, deleteAssets as f, configureAssets as g, upload as h, rename as i, list as l, UPLOAD_CHANNEL as m, serverFunctions as n, readImageMeta as o, capabilities as p, writeFunctions as r, mkdir as s, readFunctions as t, guessAssetType as u, resolveAssetPath as v };

package/dist/{src-BTiBbgej.mjs → src-77vCG4mn.mjs}

@@ -1,9 +1,10 @@
-import { n as setupAssets } from "./node-DUay0toc.mjs";
+import { n as setupAssets } from "./node-Cit_U9yi.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.1";
+var version = "0.9.2";
 var description = "Devframe plugin for browsing, previewing, uploading, and managing static assets in a directory.";
 var homepage = "https://github.com/devframes/devframe#readme";
 //#endregion
@@ -34,8 +35,7 @@ const DEFAULT_ALLOWED_UPLOAD_EXTENSIONS = [
 //#region src/index.ts
 const remoteAssets = {
 	package: `${name}--assets`,
-	version,
-	resolveFrom: import.meta.url
+	version
 };
 const DEFAULT_ID = "devframes_plugin_assets";
 /**
@@ -48,6 +48,7 @@ const DEFAULT_ID = "devframes_plugin_assets";
 */
 function createAssetsDevframe(options = {}) {
 	const id = options.id ?? DEFAULT_ID;
+	const dir = options.dir ? resolve(process.cwd(), options.dir) : resolve(process.cwd(), "public");
 	const distDir = options.distDir ?? remoteAssets;
 	const write = options.write ?? true;
 	const serveStatic = options.serveStatic ?? false;
@@ -57,6 +58,7 @@ function createAssetsDevframe(options = {}) {
 		name: options.name ?? "Assets",
 		version,
 		packageName: name,
+		importMetaUrl: import.meta.url,
 		homepage,
 		description,
 		icon: options.icon ?? "ph:image-square-duotone",
@@ -72,9 +74,12 @@ function createAssetsDevframe(options = {}) {
 			}
 		},
 		dock: { category: "~builtin" },
+		services: [{
+			package: "@devframes/service-open",
+			options: { roots: [dir] }
+		}, { package: "@devframes/service-shiki" }],
 		async setup(ctx, info) {
 			const readOnlyFlag = info?.flags?.readOnly === true;
-			const dir = options.dir ? resolve(ctx.cwd, options.dir) : resolve(ctx.cwd, "public");
 			await setupAssets(ctx, {
 				dir,
 				write: readOnlyFlag ? false : write,

package/dist/{types-DPDOYVFh.d.mts → types-BrE0klRv.d.mts}

@@ -11,6 +11,12 @@ interface AssetInfo {
   size: number;
   /** `mtimeMs` — milliseconds since epoch. */
   mtime: number;
+  /**
+   * Absolute filesystem path — populated in `dev` mode only (never baked
+   * into a static build's dump), so the client can hand it to the
+   * `@devframes/service-open` wire service for open-in-editor / reveal.
+   */
+  fsPath?: string;
 }
 interface AssetImageMeta {
   width?: number;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/plugin-assets",
   "type": "module",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "description": "Devframe plugin for browsing, previewing, uploading, and managing static assets in a directory.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -38,13 +38,17 @@
   ],
   "peerDependencies": {
     "vite": "^7.0.0 || ^8.0.0",
-    "@devframes/plugin-assets--assets": "0.9.1",
-    "devframe": "0.9.1"
+    "@devframes/service-shiki": "0.9.2",
+    "devframe": "0.9.2",
+    "@devframes/plugin-assets--assets": "0.9.2"
   },
   "peerDependenciesMeta": {
     "@devframes/plugin-assets--assets": {
       "optional": true
     },
+    "@devframes/service-shiki": {
+      "optional": true
+    },
     "vite": {
       "optional": true
     }
@@ -56,29 +60,31 @@
     "pathe": "^2.0.3",
     "perfect-debounce": "^2.1.0",
     "tinyglobby": "^0.2.17",
-    "ufo": "^1.6.4"
+    "ufo": "^1.6.4",
+    "@devframes/service-open": "0.9.2"
   },
   "devDependencies": {
     "@antfu/design": "^0.3.4",
     "@iconify-json/ph": "^1.2.2",
-    "@storybook/addon-a11y": "^10.5.7",
-    "@storybook/addon-docs": "^10.5.7",
-    "@storybook/vue3-vite": "^10.5.7",
+    "@storybook/addon-a11y": "^10.5.8",
+    "@storybook/addon-docs": "^10.5.8",
+    "@storybook/vue3-vite": "^10.5.8",
     "@types/node": "^26.2.0",
     "@vitejs/plugin-vue": "^6.0.8",
     "colorjs.io": "^0.7.1",
     "floating-vue": "^5.2.2",
     "h3": "^2.0.1-rc.26",
     "reka-ui": "^2.10.3",
-    "storybook": "^10.5.7",
+    "storybook": "^10.5.8",
     "tsdown": "^0.22.14",
     "unocss": "^66.7.5",
     "vite": "^8.2.1",
     "vitest": "^4.1.10",
     "vue": "^3.5.41",
-    "@devframes/vite": "0.9.1",
-    "devframe": "0.9.1",
-    "@devframes/plugin-assets--assets": "0.9.1"
+    "@devframes/plugin-assets--assets": "0.9.2",
+    "@devframes/service-shiki": "0.9.2",
+    "@devframes/vite": "0.9.2",
+    "devframe": "0.9.2"
   },
   "scripts": {
     "build": "tsdown && vite build --config src/spa/vite.config.ts",