chore(pdf): 本地 PDF 解析改用 @deckflow/pdf-lite-parse

pdf-lite-parse 已迁到 deckflow 名下，旧包标记为废弃。解析器代码不变，
IR 里记录的 producer 名称仍是 pdf-lite-parse，已有本地 PDF 产物继续可复用。

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Author: iguangfei

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## Unreleased
+
+- Depend on `@deckflow/pdf-lite-parse@0.2.1`, the new scoped name of the local PDF parser; the unscoped
+  `pdf-lite-parse` package is deprecated. The parser code is unchanged, and so is the `pdf-lite-parse`
+  producer name recorded in IR, so existing local PDF artifacts stay reusable.
+
 ## 2.4.0 — 2026-09-23 — PPTX lists and clean emphasis
 
 - Read PPTX list structure in both engines: each paragraph's outline level and bullet are resolved

README.md

@@ -27,15 +27,15 @@ npm install -g @deckflow/deckops
 
 The CLI and Node.js entry require Node.js 22.18 or newer. Frontend applications use the separate cloud-only [browser entry](#use-it-in-the-browser).
 
-Local PDF parsing uses `pdf-lite-parse@0.2.1` and exports embedded images without expensive composite-figure rasterization. Extractable overlay text is retained separately; visual fidelity losses are reported in `quality`. `--no-images` (SDK: `includeImages: false`) skips image export entirely.
+Local PDF parsing uses `@deckflow/pdf-lite-parse@0.2.1` and exports embedded images without expensive composite-figure rasterization. Extractable overlay text is retained separately; visual fidelity losses are reported in `quality`. `--no-images` (SDK: `includeImages: false`) skips image export entirely.
 
 Ordinary `npm install @deckflow/deckops` is now lightweight for PDF parsing: the parser embeds a pinned subset of PDF.js and its portable resources, with no separately installed `pdfjs-dist` or automatic canvas dependency. DeckProbe is pinned to the published 2.6.0 package; it uses its matching optional native CLI when available and falls back to WASM otherwise. To omit those as well and use the strict no-native installation:
 
 ```bash
 npm install --omit=optional @deckflow/deckops
 ```
 
-Embedded-image PDF parsing works in both installation modes without canvas. Use the cloud engine explicitly when full figure fidelity is needed. Applications calling `pdf-lite-parse` directly can explicitly install canvas for its opt-in composite mode; DeckOps does not enable it automatically.
+Embedded-image PDF parsing works in both installation modes without canvas. Use the cloud engine explicitly when full figure fidelity is needed. Applications calling `@deckflow/pdf-lite-parse` directly can explicitly install canvas for its opt-in composite mode; DeckOps does not enable it automatically.
 
 ## Content and upgrade policy
 
@@ -322,7 +322,7 @@ their original MIT license; this change does not revoke permissions already gran
 
 Third-party components retain their own licenses and copyright notices. See
 [THIRD_PARTY_NOTICES](THIRD_PARTY_NOTICES) and the licenses accompanying those
-components, including the PDF.js resources embedded in `pdf-lite-parse`.
+components, including the PDF.js resources embedded in `@deckflow/pdf-lite-parse`.
 The DeckOps license does not replace or remove those notices.
 
 Source and build instructions are available in this repository; use the tag or

THIRD_PARTY_NOTICES

@@ -5,14 +5,14 @@ That license does not relicense the third-party components listed below.
 Their applicable original licenses, copyright statements and attribution
 notices must be retained when redistributing those components.
 
-pdf-lite-parse
+@deckflow/pdf-lite-parse
 Copyright its contributors. Licensed under the Apache License 2.0.
 https://github.com/deckflow/pdf-lite-parse
 
 PDF.js / pdfjs-dist
 Copyright Mozilla Foundation and contributors. Licensed under the Apache License 2.0.
 https://github.com/mozilla/pdf.js
-An allowlisted runtime and resource subset is embedded in pdf-lite-parse.
+An allowlisted runtime and resource subset is embedded in @deckflow/pdf-lite-parse.
 See its dist/vendor/pdfjs/PROVENANCE.json, LICENSE, and resource license notices.
 
 @napi-rs/canvas (only if explicitly installed by a consumer; not a dependency)

package.json

@@ -76,6 +76,7 @@
   },
   "dependencies": {
     "@deckflow/deckprobe": "2.6.0",
+    "@deckflow/pdf-lite-parse": "0.2.1",
     "axios": "1.19.0",
     "chalk": "^5.3.0",
     "commander": "^11.1.0",
@@ -84,7 +85,6 @@
     "open": "^10.1.0",
     "p-limit": "^5.0.0",
     "parse5": "^7.3.0",
-    "pdf-lite-parse": "0.2.1",
     "saxes": "^6.0.0"
   },
   "devDependencies": {

pnpm-lock.yaml

@@ -68,7 +68,7 @@ try {
     '--engine', 'local', '--preflight', 'off', '--output', defaultOutput, '--json'], {encoding:'utf8'}));
   if (!defaultSmoke.ok || defaultSmoke.engine !== 'local') throw new Error('Default production install failed the local PDF smoke test.');
   const ir = JSON.parse(fs.readFileSync(path.join(defaultOutput, 'ir.json'), 'utf8'));
