@stll/folio-core 0.66.0 → 0.66.1

package/dist/fonts/bundledFonts.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The document fonts folio bundles: one table for every place that names them.
+ *
+ * `@stll/folio-fonts` ships the files, and its generator
+ * (`scripts/generate-folio-fonts.ts`) reads this table to decide which files
+ * to copy and which `@font-face` rules to write, so the published package and
+ * the resolver here cannot disagree about a family. The module imports nothing:
+ * the generator, the resolver and the editor's availability check all read it
+ * without pulling in the rest of the engine.
+ */
+declare const PACKAGE_TABLE: {
+  readonly Arimo: "arimo";
+  readonly Caladea: "caladea";
+  readonly Carlito: "carlito";
+  readonly Cousine: "cousine";
+  readonly Lato: "lato";
+  readonly "Noto Sans Arabic": "noto-sans-arabic";
+  readonly "Source Sans 3": "source-sans-3";
+  readonly Tinos: "tinos";
+};
+export type FontsourcePackageTable = typeof PACKAGE_TABLE;
+/** Each bundled family and the directory (an `@fontsource` package name) that ships it. */
+export declare const FONTSOURCE_PACKAGES: FontsourcePackageTable;
+export type BundledFamily = keyof FontsourcePackageTable;
+/**
+ * What each bundled family stands in for, as prose for the package's notices.
+ * The resolver's own mapping lives in `utils/fontLoader.ts` and
+ * `utils/fontResolver.ts`.
+ */
+export declare const BUNDLED_FAMILY_SUBSTITUTES: Readonly<Record<BundledFamily, string>>;
+/**
+ * The subsets a headless measurer or the PDF writer reads, in resolution
+ * priority: a code point two subsets cover resolves to the earlier one.
+ * A browser is served every subset the family is cut into.
+ */
+export declare const MEASURED_SUBSETS: readonly ["latin", "latin-ext", "arabic"];
+export type MeasuredSubset = (typeof MEASURED_SUBSETS)[number];
+/** Folio paints 400 and 700 only, as `DisplayFontFace` states. */
+export declare const BUNDLED_WEIGHTS: readonly [400, 700];
+export type BundledWeight = (typeof BUNDLED_WEIGHTS)[number];
+/** The styles a family may be cut in; a family without italics ships `normal` only. */
+export declare const BUNDLED_STYLES: readonly ["normal", "italic"];
+export type BundledStyle = (typeof BUNDLED_STYLES)[number];
+/** `files/<package>-<subset>-<weight>-<style>.<format>`: the path of one served binary. */
+export declare const bundledFontFilePath: ({ packageName, subset, weight, style, format }: {
+  readonly packageName: string;
+  readonly subset: string;
+  readonly weight: number;
+  readonly style: BundledStyle;
+  readonly format: "woff" | "woff2";
+}) => string;
+/** Each family's directory carries the ranges its subsets were cut with. */
+export declare const UNICODE_RANGE_FILE = "unicode.json";
+export {};

package/dist/fonts/bundledFonts.js

@@ -0,0 +1,45 @@
+/** Each bundled family and the directory (an `@fontsource` package name) that ships it. */
+const FONTSOURCE_PACKAGES = {
+	Arimo: "arimo",
+	Caladea: "caladea",
+	Carlito: "carlito",
+	Cousine: "cousine",
+	Lato: "lato",
+	"Noto Sans Arabic": "noto-sans-arabic",
+	"Source Sans 3": "source-sans-3",
+	Tinos: "tinos"
+};
+/**
+* What each bundled family stands in for, as prose for the package's notices.
+* The resolver's own mapping lives in `utils/fontLoader.ts` and
+* `utils/fontResolver.ts`.
+*/
+const BUNDLED_FAMILY_SUBSTITUTES = {
+	Arimo: "Arial, and the generic sans-serif",
+	Caladea: "Cambria",
+	Carlito: "Calibri",
+	Cousine: "Courier New, and the generic monospace",
+	Lato: "Aptos and Aptos Display",
+	"Noto Sans Arabic": "Dubai, and Arabic script in every other family",
+	"Source Sans 3": "Segoe UI",
+	Tinos: "Times New Roman, and the generic serif"
+};
+/**
+* The subsets a headless measurer or the PDF writer reads, in resolution
+* priority: a code point two subsets cover resolves to the earlier one.
+* A browser is served every subset the family is cut into.
+*/
+const MEASURED_SUBSETS = [
+	"latin",
+	"latin-ext",
+	"arabic"
+];
+/** Folio paints 400 and 700 only, as `DisplayFontFace` states. */
+const BUNDLED_WEIGHTS = [400, 700];
+/** The styles a family may be cut in; a family without italics ships `normal` only. */
+const BUNDLED_STYLES = ["normal", "italic"];
+/** `files/<package>-<subset>-<weight>-<style>.<format>`: the path of one served binary. */
+const bundledFontFilePath = ({ packageName, subset, weight, style, format }) => `files/${packageName}-${subset}-${String(weight)}-${style}.${format}`;
+/** Each family's directory carries the ranges its subsets were cut with. */
+const UNICODE_RANGE_FILE = "unicode.json";
+export { BUNDLED_FAMILY_SUBSTITUTES, BUNDLED_STYLES, BUNDLED_WEIGHTS, FONTSOURCE_PACKAGES, MEASURED_SUBSETS, UNICODE_RANGE_FILE, bundledFontFilePath };

