@patterkit/ops 0.16.1 → 0.16.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ian Thomas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -1040,6 +1040,102 @@ declare function scriptToDocx(doc: ScriptDoc): Promise<Buffer>;
 /** Render the readable screenplay as a PDF. Resolves once PDFKit has flushed the whole document. */
 declare function scriptToPdf(doc: ScriptDoc): Promise<Buffer>;
 
+var serif = [
+	"@fontsource/newsreader/files/newsreader-latin-400-normal.woff",
+	"@fontsource/newsreader/files/newsreader-latin-ext-400-normal.woff",
+	"@fontsource/newsreader/files/newsreader-vietnamese-400-normal.woff"
+];
+var serifBold = [
+	"@fontsource/newsreader/files/newsreader-latin-600-normal.woff",
+	"@fontsource/newsreader/files/newsreader-latin-ext-600-normal.woff",
+	"@fontsource/newsreader/files/newsreader-vietnamese-600-normal.woff"
+];
+var serifItalic = [
+	"@fontsource/newsreader/files/newsreader-latin-400-italic.woff",
+	"@fontsource/newsreader/files/newsreader-latin-ext-400-italic.woff",
+	"@fontsource/newsreader/files/newsreader-vietnamese-400-italic.woff"
+];
+var serifBoldItalic = [
+	"@fontsource/newsreader/files/newsreader-latin-600-italic.woff",
+	"@fontsource/newsreader/files/newsreader-latin-ext-600-italic.woff",
+	"@fontsource/newsreader/files/newsreader-vietnamese-600-italic.woff"
+];
+var sans = [
+	"@fontsource/inter/files/inter-latin-400-normal.woff",
+	"@fontsource/inter/files/inter-latin-ext-400-normal.woff",
+	"@fontsource/inter/files/inter-greek-400-normal.woff",
+	"@fontsource/inter/files/inter-greek-ext-400-normal.woff",
+	"@fontsource/inter/files/inter-cyrillic-400-normal.woff",
+	"@fontsource/inter/files/inter-cyrillic-ext-400-normal.woff",
+	"@fontsource/inter/files/inter-vietnamese-400-normal.woff"
+];
+var sansBold = [
+	"@fontsource/inter/files/inter-latin-600-normal.woff",
+	"@fontsource/inter/files/inter-latin-ext-600-normal.woff",
+	"@fontsource/inter/files/inter-greek-600-normal.woff",
+	"@fontsource/inter/files/inter-greek-ext-600-normal.woff",
+	"@fontsource/inter/files/inter-cyrillic-600-normal.woff",
+	"@fontsource/inter/files/inter-cyrillic-ext-600-normal.woff",
+	"@fontsource/inter/files/inter-vietnamese-600-normal.woff"
+];
+var mono = [
+	"@ibm/plex-mono/fonts/complete/woff/IBMPlexMono-Regular.woff"
+];
+var fallback = [
+	"@fontsource/noto-sans/files/noto-sans-latin-400-normal.woff",
+	"@fontsource/noto-sans/files/noto-sans-latin-ext-400-normal.woff",
+	"@fontsource/noto-sans/files/noto-sans-greek-400-normal.woff",
+	"@fontsource/noto-sans/files/noto-sans-greek-ext-400-normal.woff",
+	"@fontsource/noto-sans/files/noto-sans-cyrillic-400-normal.woff",
+	"@fontsource/noto-sans/files/noto-sans-cyrillic-ext-400-normal.woff",
+	"@fontsource/noto-sans/files/noto-sans-vietnamese-400-normal.woff",
+	"@fontsource/noto-sans/files/noto-sans-devanagari-400-normal.woff",
+	"@fontsource/noto-sans-math/files/noto-sans-math-latin-400-normal.woff"
+];
+var emoji = [
+	"@fontsource/noto-emoji/files/noto-emoji-emoji-400-normal.woff",
+	"@fontsource/noto-emoji/files/noto-emoji-0-400-normal.woff",
+	"@fontsource/noto-emoji/files/noto-emoji-1-400-normal.woff",
+	"@fontsource/noto-emoji/files/noto-emoji-2-400-normal.woff",
+	"@fontsource/noto-emoji/files/noto-emoji-3-400-normal.woff",
+	"@fontsource/noto-emoji/files/noto-emoji-4-400-normal.woff",
+	"@fontsource/noto-emoji/files/noto-emoji-5-400-normal.woff",
+	"@fontsource/noto-emoji/files/noto-emoji-6-400-normal.woff",
+	"@fontsource/noto-emoji/files/noto-emoji-7-400-normal.woff",
+	"@fontsource/noto-emoji/files/noto-emoji-8-400-normal.woff",
+	"@fontsource/noto-emoji/files/noto-emoji-9-400-normal.woff",
+	"@fontsource/noto-emoji/files/noto-emoji-10-400-normal.woff"
+];
+var FACES = {
+	serif: serif,
+	serifBold: serifBold,
+	serifItalic: serifItalic,
+	serifBoldItalic: serifBoldItalic,
+	sans: sans,
+	sansBold: sansBold,
+	mono: mono,
+	fallback: fallback,
+	emoji: emoji
+};
+
+/** A face the PDF export registers: the design's three roles, plus the two fallbacks every role shares. */
+type ScriptFace = keyof typeof FACES;
+/** Each face's files, as module paths (`<package>/<file>`), in the order a character tries them. */
+declare const SCRIPT_FONT_FILES: Readonly<Record<ScriptFace, readonly string[]>>;
+/** The packages the faces come from, each of which carries the licence its fonts travel under. */
+declare const SCRIPT_FONT_PACKAGES: readonly string[];
+/** Read the files from these paths, keyed by module path, instead of resolving them from node_modules;
+ *  and the licences from `licencePaths`, keyed by package. For a bundle that embeds the files itself
+ *  (the standalone CLI, Patterpad). */
+declare function useScriptFontFiles(paths: Readonly<Record<string, string>>, licencePaths?: Readonly<Record<string, string>>): void;
+/** Where a font package's licence file is in node_modules (LICENSE, LICENSE.txt or OFL.txt). */
+declare function scriptFontLicencePath(pkg: string): string;
+/** Each font package's licence text, for a listing of what the PDF export embeds and under what terms. */
+declare function scriptFontLicences(): {
+    package: string;
+    text: string;
+}[];
+
 type InitVcs = "git" | "perforce" | "plastic" | "svn";
 /** Whether the compiled `.patterc` bundle is committed or built in CI (spec §11). */
 type BundlePosture = "commit" | "ignore";
