wyuc 7cb129183d
chore(packages): publish the @openmaic/* SDK family to npm (#778) (#780)
* chore(packages): publish the @openmaic/* SDK family to npm (#778)

Prepares the @openmaic/{dsl,renderer,importer} family for its first npm
publish, and moves the SDK packages onto the @openmaic scope.

Why the scope move: the @maic org name is unavailable on npm (an unscoped
`maic` package already holds the name), so @maic/* is not claimable. @openmaic
matches the project name, the scope is free, and the repo already ships an
@openmaic/docs package — so the SDK family now lines up with that convention.

- rename @maic/{dsl,renderer,importer} -> @openmaic/* across packages, the
  workspace glob, the package dir, and all import sites; lockfile regenerated
- renderer: add publishConfig (public, registry.npmjs.org) — was missing, so
  a scoped publish would default to the wrong registry / restricted access
- importer: add a files allowlist (dist, README, LICENSE) and drop the
  fragile .npmignore blacklist that shipped src; add an exports map so ESM
  consumers resolve dist/index.js instead of falling back to the .cjs main
- all three: add a prepublishOnly build (+ test/typecheck) guard so a publish
  can never ship a stale or empty dist
- add a tag-triggered publish workflow with npm provenance, pinned by name to
  the three @openmaic packages so the vendored forks (mathml2omml, pptxgenjs)
  are never published

Refs #778, #720 (Phase 1).

* fix(packages): address cross-review on the @openmaic publish prep

Cross-review (Claude /code-review + codex) on this PR surfaced:

- renderer's advertised CJS entry was broken: it keeps @openmaic/dsl external
  and imports a runtime enum from it, but dsl is ESM-only (no `require`
  condition), so `require('@openmaic/renderer')` would throw
  ERR_PACKAGE_PATH_NOT_EXPORTED. Make renderer ESM-only: drop the `.cjs`
  rollup output, `main` now points at the ESM build, and the `require`
  conditions are removed from `exports`. (importer is unaffected — it bundles
  dsl, so its CJS build still works.)
- prepublishOnly re-ran the test suite during `pnpm -r publish`, so a flaky
  test after dsl had already published gave a non-atomic partial release.
  Reduce prepublishOnly to a build-only guard (never ship stale/empty dist)
  and move the real test/typecheck gate into the workflow, before any publish.
- document that an @openmaic/* tag publishes the whole family via `pnpm -r`
  (pnpm skips already-published versions); the tag is a release marker, not a
  per-package gate.

Verified: dsl + renderer + importer build; renderer emits ESM only (0 .cjs),
all exports entries resolve; `npm pack` ships dist + README + LICENSE with no
src leak; frozen-lockfile passes.

Refs #778.

* style: reflow @openmaic/dsl type imports past print-width after rename

The @maic -> @openmaic rename lengthened two single-line type imports past
prettier's 100-col width; prettier --check flagged them. Pure formatting.

Refs #778.

* docs(importer): mark @openmaic/importer browser-only (cr-loop accepted limitation)

codex cross-review flagged that the published @openmaic/importer throws
`XMLHttpRequest is not a constructor` when loaded in a pure Node process —
its rollup build is browser-targeted (`nodeResolve({browser:true})` + a
browser pdf.js build). The app only consumes it client-side ('use client'),
so this is by design. Document it as an accepted limitation: prominent
browser-only note in the README and a `browser` field in the manifest.

Refs #778.
2026-06-24 15:12:23 +08:00

116 lines
3.2 KiB
JavaScript

#!/usr/bin/env node
/**
* 解压 PPTX 并展示其内部文件结构
* 用法: node scripts/extract-pptx-structure.js <pptx路径> [输出目录]
* 示例: node scripts/extract-pptx-structure.js ./xxx.pptx
* node scripts/extract-pptx-structure.js ./xxx.pptx ./output
*/
import JSZip from 'jszip';
import fs from 'fs';
import path from 'path';
const args = process.argv.slice(2);
const pptxPath = args[0];
const outDir = args[1] || null;
if (!pptxPath) {
console.error('用法: node scripts/extract-pptx-structure.js <pptx路径> [输出目录]');
process.exit(1);
}
const resolvedPath = path.resolve(pptxPath);
if (!fs.existsSync(resolvedPath)) {
console.error('文件不存在:', resolvedPath);
process.exit(1);
}
/**
* 将扁平路径列表转成树形结构
* @param {string[]} paths - 如 ['ppt/slides/slide1.xml', 'ppt/slides/slide2.xml']
* @returns {Object} 树形对象
*/
function pathsToTree(paths) {
const tree = {};
for (const p of paths) {
const parts = p.split('/').filter(Boolean);
let current = tree;
for (let i = 0; i < parts.length; i++) {
const name = parts[i];
const isLast = i === parts.length - 1;
if (!current[name]) {
current[name] = isLast ? null : {};
}
if (!isLast) {
current = current[name];
}
}
}
return tree;
}
/**
* 递归打印树
*/
function printTree(obj, prefix = '') {
const entries = Object.entries(obj).sort((a, b) => {
const aIsFile = a[1] === null;
const bIsFile = b[1] === null;
if (aIsFile !== bIsFile) return aIsFile ? 1 : -1;
return a[0].localeCompare(b[0]);
});
for (let i = 0; i < entries.length; i++) {
const [name, value] = entries[i];
const isLast = i === entries.length - 1;
const branch = isLast ? '└── ' : '├── ';
const nextPrefix = isLast ? ' ' : '│ ';
if (value === null) {
console.log(prefix + branch + name);
} else {
console.log(prefix + branch + name + '/');
printTree(value, prefix + nextPrefix);
}
}
}
async function main() {
console.log('正在读取:', resolvedPath);
const buffer = fs.readFileSync(resolvedPath);
const zip = await JSZip.loadAsync(buffer);
const filePaths = [];
zip.forEach((relativePath) => {
filePaths.push(relativePath);
});
filePaths.sort();
console.log('\n========== PPTX 内部文件结构 ==========\n');
const tree = pathsToTree(filePaths);
printTree(tree);
console.log('\n---------- 扁平文件列表 ----------');
filePaths.forEach((p) => console.log(p));
console.log('\n总文件数:', filePaths.length);
if (outDir) {
const outResolved = path.resolve(outDir);
fs.mkdirSync(outResolved, { recursive: true });
console.log('\n正在解压到:', outResolved);
for (const relativePath of filePaths) {
const file = zip.file(relativePath);
if (!file) continue;
const fullPath = path.join(outResolved, relativePath);
const dir = path.dirname(fullPath);
fs.mkdirSync(dir, { recursive: true });
const content = await file.async('nodebuffer');
fs.writeFileSync(fullPath, content);
}
console.log('解压完成.');
}
}
main().catch((err) => {
console.error(err);
process.exit(1);
});