package/dist/fonts/fontsourceFaces.d.ts

@@ -1,20 +1,14 @@
 import { HeadlessFontSource } from "./headlessMeasure.js";
-/** Where `@fontsource` files come from: `null` when the package or file is absent. */
+import { FONTSOURCE_PACKAGES } from "./bundledFonts.js";
+/**
+ * Where the face files come from: `null` when the family or file is absent.
+ * Each family is a directory laid out like its `@fontsource` package;
+ * `@stll/folio-fonts/node` reads the copies that package ships.
+ */
 export type FontsourceFiles = {
-  /** Bytes of `@fontsource/<packageName>/<relativePath>`. */
+  /** Bytes of `<relativePath>` in the family directory `<packageName>`. */
   readonly read: (packageName: string, relativePath: string) => Uint8Array | null;
 };
-/** Each bundled family and the `@fontsource` package that ships it. */
-export declare const FONTSOURCE_PACKAGES: {
-  readonly Arimo: "arimo";
-  readonly Caladea: "caladea";
-  readonly Carlito: "carlito";
-  readonly Cousine: "cousine";
-  readonly Lato: "lato";
-  readonly "Noto Sans Arabic": "noto-sans-arabic";
-  readonly "Source Sans 3": "source-sans-3";
-  readonly Tinos: "tinos";
-};
 /**
  * A CSS `<string>` token, quoted and escaped. A family name comes from an
  * authored document and is emitted into a `<style>` element, so the
@@ -41,4 +35,5 @@ export type FontsourceFaces = {
   readonly fontFaceCss: (options?: FontsourceFontFaceCssOptions) => string;
 };
 /** The `@fontsource` faces, read through `files` and cached per face. */
-export declare const createFontsourceFaces: (files: FontsourceFiles) => FontsourceFaces;
+export declare const createFontsourceFaces: (files: FontsourceFiles) => FontsourceFaces;
+export { FONTSOURCE_PACKAGES };

package/dist/fonts/fontsourceFaces.js

@@ -2,6 +2,7 @@ import { bytesToDataUrl } from "../utils/base64.js";
 import { FONT_MAPPING } from "../utils/fontLoader.js";
 import { parseFontFamilyList, resolveFontFamily } from "../utils/fontResolver.js";
 import { decodeText } from "../utils/textEncoding.js";
+import { BUNDLED_WEIGHTS, FONTSOURCE_PACKAGES, MEASURED_SUBSETS, UNICODE_RANGE_FILE, bundledFontFilePath } from "./bundledFonts.js";
 // src/fonts/fontsourceFaces.ts
 /**
 * Faces from the `@fontsource` packages, for a caller that measures and paints
@@ -23,25 +24,8 @@ import { decodeText } from "../utils/textEncoding.js";
 * The subsets served, in resolution priority: a code point two subsets cover
 * resolves to the earlier one on both sides.
 */