@@ -1645,4 +1741,4 @@ declare const REFUSE_MISSING_SHARE = 0.25;
 /** Plan an import. Reads the handoff record named in the document from the project. */
 declare function planEditableImport(loaded: LoadedProject, returned: ReturnedDoc, opts: ImportOptions): ImportPlan;
 
-export { AUDIO_MANIFEST_FILE, AUDIO_MANIFEST_SCHEMA, AUTHORING_HANDLED, type ApplyStats, type AudioEntry, type AudioRung, type AudioSnapshot, type BuildPlan, type BundlePosture, CONFLICT_SIDECAR, type CharacterReport, type Conflict, type ConflictKind, type ContentError, type CoverageAsyncHooks, type CoverageBeat, type CoverageHooks, type CoverageOptions, type CoverageOrder, type CoverageReport, type DecisionPlan, type DecisionResult, type DocumentManifest, type EditableScript, type EditableScriptOptions, type ExportOptions, type FormatResult, GAME_SCOPES_OWNER, type GameScopes, type GameScopesIssue, HANDOFF_DIR, type HandoffIssue, type HygieneIssue, type ImportOptions, type ImportPlan, type ImportProblem, type ImportReport, type InitOptions, type InitResult, type InitVcs, type LoadedProject, type LocCatalog, type LocEntry, type LocaleReport, type MergeFileType, type MergeResult, type MergedShard, NotAPackError, type OpenSuggestion, PATTER_SCOPES_FILE, PATTER_SCOPES_OWNER, type PinPlan, type PinnedName, type PlannedWrite, type PlayEvent, type PlayOptions, type PlayOutcome, type PlayResult, type ProvenanceCheck, RARE_REACH_PCT, REFUSE_MISSING_SHARE, type Random, type ReadBox, type ReadComment, type ReadItem, type ReadMarker, type ReadParagraph, type ReadText, type ReplaceHit, type ReplaceOptions, type ReplacePlan, type ReportData, type ReportTotals, type ResolveEntry, type ReturnedDoc, SHARD_EXTENSIONS, type SceneReport, type ScriptDoc, type ScriptElement, type SearchFocus, type SuggestionDecision, type TrackedChange, type UnpackMergeResult, type UnpackResult, UnsafeEntryError, UnsupportedMergeError, type ValidateResult, type VoiceLine, type VoiceScript, type VoicedCounts, type WebExport, type WrittenCounts, applyLoc, applySceneOrder, applySuggestionDecisions, applyWrites, audioFolderRungs, audioFoldersActive, audioManifest, audioManifestWrite, besideBundlePath, bundleOutputPath, catalogToJson, catalogToPo, catalogToXlsx, classesForChannel, compileLoaded, cueLabel, currentBundlePosture, defaultBundlePath, defaultGameScopesDir, detectMergeType, discoverGameScopes, drivableScopes, exportBlockers, exportEditableScript, extractLoc, findProjectFile, formatMarker, gameScopeTokens, gameScopesCatalogue, gameScopesSnapshot, handoffPath, handoffWrite, hostScopeTokens, issueMarkerCodes, jsonToCatalog, leastReachedFirst, listOpenSuggestions, listProjectTags, loadProject, loadProjectLanding, markerLength, newHandoffId, parseHandoff, patterScopesFile, patterScopesStale, patterScopesWrite, pickAudio, planBuild, planEditableImport, planPins, planReturnedWorld, planShareScopes, planWorldSave, poToCatalog, previewRegistry, proposeCoverageDrivers, qualifierNamer, reachabilityIssues, readEditableDocx, readGameScopes, readHandoff, readHandoffs, readMarker, renderCoverageText, renderPlay, renderReportText, resolveDocumentation, resolveStart, runCoverage, runCoverageAsync, runExport, runExportFull, runExportHtml, runExportWeb, runFormat, runInit, runMerge, runPack, runPlay, runPropertyUsage, runReplace, runReport, runReportXlsx, runResolve, runScriptDoc, runSearch, runStatusBrowse, runTagBrowse, runUnpack, runUnpackMerge, runValidate, runVoiceScript, scanAudio, scanAudioStatus, sceneIdForShard, scriptToDocx, scriptToPdf, serialiseHandoff, setCut, sidecarIssues, staleParts, vcsConfigWrites, voiceScriptToXlsx, worldSettingsScopes, xlsxToCatalog };
+export { AUDIO_MANIFEST_FILE, AUDIO_MANIFEST_SCHEMA, AUTHORING_HANDLED, type ApplyStats, type AudioEntry, type AudioRung, type AudioSnapshot, type BuildPlan, type BundlePosture, CONFLICT_SIDECAR, type CharacterReport, type Conflict, type ConflictKind, type ContentError, type CoverageAsyncHooks, type CoverageBeat, type CoverageHooks, type CoverageOptions, type CoverageOrder, type CoverageReport, type DecisionPlan, type DecisionResult, type DocumentManifest, type EditableScript, type EditableScriptOptions, type ExportOptions, type FormatResult, GAME_SCOPES_OWNER, type GameScopes, type GameScopesIssue, HANDOFF_DIR, type HandoffIssue, type HygieneIssue, type ImportOptions, type ImportPlan, type ImportProblem, type ImportReport, type InitOptions, type InitResult, type InitVcs, type LoadedProject, type LocCatalog, type LocEntry, type LocaleReport, type MergeFileType, type MergeResult, type MergedShard, NotAPackError, type OpenSuggestion, PATTER_SCOPES_FILE, PATTER_SCOPES_OWNER, type PinPlan, type PinnedName, type PlannedWrite, type PlayEvent, type PlayOptions, type PlayOutcome, type PlayResult, type ProvenanceCheck, RARE_REACH_PCT, REFUSE_MISSING_SHARE, type Random, type ReadBox, type ReadComment, type ReadItem, type ReadMarker, type ReadParagraph, type ReadText, type ReplaceHit, type ReplaceOptions, type ReplacePlan, type ReportData, type ReportTotals, type ResolveEntry, type ReturnedDoc, SCRIPT_FONT_FILES, SCRIPT_FONT_PACKAGES, SHARD_EXTENSIONS, type SceneReport, type ScriptDoc, type ScriptElement, type ScriptFace, type SearchFocus, type SuggestionDecision, type TrackedChange, type UnpackMergeResult, type UnpackResult, UnsafeEntryError, UnsupportedMergeError, type ValidateResult, type VoiceLine, type VoiceScript, type VoicedCounts, type WebExport, type WrittenCounts, applyLoc, applySceneOrder, applySuggestionDecisions, applyWrites, audioFolderRungs, audioFoldersActive, audioManifest, audioManifestWrite, besideBundlePath, bundleOutputPath, catalogToJson, catalogToPo, catalogToXlsx, classesForChannel, compileLoaded, cueLabel, currentBundlePosture, defaultBundlePath, defaultGameScopesDir, detectMergeType, discoverGameScopes, drivableScopes, exportBlockers, exportEditableScript, extractLoc, findProjectFile, formatMarker, gameScopeTokens, gameScopesCatalogue, gameScopesSnapshot, handoffPath, handoffWrite, hostScopeTokens, issueMarkerCodes, jsonToCatalog, leastReachedFirst, listOpenSuggestions, listProjectTags, loadProject, loadProjectLanding, markerLength, newHandoffId, parseHandoff, patterScopesFile, patterScopesStale, patterScopesWrite, pickAudio, planBuild, planEditableImport, planPins, planReturnedWorld, planShareScopes, planWorldSave, poToCatalog, previewRegistry, proposeCoverageDrivers, qualifierNamer, reachabilityIssues, readEditableDocx, readGameScopes, readHandoff, readHandoffs, readMarker, renderCoverageText, renderPlay, renderReportText, resolveDocumentation, resolveStart, runCoverage, runCoverageAsync, runExport, runExportFull, runExportHtml, runExportWeb, runFormat, runInit, runMerge, runPack, runPlay, runPropertyUsage, runReplace, runReport, runReportXlsx, runResolve, runScriptDoc, runSearch, runStatusBrowse, runTagBrowse, runUnpack, runUnpackMerge, runValidate, runVoiceScript, scanAudio, scanAudioStatus, sceneIdForShard, scriptFontLicencePath, scriptFontLicences, scriptToDocx, scriptToPdf, serialiseHandoff, setCut, sidecarIssues, staleParts, useScriptFontFiles, vcsConfigWrites, voiceScriptToXlsx, worldSettingsScopes, xlsxToCatalog };