-  const parserVersion = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).dependencies['pdf-lite-parse'];
+  const parserVersion = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).dependencies['@deckflow/pdf-lite-parse'];
   if (ir.producer.version !== parserVersion) throw new Error('Installed PDF parser version does not match the dependency pin.');
   process.stdout.write(`tarball ${(item.size / MiB).toFixed(2)} MiB; strict install ${(installedBytes / MiB).toFixed(2)} MiB; default install ${(defaultBytes / MiB).toFixed(2)} MiB (${defaultNative} native binaries); cold-start P95 ${p95.toFixed(0)} ms; PDF RSS ${(measured.maxRssBytes / MiB).toFixed(2)} MiB; files >1 MiB ${large.length}\n`);
 } finally {

scripts/check-package-size.mjs

@@ -1,6 +1,6 @@
 import pLimit from 'p-limit';
 import type { ParseResult } from '../cloud/parse-facade.js';
-import type { ResultArtifact } from 'pdf-lite-parse';
+import type { ResultArtifact } from '@deckflow/pdf-lite-parse';
 import { stableId } from './ids.js';
 import {
   bulletDeclaration, levelStyleKey, listParagraphs, masterTextStyleKey, matchLayoutPlaceholder, placeholderKind, resolveList,

src/ir/cloud-adapter.ts

@@ -1,4 +1,4 @@
-import type { Element, Mark, ResultArtifact, Warning } from 'pdf-lite-parse';
+import type { Element, Mark, ResultArtifact, Warning } from '@deckflow/pdf-lite-parse';
 import { stableId } from './ids.js';
 import type { CandidateAsset, DeckIR, DeckIrNode, ParseCandidate, QualityCheck } from './schema.js';
 import { makeIr, qualityOf, type SourceIdentity } from '../local/common.js';

src/ir/result3-adapter.ts

@@ -1,4 +1,4 @@
-import type { ParseArtifacts, ParseOptions } from 'pdf-lite-parse';
+import type { ParseArtifacts, ParseOptions } from '@deckflow/pdf-lite-parse';
 import { DeckOpsError } from '../../errors/index.js';
 import { result3ToDeckIr } from '../../ir/result3-adapter.js';
 import type { ParseCandidate } from '../../ir/schema.js';
@@ -14,7 +14,7 @@ export interface LocalPdfOptions {
 
 export async function parsePdf(input: string | Uint8Array, source: SourceIdentity, limits: LocalLimits, options: LocalPdfOptions = {}): Promise<ParseCandidate> {
   // Deliberately lazy: formats/help and OOXML paths do not load PDF.js.
-  const { parseArtifacts } = await import('pdf-lite-parse');
+  const { parseArtifacts } = await import('@deckflow/pdf-lite-parse');
   const upstreamOptions: ParseOptions = {
     images: options.includeImages === false ? 'none' : 'embedded',
     ...(options.password !== undefined ? { password: options.password } : {}),

src/local/pdf/adapter.ts

@@ -4,4 +4,4 @@ const require = createRequire(import.meta.url);
 
 export const VERSION: string = (require('../package.json') as { version: string }).version;
 /** Exact dependency pin, read without loading PDF.js. */
-export const PDF_PARSER_VERSION: string = (require('../package.json') as { dependencies: Record<string, string> }).dependencies['pdf-lite-parse']!;
+export const PDF_PARSER_VERSION: string = (require('../package.json') as { dependencies: Record<string, string> }).dependencies['@deckflow/pdf-lite-parse']!;