-const SUBSET_PRIORITY = [
-	"latin",
-	"latin-ext",
-	"arabic"
-];
-/** Folio paints 400 and 700 only, as `DisplayFontFace` states. */
-const REGULAR_WEIGHT = 400;
-const BOLD_WEIGHT = 700;
-/** Each bundled family and the `@fontsource` package that ships it. */
-const FONTSOURCE_PACKAGES = {
-	Arimo: "arimo",
-	Caladea: "caladea",
-	Carlito: "carlito",
-	Cousine: "cousine",
-	Lato: "lato",
-	"Noto Sans Arabic": "noto-sans-arabic",
-	"Source Sans 3": "source-sans-3",
-	Tinos: "tinos"
-};
+const SUBSET_PRIORITY = MEASURED_SUBSETS;
+const [REGULAR_WEIGHT, BOLD_WEIGHT] = BUNDLED_WEIGHTS;
 /** A CSS stack ends in a generic, so a generic must resolve to a bundled family too. */
 const GENERIC_FAMILIES = {
 	serif: "Tinos",
@@ -81,8 +65,6 @@ const resolveBundledFamily = (family) => {
 	return null;
 };
 const weightOf = (bold) => bold ? BOLD_WEIGHT : REGULAR_WEIGHT;
-/** `@fontsource` ships the ranges it cut each subset with, beside the files. */
-const UNICODE_RANGE_FILE = "unicode.json";
 const RANGE_TOKEN_RE = /^U\+([0-9A-Fa-f]+)(?:-([0-9A-Fa-f]+))?$/u;
 const parseRangeToken = (token) => {
 	const match = RANGE_TOKEN_RE.exec(token.trim());
@@ -172,7 +154,13 @@ const createFontsourceFaces = (files) => {
 		const cached = faceCache.get(key);
 		if (cached !== void 0) return cached;
 		const binaries = SUBSET_PRIORITY.flatMap((subset) => {
-			const bytes = files.read(packageName, `files/${packageName}-${subset}-${String(weight)}-${style}.woff`);
+			const bytes = files.read(packageName, bundledFontFilePath({
+				packageName,
+				subset,
+				weight,
+				style,
+				format: "woff"
+			}));
 			return bytes === null ? [] : [{
 				subset,
 				bytes

package/dist/utils/fontLoader.d.ts

@@ -2,7 +2,7 @@
  * Font Loader
  *
  * Manages font availability for the DOCX editor. Fonts are bundled via
- * fontsource packages (WOFF2, no external requests). This module
+ * `@stll/folio-fonts` (WOFF2, no external requests). This module
  * tracks which fonts are loaded and provides callbacks for re-rendering
  * when fonts become available.
  */

package/dist/utils/fontLoader.js

@@ -1,9 +1,10 @@
+import { FONTSOURCE_PACKAGES } from "../fonts/bundledFonts.js";
 // src/utils/fontLoader.ts
 /**
 * Font Loader
 *
 * Manages font availability for the DOCX editor. Fonts are bundled via
-* fontsource packages (WOFF2, no external requests). This module
+* `@stll/folio-fonts` (WOFF2, no external requests). This module
 * tracks which fonts are loaded and provides callbacks for re-rendering
 * when fonts become available.
 */
@@ -34,16 +35,7 @@ const FONT_MAPPING = {
 	"Lucida Console": "monospace"
 };
 /** Bundled font families (available without network requests). */
-const BUNDLED_FONTS = /* @__PURE__ */ new Set([
-	"Carlito",
-	"Caladea",
-	"Arimo",
-	"Tinos",
-	"Cousine",
-	"Lato",
-	"Source Sans 3",
-	"Noto Sans Arabic"
-]);
+const BUNDLED_FONTS = new Set(Object.keys(FONTSOURCE_PACKAGES));
 /**
 * Mark a font as loaded. For bundled fonts this is immediate;
 * for others it checks CSS Font Loading API.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/folio-core",
-  "version": "0.66.0",
+  "version": "0.66.1",
   "description": "Headless, framework-neutral core of folio: the OOXML (.docx) parser, document model, ProseMirror integration, and page-layout engine. No React.",
   "keywords": [
     "document-model",
@@ -29,7 +29,9 @@
     "skills",
     "README.md",
     "LICENSE",
-    "NOTICE.md"
+    "NOTICE.md",
+    "licenses",
+    "THIRD_PARTY_NOTICES.md"
   ],
   "type": "module",
   "sideEffects": false,