package/dist/index.js

@@ -1123,10 +1123,10 @@ function reachabilityIssues(loaded, compiled) {
     return bare.startsWith("@scene.");
   };
   const monotonic = (key) => latched.has(key) && !broken.has(key) && !preset.has(key) && projectOwned(key);
-  const cache = /* @__PURE__ */ new Map();
+  const cache2 = /* @__PURE__ */ new Map();
   const inFlight = /* @__PURE__ */ new Set();
   const mustHold = (key) => {
-    const done = cache.get(key);
+    const done = cache2.get(key);
     if (done !== void 0) return { need: done, cut: false };
     if (inFlight.has(key)) return { need: /* @__PURE__ */ new Set(), cut: true };
     const routes = writers.get(key);
@@ -1147,7 +1147,7 @@ function reachabilityIssues(loaded, compiled) {
     }
     inFlight.delete(key);
     const result = shared ?? /* @__PURE__ */ new Set();
-    if (!cut) cache.set(key, result);
+    if (!cut) cache2.set(key, result);
     return { need: result, cut };
   };
   const refute = (gate) => {
@@ -3847,6 +3847,114 @@ async function scriptToDocx(doc) {
 
 // src/script-pdf.ts
 import PDFDocument from "pdfkit";
+
+// src/script-fonts.ts
+import { existsSync as existsSync5, readdirSync as readdirSync4, readFileSync as readFileSync7 } from "fs";
+import { createRequire } from "module";
+import { join as join8 } from "path";
+
+// src/script-fonts.json
+var script_fonts_default = {
+  serif: [
+    "@fontsource/newsreader/files/newsreader-latin-400-normal.woff",
+    "@fontsource/newsreader/files/newsreader-latin-ext-400-normal.woff",
+    "@fontsource/newsreader/files/newsreader-vietnamese-400-normal.woff"
+  ],
+  serifBold: [
+    "@fontsource/newsreader/files/newsreader-latin-600-normal.woff",
+    "@fontsource/newsreader/files/newsreader-latin-ext-600-normal.woff",
+    "@fontsource/newsreader/files/newsreader-vietnamese-600-normal.woff"
+  ],
+  serifItalic: [
+    "@fontsource/newsreader/files/newsreader-latin-400-italic.woff",
+    "@fontsource/newsreader/files/newsreader-latin-ext-400-italic.woff",
+    "@fontsource/newsreader/files/newsreader-vietnamese-400-italic.woff"
+  ],
+  serifBoldItalic: [
+    "@fontsource/newsreader/files/newsreader-latin-600-italic.woff",
+    "@fontsource/newsreader/files/newsreader-latin-ext-600-italic.woff",
+    "@fontsource/newsreader/files/newsreader-vietnamese-600-italic.woff"
+  ],
+  sans: [
+    "@fontsource/inter/files/inter-latin-400-normal.woff",
+    "@fontsource/inter/files/inter-latin-ext-400-normal.woff",
+    "@fontsource/inter/files/inter-greek-400-normal.woff",
+    "@fontsource/inter/files/inter-greek-ext-400-normal.woff",
+    "@fontsource/inter/files/inter-cyrillic-400-normal.woff",
+    "@fontsource/inter/files/inter-cyrillic-ext-400-normal.woff",
+    "@fontsource/inter/files/inter-vietnamese-400-normal.woff"
+  ],
+  sansBold: [
+    "@fontsource/inter/files/inter-latin-600-normal.woff",
+    "@fontsource/inter/files/inter-latin-ext-600-normal.woff",
+    "@fontsource/inter/files/inter-greek-600-normal.woff",
+    "@fontsource/inter/files/inter-greek-ext-600-normal.woff",
+    "@fontsource/inter/files/inter-cyrillic-600-normal.woff",
+    "@fontsource/inter/files/inter-cyrillic-ext-600-normal.woff",
+    "@fontsource/inter/files/inter-vietnamese-600-normal.woff"
+  ],
+  mono: [
+    "@ibm/plex-mono/fonts/complete/woff/IBMPlexMono-Regular.woff"
+  ],
+  fallback: [
+    "@fontsource/noto-sans/files/noto-sans-latin-400-normal.woff",
+    "@fontsource/noto-sans/files/noto-sans-latin-ext-400-normal.woff",
+    "@fontsource/noto-sans/files/noto-sans-greek-400-normal.woff",
+    "@fontsource/noto-sans/files/noto-sans-greek-ext-400-normal.woff",
+    "@fontsource/noto-sans/files/noto-sans-cyrillic-400-normal.woff",
+    "@fontsource/noto-sans/files/noto-sans-cyrillic-ext-400-normal.woff",
+    "@fontsource/noto-sans/files/noto-sans-vietnamese-400-normal.woff",
+    "@fontsource/noto-sans/files/noto-sans-devanagari-400-normal.woff",
+    "@fontsource/noto-sans-math/files/noto-sans-math-latin-400-normal.woff"
+  ],
+  emoji: [
+    "@fontsource/noto-emoji/files/noto-emoji-emoji-400-normal.woff",
+    "@fontsource/noto-emoji/files/noto-emoji-0-400-normal.woff",
+    "@fontsource/noto-emoji/files/noto-emoji-1-400-normal.woff",
+    "@fontsource/noto-emoji/files/noto-emoji-2-400-normal.woff",
+    "@fontsource/noto-emoji/files/noto-emoji-3-400-normal.woff",
+    "@fontsource/noto-emoji/files/noto-emoji-4-400-normal.woff",
+    "@fontsource/noto-emoji/files/noto-emoji-5-400-normal.woff",
+    "@fontsource/noto-emoji/files/noto-emoji-6-400-normal.woff",
+    "@fontsource/noto-emoji/files/noto-emoji-7-400-normal.woff",
+    "@fontsource/noto-emoji/files/noto-emoji-8-400-normal.woff",
+    "@fontsource/noto-emoji/files/noto-emoji-9-400-normal.woff",
+    "@fontsource/noto-emoji/files/noto-emoji-10-400-normal.woff"
+  ]
+};
+
+// src/script-fonts.ts
+var SCRIPT_FONT_FILES = script_fonts_default;
+var SCRIPT_FONT_PACKAGES = [
+  ...new Set(Object.values(script_fonts_default).flat().map((spec) => spec.split("/").slice(0, spec.startsWith("@") ? 2 : 1).join("/")))
+];
+var require2 = createRequire(import.meta.url);
+var located = {};
+var licences = {};
+var cache = /* @__PURE__ */ new Map();
+function useScriptFontFiles(paths, licencePaths = {}) {
+  located = { ...paths };
+  licences = { ...licencePaths };
+  cache.clear();
+}
+function scriptFontLicencePath(pkg) {
+  const dir = (require2.resolve.paths(pkg) ?? []).map((p) => join8(p, pkg)).find((d) => existsSync5(d));
+  const file = dir && readdirSync4(dir).find((f) => /^(licen[cs]e|ofl)/i.test(f));
+  if (!dir || !file) throw new Error(`no licence file found for ${pkg}`);
+  return join8(dir, file);
+}
+function scriptFontLicences() {
+  return SCRIPT_FONT_PACKAGES.map((pkg) => ({ package: pkg, text: readFileSync7(licences[pkg] ?? scriptFontLicencePath(pkg), "utf8") }));
+}
+function scriptFontFiles(face) {
+  return script_fonts_default[face].map((spec) => {
+    let bytes = cache.get(spec);
+    if (!bytes) cache.set(spec, bytes = readFileSync7(located[spec] ?? require2.resolve(spec)));
+    return bytes;
+  });
+}
+
+// src/script-pdf.ts
 var MARGIN = 64;
 var INDENT_STEP = 20;
 var EDGE_INSET = 12;
@@ -3871,36 +3979,47 @@ var LINE = hex(TOKENS.line);
 var EDGE = "#d7d0c3";
 var SERIF2 = (bold, italic) => bold && italic ? "Serif-BoldItalic" : bold ? "Serif-Bold" : italic ? "Serif-Italic" : "Serif";
 var isEmoji = (cp) => cp >= 126976 || cp >= 9728 && cp <= 10175;
+var ROLES = {
+  "Serif": "serif",
+  "Serif-Bold": "serifBold",
+  "Serif-Italic": "serifItalic",
+  "Serif-BoldItalic": "serifBoldItalic",
+  "Sans": "sans",
+  "Sans-Bold": "sansBold",
+  "Mono": "mono"
+};
 async function scriptToPdf(doc) {
-  const { scriptFont } = await import("./script-fonts-AQNQOADI.js");
   return new Promise((resolve7, reject) => {
     const pdf = new PDFDocument({ size: "A4", margins: { top: MARGIN, bottom: MARGIN, left: MARGIN, right: MARGIN }, info: { Title: doc.project, Author: "Patter" }, font: null });
-    pdf.registerFont("Serif", scriptFont("serif"));
-    pdf.registerFont("Serif-Bold", scriptFont("serifBold"));
-    pdf.registerFont("Serif-Italic", scriptFont("serifItalic"));
-    pdf.registerFont("Serif-BoldItalic", scriptFont("serifBoldItalic"));
-    pdf.registerFont("Sans", scriptFont("sans"));
-    pdf.registerFont("Sans-Bold", scriptFont("sansBold"));
-    pdf.registerFont("Mono", scriptFont("mono"));
-    pdf.registerFont("Symbol", scriptFont("symbol"));
-    pdf.registerFont("Emoji", scriptFont("emoji"));
+    const register = (prefix, face, firstIsPrefix) => scriptFontFiles(face).map((bytes, i) => {
+      const name = firstIsPrefix && i === 0 ? prefix : `${prefix}~${i}`;
+      pdf.registerFont(name, bytes);
+      return name;
+    });
+    const roleFiles = {};
+    for (const [role, face] of Object.entries(ROLES)) roleFiles[role] = register(role, face, true);
+    const fallback = register("Fallback", "fallback", false);
+    const emoji = register("Emoji", "emoji", false);
     const coverage = {};
     const ascender = {};
-    for (const name of ["Serif", "Serif-Bold", "Serif-Italic", "Serif-BoldItalic", "Sans", "Sans-Bold", "Mono"]) {
+    for (const name of [...Object.values(roleFiles).flat(), ...fallback, ...emoji]) {
       pdf.font(name);
       const f = pdf._font;
       coverage[name] = (cp) => f.font.hasGlyphForCodePoint(cp);
       ascender[name] = f.ascender;
     }
     const ascentPt = (name, size) => ascender[name] / 1e3 * size;
+    const chains = {};
+    for (const role of Object.keys(ROLES)) chains[role] = [...roleFiles[role], ...fallback];
+    const pick = (chain, cp) => chain.find((n) => coverage[n](cp));
     const split = (text, primary, color) => {
-      const cov = coverage[primary];
+      const chain = chains[primary];
       const out = [];
       let buf = "";
       let cur = primary;
       for (const ch of text) {
         const cp = ch.codePointAt(0);
-        const f = isEmoji(cp) ? "Emoji" : cov(cp) ? primary : "Symbol";
+        const f = (isEmoji(cp) ? pick(emoji, cp) : void 0) ?? pick(chain, cp) ?? primary;
         if (f !== cur) {
           if (buf) out.push({ text: buf, font: cur, color });
           buf = "";
@@ -4066,8 +4185,8 @@ async function scriptToPdf(doc) {
 }
 
 // src/init.ts
-import { join as join8, basename as basename6, resolve as resolve5 } from "path";
-import { readdirSync as readdirSync4, existsSync as existsSync5, readFileSync as readFileSync7 } from "fs";
+import { join as join9, basename as basename6, resolve as resolve5 } from "path";
+import { readdirSync as readdirSync5, existsSync as existsSync6, readFileSync as readFileSync8 } from "fs";
 import { newId, slug, canonicalStringify as canonicalStringify7 } from "@patterkit/core";
 import { FLOW_SCHEMA, PROJECT_SCHEMA, STRINGS_SCHEMA as STRINGS_SCHEMA2 } from "@patterkit/model";
 function runInit(opts) {
@@ -4076,7 +4195,7 @@ function runInit(opts) {
   const fileSlug = slug(name);
   let existing = [];
   try {
-    existing = readdirSync4(dir).filter((f) => f.endsWith(".patterproj"));
+    existing = readdirSync5(dir).filter((f) => f.endsWith(".patterproj"));
   } catch {
   }
   if (existing.length > 0) throw new Error(`a project already exists here: ${existing[0]}`);
@@ -4120,31 +4239,31 @@ function runInit(opts) {
     strings: { [beatId]: `Welcome to ${name}. This is the first line of your story - replace it with your own.` }
   };
   const bundle = opts.bundle ?? "commit";
-  const projectFile = join8(dir, `${fileSlug}.patterproj`);
+  const projectFile = join9(dir, `${fileSlug}.patterproj`);
   const writes = [
-    { path: join8(dir, "scenes", "start.patterflow"), content: canonicalStringify7(flow) },
-    { path: join8(dir, "loc", "en", "start.patterloc"), content: canonicalStringify7(locale) },
-    { path: join8(dir, ".editorconfig"), content: EDITORCONFIG },
+    { path: join9(dir, "scenes", "start.patterflow"), content: canonicalStringify7(flow) },
+    { path: join9(dir, "loc", "en", "start.patterloc"), content: canonicalStringify7(locale) },
+    { path: join9(dir, ".editorconfig"), content: EDITORCONFIG },
     ...vcsConfigWrites(dir, opts.vcs, bundle),
     { path: projectFile, content: canonicalStringify7(project) }
   ];
-  const collisions = writes.map((w) => w.path).filter((p) => existsSync5(p));
+  const collisions = writes.map((w) => w.path).filter((p) => existsSync6(p));
   if (collisions.length > 0) {
     throw new Error(`refusing to overwrite existing file(s): ${collisions.join(", ")}`);
   }
   return { writes, projectFile, name };
 }
 function vcsConfigWrites(dir, vcs, bundle = "commit") {
-  const writes = [{ path: join8(dir, "vcs-setup.md"), content: vcsSetup(vcs, bundle) }];
-  if (vcs === "git") writes.push({ path: join8(dir, ".gitattributes"), content: GITATTRIBUTES });
+  const writes = [{ path: join9(dir, "vcs-setup.md"), content: vcsSetup(vcs, bundle) }];
+  if (vcs === "git") writes.push({ path: join9(dir, ".gitattributes"), content: GITATTRIBUTES });
   const ignore = ignoreFileFor(vcs);
-  if (ignore) writes.push({ path: join8(dir, ignore), content: ignoreContent(bundle) });
+  if (ignore) writes.push({ path: join9(dir, ignore), content: ignoreContent(bundle) });
   return writes;
 }
 function currentBundlePosture(dir, vcs) {
   const read = (name) => {
     try {
-      return readFileSync7(join8(dir, name), "utf8");
+      return readFileSync8(join9(dir, name), "utf8");
     } catch {
       return "";
     }
@@ -4640,7 +4759,7 @@ function runReplace(loaded, opts) {
 }
 
 // src/pin.ts
-import { readFileSync as readFileSync8 } from "fs";
+import { readFileSync as readFileSync9 } from "fs";
 import { canonicalStringify as canonicalStringify9, parseSource as parseSource5 } from "@patterkit/core";
 import { effectiveGameId as effectiveGameId3, gameIdify } from "@patterkit/model";
 function toPin(node) {
@@ -4668,7 +4787,7 @@ function planPins(loaded) {
     });
     if (!changed) continue;
     const next = { ...scene, ...sceneGameId !== void 0 ? { gameId: sceneGameId } : {}, blocks };
-    const file = parseSource5(readFileSync8(path, "utf8"));
+    const file = parseSource5(readFileSync9(path, "utf8"));
     plan.writes.push({ path, content: canonicalStringify9({ ...file, scene: next }) });
     plan.scenes.push(next);
   }
@@ -4677,8 +4796,8 @@ function planPins(loaded) {
 
 // src/unpack.ts
 import JSZip2 from "jszip";
-import { join as join9, resolve as resolve6, sep as sep4 } from "path";
-import { existsSync as existsSync6, readFileSync as readFileSync9, readdirSync as readdirSync5 } from "fs";
+import { join as join10, resolve as resolve6, sep as sep4 } from "path";
+import { existsSync as existsSync7, readFileSync as readFileSync10, readdirSync as readdirSync6 } from "fs";
 import { parseSource as parseSource6, canonicalStringify as canonicalStringify10 } from "@patterkit/core";
 import { isUnsafeEntry } from "@wildwinter/toolkit/archive";
 import { SCOPES_FILE_SUFFIX as SCOPES_FILE_SUFFIX2 } from "@wildwinter/scoperegistry/scopes";
@@ -4746,13 +4865,13 @@ async function runUnpack(bytes, targetDir) {
 function projectIdIn(dir) {
   let names;
   try {
-    names = readdirSync5(dir).filter((n) => n.endsWith(".patterproj"));
+    names = readdirSync6(dir).filter((n) => n.endsWith(".patterproj"));
   } catch {
     return void 0;
   }
   for (const n of names) {
     try {
-      const id = parseSource6(readFileSync9(join9(dir, n), "utf8")).project?.id;
+      const id = parseSource6(readFileSync10(join10(dir, n), "utf8")).project?.id;
       if (id) return id;
     } catch {
     }
@@ -4779,7 +4898,7 @@ function checkProvenance(returned, base, target) {
 }
 function targetProjectId(projectDir) {
   try {
-    const pf = parseSource6(readFileSync9(findProjectFile(projectDir), "utf8"));
+    const pf = parseSource6(readFileSync10(findProjectFile(projectDir), "utf8"));
     return pf.project?.id;
   } catch {
     return void 0;
@@ -4800,13 +4919,13 @@ async function runUnpackMerge(returnedBytes, baseBytes, projectDir) {
   for (const [rel, theirText] of [...theirs.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
     const outPath = containedWrite(projectDir, rel);
     const baseText = base.get(rel);
-    if (!existsSync6(outPath)) {
+    if (!existsSync7(outPath)) {
       if (baseText === theirText) continue;
       writes.push({ path: outPath, content: theirText });
       shards.push({ path: rel, added: true, changed: true });
       continue;
     }
-    const oursText = readFileSync9(outPath, "utf8");
+    const oursText = readFileSync10(outPath, "utf8");
     if (theirText === baseText || theirText === oursText) {
       if (rel === projectRel && baseText !== void 0) {
         const read = (t) => parseSource6(t);
@@ -4847,17 +4966,17 @@ async function runUnpackMerge(returnedBytes, baseBytes, projectDir) {
     if (world.write) {
       writes.push(world.write);
       gameScopes = { path: world.write.path };
-    } else if (world.error) gameScopes = { path: join9(local2.dir, GAME_SCOPES_FILE), error: world.error };
+    } else if (world.error) gameScopes = { path: join10(local2.dir, GAME_SCOPES_FILE), error: world.error };
   }
   const handoffs = [];
   for (const [rel, theirText] of [...returnedDoc.handoffs.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
     const outPath = containedWrite(projectDir, rel);
-    if (!existsSync6(outPath)) {
+    if (!existsSync7(outPath)) {
       writes.push({ path: outPath, content: theirText });
       handoffs.push(rel);
       continue;
     }
-    const merged = mergeHandoff(parseHandoff(readFileSync9(outPath, "utf8")), parseHandoff(theirText));
+    const merged = mergeHandoff(parseHandoff(readFileSync10(outPath, "utf8")), parseHandoff(theirText));
     if (merged) {
       writes.push({ path: outPath, content: serialiseHandoff(merged) });
       handoffs.push(rel);
@@ -4880,7 +4999,7 @@ function projectEntry(shards) {
 }
 function containedWrite(dir, name) {
   const root = resolve6(dir);
-  const full = resolve6(join9(dir, name));
+  const full = resolve6(join10(dir, name));
   if (full !== root && !full.startsWith(root + sep4)) {
     throw new UnsafeEntryError(`document entry escapes the target directory: ${name}`);
   }
@@ -4888,7 +5007,7 @@ function containedWrite(dir, name) {
 }
 
 // src/suggestions.ts
-import { readFileSync as readFileSync10 } from "fs";
+import { readFileSync as readFileSync11 } from "fs";
 import { canonicalStringify as canonicalStringify11, parseSource as parseSource7 } from "@patterkit/core";
 import { walkNodes as walkNodes5, AUTHORING_SCHEMA as AUTHORING_SCHEMA3 } from "@patterkit/model";
 function staleParts(s, liveText, line) {
@@ -4975,7 +5094,7 @@ var Working = class {
     if (!path) return void 0;
     let file = this.flows.get(path);
     if (!file) {
-      const onDisk = parseSource7(readFileSync10(path, "utf8"));
+      const onDisk = parseSource7(readFileSync11(path, "utf8"));
       const scene = this.loaded.scenes.find((s) => s.id === sceneId);
       file = { ...onDisk, scene: structuredClone(scene ?? onDisk.scene) };
       this.flows.set(path, file);
@@ -5452,11 +5571,11 @@ function readParagraphs(ps, joiner) {
     c.walk(p, "both");
     return c;
   });
-  const join10 = (view) => parts.map((c) => c.text(view)).filter((t) => t !== "").join(joiner);
+  const join11 = (view) => parts.map((c) => c.text(view)).filter((t) => t !== "").join(joiner);
   return {
     text: {
-      proposed: join10("proposed"),
-      original: join10("original"),
+      proposed: join11("proposed"),
+      original: join11("original"),
       changes: parts.flatMap((c) => c.changes),
       comments: [...new Set(parts.flatMap((c) => c.comments))],
       droppedFormatting: parts.reduce((n, c) => n + c.dropped, 0)
@@ -6027,6 +6146,8 @@ export {
   PATTER_SCOPES_OWNER,
   RARE_REACH_PCT,
   REFUSE_MISSING_SHARE,
+  SCRIPT_FONT_FILES,
+  SCRIPT_FONT_PACKAGES,
   SHARD_EXTENSIONS,
   UnsafeEntryError,
   UnsupportedMergeError,
@@ -6126,6 +6247,8 @@ export {
   scanAudio,
   scanAudioStatus,
   sceneIdForShard,
+  scriptFontLicencePath,
+  scriptFontLicences,
   scriptToDocx,
   scriptToPdf,
   serialiseHandoff,
@@ -6133,6 +6256,7 @@ export {
   setCut,
   sidecarIssues,
   staleParts,
+  useScriptFontFiles,
   vcsConfigWrites,
   voiceScriptToXlsx,
   worldSettingsScopes,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@patterkit/ops",
-  "version": "0.16.1",
+  "version": "0.16.2",
   "description": "The shared operations layer: every project operation (load, validate, export, format, play, ...) as a pure function, consumed by the patter CLI and Patterpad alike.",
   "type": "module",
   "license": "MIT",
@@ -27,9 +27,15 @@
     "build": "tsup src/index.ts --format esm --dts --clean"
   },
   "dependencies": {
-    "@patterkit/compiler": "0.6.1",
-    "@patterkit/core": "0.6.1",
-    "@patterkit/model": "0.13.0",
+    "@fontsource/inter": "^5.3.0",
+    "@fontsource/newsreader": "^5.3.0",
+    "@fontsource/noto-emoji": "^5.3.2",
+    "@fontsource/noto-sans": "^5.3.0",
+    "@fontsource/noto-sans-math": "^5.3.0",
+    "@ibm/plex-mono": "1.0.0",
+    "@patterkit/compiler": "0.6.2",
+    "@patterkit/core": "0.6.2",
+    "@patterkit/model": "0.13.1",
     "@patterkit/runtime": "0.24.0",
     "@wildwinter/toolkit": "^0.1.0",
     "@xmldom/xmldom": "^0.8.15",