@file-viewer/assets-standard 3.0.0

package/README.en.md

@@ -0,0 +1,3 @@
+# @file-viewer/assets-standard
+
+Self-hosted assets for the frozen standard profile. It contains only the Workers, WebAssembly modules, fonts, and vendor files required by PDF, DOCX, PPTX, spreadsheets, and archives. CAD, 3D, Typst, iWork, DICOM, and legacy PPT assets are excluded.

package/README.md

@@ -0,0 +1,3 @@
+# @file-viewer/assets-standard
+
+冻结的 standard profile 自托管资源包。只携带 PDF、DOCX、PPTX、XLSX 和 archive 所需的 Worker、WASM、字体与 vendor 文件，不包含 CAD、3D、Typst、iWork、DICOM 或 legacy PPT 资源。

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import { installFileViewerStandardAssets } from './index.js';
+const args = process.argv.slice(2);
+let targetDir;
+let clean = false;
+let confirmClean = false;
+for (const arg of args) {
+    if (arg === '--clean')
+        clean = true;
+    else if (arg === '--confirm')
+        confirmClean = true;
+    else if (arg === '--help' || arg === '-h') {
+        process.stdout.write('file-viewer-assets-standard [target-directory] [--clean --confirm]\n');
+        process.exit(0);
+    }
+    else if (arg.startsWith('-')) {
+        throw new Error(`Unknown option ${arg}.`);
+    }
+    else if (targetDir) {
+        throw new Error('Only one target directory is supported.');
+    }
+    else
+        targetDir = arg;
+}
+installFileViewerStandardAssets({ targetDir, clean, confirmClean })
+    .then(result => process.stdout.write(`[file-viewer] Installed standard assets in ${result.targetDir}.\n`))
+    .catch(error => {
+    process.stderr.write(`[file-viewer] ${error.message}\n`);
+    process.exitCode = 1;
+});

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import { type CapabilityAssetReceipt, type CapabilityAssetReceiptFile } from '@file-viewer/asset-installer';
+export interface InstallStandardAssetsOptions {
+    targetDir?: string;
+    /** Transactional merge is the default. Full removal requires clean + confirmClean. */
+    clean?: boolean;
+    confirmClean?: boolean;
+}
+export type StandardAssetReceiptFile = CapabilityAssetReceiptFile;
+export type StandardAssetReceipt = CapabilityAssetReceipt & {
+    packageName: '@file-viewer/assets-standard';
+    profile: 'standard';
+    profileManifestSha256: string;
+};
+export declare const installFileViewerStandardAssets: (options?: InstallStandardAssetsOptions) => Promise<{
+    rendererIds: string[];
+    targetDir: string;
+    receiptPath: string;
+    copyGroups: string[];
+    changed: boolean;
+}>;
+export declare const verifyFileViewerStandardAssetReceipt: (targetDir: string) => Promise<{
+    ok: boolean;
+    errors: string[];
+    receipt: null;
+} | {
+    ok: boolean;
+    errors: string[];
+    receipt: CapabilityAssetReceipt;
+}>;

package/dist/index.js

