@deepseek-ai/dsh-package-manifest 0.1.6-alpha.2 → 0.1.7-alpha.2

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/util/package-manifest/README.md
-README.md: 36e25a7bee7ce6cc31133e0c815c0dc607c58de7
-README.zh.md: d46ae346c2a654a0bfbfb4e7e7b2ba317f85a762
+README.md: 7c4c4935412ca481dc5db2f9c182abf471faf269
+README.zh.md: 58a150ae32a7129c1f213f9268869b99ada99655

package/README.md

@@ -43,7 +43,7 @@ const manifest: DshPackageManifest = {
 }
 ```
 
-`DshPackageManifest` describes the package.json fields used by DSH, with required `name` and `version`; it is not an exhaustive npm schema. Local profile readers use `Partial<DshPackageManifest>` because profiles need no published version. `DshManifest` describes only public author fields under `dsh`. TypeScript checks the example and erases `import type`; these interfaces do not parse JSON or write a file.
+`DshPackageManifest` describes the package.json fields used by DSH, with required `name` and `version`; it is not an exhaustive npm schema. Local profile readers use `Partial<DshPackageManifest>` because profiles need no published version. `DshManifest` describes only public author fields under `dsh`. `DshBundleManifest.patch` is one patch file path or an ordered list of them, each relative to the package root; the launcher applies a list in order as one bundle layer. TypeScript checks the example and erases `import type`; these interfaces do not parse JSON or write a file.
 
 The following metadata fields are optional. Omitting them leaves the format version or compatible host versions undeclared; readers do not infer defaults.
 
@@ -52,6 +52,8 @@ The following metadata fields are optional. Omitting them leaves the format vers
 | `dsh.manifestVersion` | Manifest format identifier; the declared format is `1`, independent of the npm package version and Session format version. |
 | `engines.dsh` | Author-declared compatible DSH versions as a SemVer range, including exact prerelease versions. This field sits beside `engines.node` and `engines.npm`; an engines object may omit `dsh`. |
 
+`LocalizedText` carries literal text or a language map with a required English fallback. `PluginLocalizedMeta` carries optional display title, description, an image data URL resolved from `package.json.icon`, and metadata diagnostics for installed plugins. [App boot](../../boot/app-boot/README.md) reads these values; this package only supplies their types.
+
 Public composition declarations are defined in [`src/types.ts`](src/types.ts). Internal `configTrees`, `sessionFormatMigration`, and generated `moduleFallback` metadata remain owned by their image-packer, catalog, and launcher readers; the public types do not expose them.
 
 -----

package/README.zh.md

@@ -43,7 +43,7 @@ const manifest: DshPackageManifest = {
 }
 ```
 
-`DshPackageManifest` 描述 DSH 使用的 package.json 字段，其中 `name` 和 `version` 必填；它不是完整的 npm schema（模式）。本地 profile 读取方使用 `Partial<DshPackageManifest>`，因为 profile 无需发布版本。`DshManifest` 仅描述 `dsh` 下的公共作者字段。TypeScript 检查示例并删除 `import type`；这些接口不解析 JSON，也不写入文件。
+`DshPackageManifest` 描述 DSH 使用的 package.json 字段，其中 `name` 和 `version` 必填；它不是完整的 npm schema（模式）。本地 profile 读取方使用 `Partial<DshPackageManifest>`，因为 profile 无需发布版本。`DshManifest` 仅描述 `dsh` 下的公共作者字段。`DshBundleManifest.patch` 是一个 patch 文件路径，或一个有序的路径列表，均相对于包根目录；launcher 按列表顺序把它们作为同一个组合包层应用。TypeScript 检查示例并删除 `import type`；这些接口不解析 JSON，也不写入文件。
 
 以下元数据字段均可选。省略时，格式版本或兼容的宿主版本保持未声明状态；读取方不推断默认值。
 
@@ -52,6 +52,8 @@ const manifest: DshPackageManifest = {
 | `dsh.manifestVersion` | manifest（元数据清单）格式标识；声明的格式为 `1`，独立于 npm 包版本和 Session 格式版本。 |
 | `engines.dsh` | 作者声明的兼容 DSH 版本，使用 SemVer 范围，也可填写精确的预发布版本。此字段与 `engines.node`、`engines.npm` 并列；engines 对象可省略 `dsh`。 |
 
+`LocalizedText` 携带字面文本或带必需英文回退值的语言映射。`PluginLocalizedMeta` 携带已安装插件的可选展示标题、描述、从 `package.json.icon` 解析的图片 data URL，以及元信息诊断。[App boot](../../boot/app-boot/README.zh.md) 读取这些值；本包只提供其类型。
+
 公共组合声明定义在 [`src/types.ts`](src/types.ts) 中。内部 `configTrees`、`sessionFormatMigration` 和生成的 `moduleFallback` 元数据分别由镜像打包器、目录生成器和启动器读取方拥有；公共类型不暴露这些字段。
 
 -----

package/lib/types/index.d.ts

@@ -1,6 +1,6 @@
 /**
- * Public package manifest types, with no runtime exports.
+ * Public package manifest and plugin display types, with no runtime exports.
  * @module @deepseek-ai/dsh-package-manifest
  */
-export type { DshBundleManifest, DshClientManifest, DshEnginesManifest, DshManifest, DshPackageManifest, DshProfileManifest, } from './types.ts';
+export type { DshBundleManifest, DshClientManifest, DshEnginesManifest, DshManifest, DshPackageManifest, DshProfileManifest, LocalizedText, PluginLocalizedMeta, } from './types.ts';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/types.d.ts

@@ -1,5 +1,5 @@
 /**
- * Shared declarations for the package.json fields used by DSH plugin authors.
+ * Shared declarations for package.json fields and plugin display metadata.
  * Each reader owns JSON validation and resolved defaults.
  * @module @deepseek-ai/dsh-package-manifest/types
  */
@@ -11,6 +11,8 @@ export interface DshPackageManifest {
     version: string;
     /** Package summary for discovery and display. */
     description?: string;
+    /** SVG, PNG, JPEG, or WebP file relative to this manifest's directory, at most 256 KiB and contained there after realpath resolution. */
+    icon?: string;
     /** Prevent npm publication, for example for local profile projects. */
     private?: boolean;
     /** Packages installed alongside this package. */
@@ -33,6 +35,22 @@ export interface DshManifest {
     /** Client module loading and build metadata. */
     client?: DshClientManifest;
 }
+/** Literal text or translations indexed by lowercase language id, with a required English fallback. */
+export type LocalizedText = string | {
+    readonly en: string;
+    readonly [locale: string]: string;
+};
+/** Validated plugin display fields and diagnostics from exported locales, manifests, or icon files. */
+export interface PluginLocalizedMeta {
+    /** Display title; omission preserves the consumer's technical-name fallback. */
+    readonly title?: LocalizedText;
+    /** Display introduction after locale and package-field fallback. */
+    readonly description?: LocalizedText;
+    /** Base64 image data URL read from the manifest's icon file; render as an image, not inline markup. */
+    readonly icon?: string;
+    /** Unmodified local metadata diagnostic; the plugin remains manageable. */
+    readonly error?: string;
+}
 /** Runtime version requirements under `package.json.engines`. */
 export interface DshEnginesManifest {
     /** Compatible DSH versions as a SemVer range, including an exact version. */
@@ -46,8 +64,8 @@ export interface DshEnginesManifest {
 }
 /** The configuration layer exported by a bundle package. */
 export interface DshBundleManifest {
-    /** Patch file path relative to the declaring package root. */
-    patch: string;
+    /** One patch file path, or an ordered list applied in sequence, each relative to the declaring package root. */
+    patch: string | string[];
 }
 /** The bundle composition declared by a profile directory. */
 export interface DshProfileManifest {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-package-manifest",
   "description": "Shared type declarations for package.json.dsh configuration fields",
-  "version": "0.1.6-alpha.2",
+  "version": "0.1.7-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -27,9 +27,9 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/cordis": "~4.0.4"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/cordis": "~4.0.4"
   }
 }