@@ -0,0 +1,19 @@
+import { readFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { installFileViewerCapabilityAssetPack, verifyFileViewerCapabilityAssetReceipt, } from '@file-viewer/asset-installer';
+const packageDir = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const receiptFilename = 'file-viewer-assets-standard.receipt.json';
+const packageJson = JSON.parse(await readFile(resolve(packageDir, 'package.json'), 'utf8'));
+export const installFileViewerStandardAssets = async (options = {}) => {
+    const result = await installFileViewerCapabilityAssetPack({
+        packageName: '@file-viewer/assets-standard',
+        packageVersion: packageJson.version,
+        packRoot: packageDir,
+        receiptFilename,
+        manifestFilename: 'flyfish-viewer-assets.json',
+        profile: 'standard',
+    }, options);
+    return { ...result, rendererIds: result.copyGroups };
+};
+export const verifyFileViewerStandardAssetReceipt = async (targetDir) => verifyFileViewerCapabilityAssetReceipt(targetDir, receiptFilename);

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@file-viewer/assets-standard",
+  "version": "3.0.0",
+  "private": false,
+  "type": "module",
+  "description": "Versioned self-hosted Worker, WASM, font, and vendor assets for the frozen File Viewer standard profile.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./cli": "./dist/cli.js",
+    "./viewer/*": "./viewer/*",
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "file-viewer-assets-standard": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "viewer",
+    "README.md",
+    "README.en.md"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.9.2",
+    "typescript": "^6.0.3"
+  },
+  "dependencies": {
+    "@file-viewer/asset-installer": "3.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/flyfish-dev/file-viewer.git",
+    "directory": "packages/tools/assets-standard"
+  },
+  "license": "Apache-2.0",
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node ../../../scripts/ensure-node-bin.mjs packages/tools/assets-standard/dist/cli.js && node --test test/*.test.mjs",
+    "stage-assets": "node scripts/stage-assets.mjs",
+    "type-check": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test test/*.test.mjs"
+  }
+}

package/viewer/flyfish-viewer-assets.json

@@ -0,0 +1,151 @@
+{
+  "schemaVersion": 1,
+  "packageName": "@file-viewer/assets-standard",
+  "packageVersion": "3.0.0",
+  "profile": "standard",
+  "profileManifestSha256": "aa60cba3fc4bb663516fc3be23881aeb3bfaf7039aa4fad9687bc21f8687caec",
+  "copyGroups": [
+    "archive",
+    "office-presentation",
+    "office-word-openxml",
+    "pdf",
+    "spreadsheet-openxml"
+  ],
+  "rendererAssetManifests": [
+    {
+      "rendererId": "pdf",
+      "assets": [
+        {
+          "id": "pdf-worker",
+          "rendererId": "pdf",
+          "kind": "worker",
+          "target": "public",
+          "required": true,
+          "defaultPath": "vendor/pdf/pdf.worker.mjs",
+          "optionPath": "pdf.workerUrl",
+          "description": "PDF.js module worker copied into viewer assets for offline PDF rendering."
+        },
+        {
+          "id": "pdf-cmaps",
+          "rendererId": "pdf",
+          "kind": "directory",
+          "target": "public",
+          "required": true,
+          "defaultPath": "vendor/pdf/cmaps/",
+          "optionPath": "pdf.cMapUrl",
+          "description": "PDF.js packed CMaps used for CJK and embedded text decoding."
+        },
+        {
+          "id": "pdf-wasm",
+          "rendererId": "pdf",
+          "kind": "wasm-directory",
+          "target": "public",
+          "required": true,
+          "defaultPath": "vendor/pdf/wasm/",
+          "optionPath": "pdf.wasmUrl",
+          "description": "PDF.js WebAssembly helpers for image decoding and fully self-hosted PDF rendering."
+        },
+        {
+          "id": "pdf-standard-fonts",
+          "rendererId": "pdf",
+          "kind": "directory",
+          "target": "public",
+          "required": true,
+          "defaultPath": "vendor/pdf/standard_fonts/",
+          "optionPath": "pdf.standardFontDataUrl",
+          "description": "PDF.js standard font data used when PDF files reference base fonts."
+        },
+        {
+          "id": "pdf-cjk-font-fallback",
+          "rendererId": "pdf",
+          "kind": "directory",
+          "target": "public",
+          "required": true,
+          "defaultPath": "vendor/pdf/fonts/",
+          "optionPath": "pdf.cjkFontFallbackPath",
+          "description": "Self-hosted Noto Sans SC variable font shards used for missing unembedded CJK fonts."
+        }
+      ]
+    },
+    {
+      "rendererId": "archive",
+      "assets": [
+        {
+          "id": "libarchive-worker",
+          "rendererId": "archive",
+          "kind": "worker",
+          "target": "public",
+          "required": true,
+          "defaultPath": "vendor/libarchive/worker-bundle.js",
+          "optionPath": "archive.workerUrl",
+          "description": "libarchive.js module worker used for broad archive format parsing."
+        },
+        {
+          "id": "libarchive-wasm",
+          "rendererId": "archive",
+          "kind": "wasm",
+          "target": "public",
+          "required": true,
+          "defaultPath": "vendor/libarchive/libarchive.wasm",
+          "optionPath": "archive.wasmUrl",
+          "description": "libarchive.js WebAssembly module expected next to the public worker."
+        }
+      ]
+    },
+    {
+      "rendererId": "office-word-openxml",
+      "assets": [
+        {
+          "id": "docx-worker",
+          "rendererId": "office-word-openxml",
+          "kind": "worker",
+          "target": "public",
+          "required": false,
+          "defaultPath": "vendor/docx/docx.worker.js",
+          "optionPath": "docx.workerUrl",
+          "description": "Optional @file-viewer/docx worker for off-main-thread DOCX ZIP/XML parsing."
+        },
+        {
+          "id": "docx-worker-jszip",
+          "rendererId": "office-word-openxml",
+          "kind": "script",
+          "target": "public",
+          "required": false,
+          "defaultPath": "vendor/docx/jszip.min.js",
+          "optionPath": "docx.workerJsZipUrl",
+          "description": "JSZip runtime loaded by the @file-viewer/docx worker for fully offline DOCX parsing."
+        }
+      ]
+    },
+    {
+      "rendererId": "office-presentation",
+      "assets": [
+        {
+          "id": "pptx-worker",
+          "rendererId": "office-presentation",
+          "kind": "worker",
+          "target": "public",
+          "required": false,
+          "defaultPath": "vendor/pptx/pptx.worker.js",
+          "optionPath": "presentation.workerUrl",
+          "description": "Optional @file-viewer/pptx worker for stable PPTX parsing in IIFE, CDN, and offline deployments."
+        }
+      ]
+    },
+    {
+      "rendererId": "spreadsheet-openxml",
+      "assets": [
+        {
+          "id": "spreadsheet-worker",
+          "rendererId": "spreadsheet-openxml",
+          "kind": "worker",
+          "target": "public",
+          "required": false,
+          "defaultPath": "vendor/xlsx/sheet.worker.js",
+          "optionPath": "spreadsheet.workerUrl",
+          "description": "Optional Spreadsheet worker for off-main-thread styled-exceljs workbook parsing."
+        }
+      ]
+    }
+  ]
+}

package/viewer/flyfish-viewer-manifest.json

@@ -0,0 +1,6 @@
+{
+  "name": "@file-viewer/assets-standard",
+  "version": "3.0.0",
+  "kind": "viewer-assets-standard",
+  "assets": "flyfish-viewer-assets.json"
+}