@superdoc-dev/fonts 0.1.0

package/assets/OFL.txt

@@ -0,0 +1,191 @@
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+
+This is the license text covering the OFL-1.1 fonts bundled in this directory
+(Carlito, Liberation Sans, Liberation Serif, Liberation Mono, Caprasimo,
+Bacasime Antique, Oregano Italic, Gelasio, Cardo, Comic Relief, Noto Sans,
+Selawik, Noto Sans Mono, Inconsolata SemiExpanded, PT Sans, Archivo Black, PT
+Sans Narrow). Copyright notices and any Reserved Font Name statements for those fonts
+are reproduced verbatim below, taken from the fonts' own name tables, so they
+travel with this license text. LICENSES.md restates them for convenience.
+Official OFL text: https://openfontlicense.org/open-font-license-official-text/
+
+-----------------------------------------------------------
+COPYRIGHT NOTICES (the "above copyright notice" required by condition 2)
+
+Carlito:
+    Copyright (c) 2010-2013 by tyPoland Lukasz Dziedzic
+    (http://www.typoland.com/) with Reserved Font Name "Carlito".
+    Licensed under the SIL Open Font License, Version 1.1.
+
+Liberation Sans, Liberation Serif, Liberation Mono:
+    Digitized data copyright (c) 2010 Google Corporation.
+    Copyright (c) 2012 Red Hat, Inc.
+    Licensed under the SIL Open Font License, Version 1.1.
+    ("Liberation" is a registered trademark of Red Hat, Inc.; these v2.1.5
+    files declare no OFL Reserved Font Name.)
+
+Caprasimo:
+    Copyright 2023 The Caprasimo Project Authors
+    (https://github.com/docrepair-fonts/caprasimo-fonts).
+    Licensed under the SIL Open Font License, Version 1.1.
+    (This v1.001 file declares no OFL Reserved Font Name.)
+
+Archivo Black:
+    Copyright 2017 The Archivo Black Project Authors
+    (https://github.com/Omnibus-Type/ArchivoBlack).
+    Licensed under the SIL Open Font License, Version 1.1.
+    (This v1.006 file declares no OFL Reserved Font Name.)
+
+Bacasime Antique:
+    Copyright 2023 The Bacasime Antique Project Authors
+    (https://github.com/docrepair-fonts/bacasime-antique-fonts), with Reserved
+    Font Name "Playfair".
+    Licensed under the SIL Open Font License, Version 1.1.
+
+Oregano Italic:
+    Copyright (c) 2012 by Brian J. Bonislawsky DBA Astigmatic (AOETI)
+    (astigma@astigmatic.com), with Reserved Font Name "Oregano Italic".
+    Licensed under the SIL Open Font License, Version 1.1.
+
+Gelasio:
+    Copyright 2022 The Gelasio Project Authors
+    (https://github.com/SorkinType/Gelasio)
+    Licensed under the SIL Open Font License, Version 1.1.
+    (These v1.008 files declare no OFL Reserved Font Name.)
+
+Cardo:
+    Copyright (c) 2002-2011, David J. Perry
+    (hospes02@scholarsfonts.net)
+    Licensed under the SIL Open Font License, Version 1.1.
+    (These files declare no OFL Reserved Font Name.)
+
+Comic Relief:
+    Copyright 2013 The Comic Relief Project Authors
+    (https://github.com/loudifier/Comic-Relief)
+    Licensed under the SIL Open Font License, Version 1.1.
+    (These v1.200 files declare no OFL Reserved Font Name.)
+
+Noto Sans:
+    Copyright 2022 The Noto Project Authors
+    (https://github.com/notofonts/latin-greek-cyrillic)
+    Licensed under the SIL Open Font License, Version 1.1.
+    (These v2.015 files declare no OFL Reserved Font Name.)
+
+Selawik:
+    © 2015 Microsoft Corporation (www.microsoft.com), with Reserved Font Name
+    "Selawik". Selawik is a trademark of Microsoft Corporation in the United
+    States and/or other countries.
+    Licensed under the SIL Open Font License, Version 1.1.
+
+Noto Sans Mono:
+    Copyright 2022 The Noto Project Authors
+    (https://github.com/notofonts/latin-greek-cyrillic)
+    Licensed under the SIL Open Font License, Version 1.1.
+    (These v2.014 files declare no OFL Reserved Font Name.)
+
+Inconsolata SemiExpanded:
+    Copyright 2006 The Inconsolata Project Authors
+    (https://github.com/cyrealtype/Inconsolata)
+    Licensed under the SIL Open Font License, Version 1.1.
+    (These v3.001 files declare no OFL Reserved Font Name.)
+
+PT Sans:
+    Copyright (c) 2010, ParaType Ltd.
+    (http://www.paratype.com/public), with Reserved Font Names "PT Sans",
+    "PT Serif" and "ParaType".
+    Licensed under the SIL Open Font License, Version 1.1.
+
+PT Sans Narrow:
+    Copyright (c) 2010, ParaType Ltd.
+    (http://www.paratype.com/public), with Reserved Font Names "PT Sans",
+    "PT Serif" and "ParaType".
+    Licensed under the SIL Open Font License, Version 1.1.
+
+-----------------------------------------------------------
+PREAMBLE
+
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/asset-urls.d.ts

@@ -0,0 +1,8 @@
+/**
+ * GENERATED by scripts/generate-asset-urls.mjs - do not edit by hand.
+ *
+ * Each value is a static `new URL('../assets/<file>', import.meta.url)`, the cross-bundler
+ * pattern for "emit this asset and give me its final URL". Bundlers rewrite these at build
+ * time; under plain Node ESM they resolve to the file:// path inside the package.
+ */
+export declare const BUNDLED_FONT_ASSET_URLS: Readonly<Record<string, string>>;

package/dist/asset-urls.js

@@ -0,0 +1,76 @@
+/**
+ * GENERATED by scripts/generate-asset-urls.mjs - do not edit by hand.
+ *
+ * Each value is a static `new URL('../assets/<file>', import.meta.url)`, the cross-bundler
+ * pattern for "emit this asset and give me its final URL". Bundlers rewrite these at build
+ * time; under plain Node ESM they resolve to the file:// path inside the package.
+ */
+export const BUNDLED_FONT_ASSET_URLS = Object.freeze({
+    'ArchivoBlack-Regular.woff2': new URL('../assets/ArchivoBlack-Regular.woff2', import.meta.url).href,
+    'BacasimeAntique-Regular.woff2': new URL('../assets/BacasimeAntique-Regular.woff2', import.meta.url).href,
+    'C059-BdIta.woff2': new URL('../assets/C059-BdIta.woff2', import.meta.url).href,
+    'C059-Bold.woff2': new URL('../assets/C059-Bold.woff2', import.meta.url).href,
+    'C059-Italic.woff2': new URL('../assets/C059-Italic.woff2', import.meta.url).href,
+    'C059-Roman.woff2': new URL('../assets/C059-Roman.woff2', import.meta.url).href,
+    'Caladea-Bold.woff2': new URL('../assets/Caladea-Bold.woff2', import.meta.url).href,
+    'Caladea-BoldItalic.woff2': new URL('../assets/Caladea-BoldItalic.woff2', import.meta.url).href,
+    'Caladea-Italic.woff2': new URL('../assets/Caladea-Italic.woff2', import.meta.url).href,
+    'Caladea-Regular.woff2': new URL('../assets/Caladea-Regular.woff2', import.meta.url).href,
+    'Caprasimo-Regular.woff2': new URL('../assets/Caprasimo-Regular.woff2', import.meta.url).href,
+    'Cardo-Bold.woff2': new URL('../assets/Cardo-Bold.woff2', import.meta.url).href,
+    'Cardo-Italic.woff2': new URL('../assets/Cardo-Italic.woff2', import.meta.url).href,
+    'Cardo-Regular.woff2': new URL('../assets/Cardo-Regular.woff2', import.meta.url).href,
+    'Carlito-Bold.woff2': new URL('../assets/Carlito-Bold.woff2', import.meta.url).href,
+    'Carlito-BoldItalic.woff2': new URL('../assets/Carlito-BoldItalic.woff2', import.meta.url).href,
+    'Carlito-Italic.woff2': new URL('../assets/Carlito-Italic.woff2', import.meta.url).href,
+    'Carlito-Regular.woff2': new URL('../assets/Carlito-Regular.woff2', import.meta.url).href,
+    'ComicRelief-Bold.woff2': new URL('../assets/ComicRelief-Bold.woff2', import.meta.url).href,
+    'ComicRelief-Regular.woff2': new URL('../assets/ComicRelief-Regular.woff2', import.meta.url).href,
+    'Gelasio-Bold.woff2': new URL('../assets/Gelasio-Bold.woff2', import.meta.url).href,
+    'Gelasio-BoldItalic.woff2': new URL('../assets/Gelasio-BoldItalic.woff2', import.meta.url).href,
+    'Gelasio-Italic.woff2': new URL('../assets/Gelasio-Italic.woff2', import.meta.url).href,
+    'Gelasio-Regular.woff2': new URL('../assets/Gelasio-Regular.woff2', import.meta.url).href,
+    'InconsolataSemiExpanded-Bold.woff2': new URL('../assets/InconsolataSemiExpanded-Bold.woff2', import.meta.url).href,
+    'InconsolataSemiExpanded-Regular.woff2': new URL('../assets/InconsolataSemiExpanded-Regular.woff2', import.meta.url)
+        .href,
+    'LiberationMono-Bold.woff2': new URL('../assets/LiberationMono-Bold.woff2', import.meta.url).href,
+    'LiberationMono-BoldItalic.woff2': new URL('../assets/LiberationMono-BoldItalic.woff2', import.meta.url).href,
+    'LiberationMono-Italic.woff2': new URL('../assets/LiberationMono-Italic.woff2', import.meta.url).href,
+    'LiberationMono-Regular.woff2': new URL('../assets/LiberationMono-Regular.woff2', import.meta.url).href,
+    'LiberationSans-Bold.woff2': new URL('../assets/LiberationSans-Bold.woff2', import.meta.url).href,
+    'LiberationSans-BoldItalic.woff2': new URL('../assets/LiberationSans-BoldItalic.woff2', import.meta.url).href,
+    'LiberationSans-Italic.woff2': new URL('../assets/LiberationSans-Italic.woff2', import.meta.url).href,
+    'LiberationSans-Regular.woff2': new URL('../assets/LiberationSans-Regular.woff2', import.meta.url).href,
+    'LiberationSansNarrow-Bold.woff2': new URL('../assets/LiberationSansNarrow-Bold.woff2', import.meta.url).href,
+    'LiberationSansNarrow-BoldItalic.woff2': new URL('../assets/LiberationSansNarrow-BoldItalic.woff2', import.meta.url)
+        .href,
+    'LiberationSansNarrow-Italic.woff2': new URL('../assets/LiberationSansNarrow-Italic.woff2', import.meta.url).href,
+    'LiberationSansNarrow-Regular.woff2': new URL('../assets/LiberationSansNarrow-Regular.woff2', import.meta.url).href,
+    'LiberationSerif-Bold.woff2': new URL('../assets/LiberationSerif-Bold.woff2', import.meta.url).href,
+    'LiberationSerif-BoldItalic.woff2': new URL('../assets/LiberationSerif-BoldItalic.woff2', import.meta.url).href,
+    'LiberationSerif-Italic.woff2': new URL('../assets/LiberationSerif-Italic.woff2', import.meta.url).href,
+    'LiberationSerif-Regular.woff2': new URL('../assets/LiberationSerif-Regular.woff2', import.meta.url).href,
+    'NotoSans-Bold.woff2': new URL('../assets/NotoSans-Bold.woff2', import.meta.url).href,
+    'NotoSans-BoldItalic.woff2': new URL('../assets/NotoSans-BoldItalic.woff2', import.meta.url).href,
+    'NotoSans-Italic.woff2': new URL('../assets/NotoSans-Italic.woff2', import.meta.url).href,
+    'NotoSans-Regular.woff2': new URL('../assets/NotoSans-Regular.woff2', import.meta.url).href,
+    'NotoSansMono-Bold.woff2': new URL('../assets/NotoSansMono-Bold.woff2', import.meta.url).href,
+    'NotoSansMono-Regular.woff2': new URL('../assets/NotoSansMono-Regular.woff2', import.meta.url).href,
+    'OreganoItalic-Regular.woff2': new URL('../assets/OreganoItalic-Regular.woff2', import.meta.url).href,
+    'PTSans-Bold.woff2': new URL('../assets/PTSans-Bold.woff2', import.meta.url).href,
+    'PTSans-BoldItalic.woff2': new URL('../assets/PTSans-BoldItalic.woff2', import.meta.url).href,
+    'PTSans-Italic.woff2': new URL('../assets/PTSans-Italic.woff2', import.meta.url).href,
+    'PTSans-Regular.woff2': new URL('../assets/PTSans-Regular.woff2', import.meta.url).href,
+    'PTSansNarrow-Bold.woff2': new URL('../assets/PTSansNarrow-Bold.woff2', import.meta.url).href,
+    'PTSansNarrow-Regular.woff2': new URL('../assets/PTSansNarrow-Regular.woff2', import.meta.url).href,
+    'Selawik-Bold.woff2': new URL('../assets/Selawik-Bold.woff2', import.meta.url).href,
+    'Selawik-Regular.woff2': new URL('../assets/Selawik-Regular.woff2', import.meta.url).href,
+    'TeXGyreBonum-Bold.woff2': new URL('../assets/TeXGyreBonum-Bold.woff2', import.meta.url).href,
+    'TeXGyreBonum-BoldItalic.woff2': new URL('../assets/TeXGyreBonum-BoldItalic.woff2', import.meta.url).href,
+    'TeXGyreBonum-Italic.woff2': new URL('../assets/TeXGyreBonum-Italic.woff2', import.meta.url).href,
+    'TeXGyreBonum-Regular.woff2': new URL('../assets/TeXGyreBonum-Regular.woff2', import.meta.url).href,
+    'URWGothic-Book.woff2': new URL('../assets/URWGothic-Book.woff2', import.meta.url).href,
+    'URWGothic-BookOblique.woff2': new URL('../assets/URWGothic-BookOblique.woff2', import.meta.url).href,
+    'URWGothic-Demi.woff2': new URL('../assets/URWGothic-Demi.woff2', import.meta.url).href,
+    'URWGothic-DemiOblique.woff2': new URL('../assets/URWGothic-DemiOblique.woff2', import.meta.url).href,
+});

package/dist/bundled-families.d.ts

@@ -0,0 +1,9 @@
+/**
+ * GENERATED by scripts/generate-bundled-families.ts - do not edit by hand.
+ *
+ * The Word family names a document can curate via createSuperDocFonts({ include / exclude }), mirrored
+ * from @superdoc/font-system's runtime curation set (every logical family the resolver substitutes to a
+ * bundled face, including category fallbacks like Verdana). A name outside this set is a typo or an
+ * unbundled font, so createSuperDocFonts rejects it instead of silently dropping the intended fonts.
+ */
+export declare const BUNDLED_FAMILY_NAMES: readonly string[];

package/dist/bundled-families.js

@@ -0,0 +1,40 @@
+/**
+ * GENERATED by scripts/generate-bundled-families.ts - do not edit by hand.
+ *
+ * The Word family names a document can curate via createSuperDocFonts({ include / exclude }), mirrored
+ * from @superdoc/font-system's runtime curation set (every logical family the resolver substitutes to a
+ * bundled face, including category fallbacks like Verdana). A name outside this set is a typo or an
+ * unbundled font, so createSuperDocFonts rejects it instead of silently dropping the intended fonts.
+ */
+export const BUNDLED_FAMILY_NAMES = Object.freeze([
+    'Arial',
+    'Arial Black',
+    'Arial MT',
+    'Arial Narrow',
+    'Baskerville Old Face',
+    'Bookman Old Style',
+    'Brush Script MT',
+    'Calibri',
+    'Calibri Light',
+    'Cambria',
+    'Century',
+    'Century Gothic',
+    'Century Schoolbook',
+    'Comic Sans MS',
+    'Consolas',
+    'Cooper Black',
+    'Courier',
+    'Courier New',
+    'Garamond',
+    'Georgia',
+    'Gill Sans MT Condensed',
+    'Helvetica',
+    'ITC Bookman',
+    'Lucida Console',
+    'Segoe UI',
+    'Tahoma',
+    'Times',
+    'Times New Roman',
+    'Trebuchet MS',
+    'Verdana',
+]);

package/dist/index.d.ts

@@ -0,0 +1,100 @@
+/**
+ * `@superdoc-dev/fonts` - the reviewed metric-compatible font substitutes SuperDoc renders for
+ * proprietary Word fonts (Carlito for Calibri, Liberation Serif for Times New Roman, etc.).
+ *
+ * Optional: install it to make the bundled fallbacks load automatically in any bundler app, with
+ * no copy step and no `assetBaseUrl`. The asset URLs are written as
+ * `new URL('../assets/<file>', import.meta.url)`, which Vite, Webpack 5, Next, Nuxt, esbuild, and
+ * Parcel detect, emit, and rewrite to the final hashed path.
+ *
+ * @beta This package is in preview; its surface may change before 1.0.
+ */
+import { BUNDLED_FONT_ASSET_URLS } from './asset-urls';
+/**
+ * The full filename -> bundler-emitted URL map for every bundled face. Most consumers use
+ * {@link superdocFonts} or {@link resolveBundledFontAssetUrl} instead of reading this directly.
+ *
+ * @beta
+ */
+export { BUNDLED_FONT_ASSET_URLS };
+/**
+ * Minimal structural shape of SuperDoc's bundled-font asset context. Kept LOCAL so this
+ * package has no dependency on `@superdoc/font-system`; only `file` is read. Assignable to
+ * SuperDoc's `FontAssetUrlResolver` by structural typing.
+ *
+ * @beta
+ */
+export interface BundledFontAssetContext {
+    /** Asset filename, e.g. `Carlito-Regular.woff2`. */
+    file: string;
+    family?: string;
+    weight?: string;
+    style?: 'normal' | 'italic';
+    source?: string;
+}
+/**
+ * Resolve a bundled substitute face filename to a bundler-emitted URL.
+ *
+ * Pass as SuperDoc's `fonts.resolveAssetUrl` so the reviewed fallback pack loads from THIS
+ * package's emitted assets, with no manual copy step and no `assetBaseUrl`:
+ *
+ *     import { resolveBundledFontAssetUrl } from '@superdoc-dev/fonts';
+ *     new SuperDoc({ selector: '#editor', document, fonts: { resolveAssetUrl: resolveBundledFontAssetUrl } });
+ *
+ * Throws on an unknown file, which signals a version mismatch between `@superdoc-dev/fonts` and
+ * the `superdoc` core manifest rather than silently degrading to the logical font name.
+ *
+ * @beta
+ */
+export declare function resolveBundledFontAssetUrl(context: BundledFontAssetContext): string;
+/**
+ * Drop-in value for SuperDoc's `fonts` config: `new SuperDoc({ fonts: superdocFonts })`.
+ * Equivalent to `{ resolveAssetUrl: resolveBundledFontAssetUrl }`.
+ *
+ * @beta
+ */
+export declare const superdocFonts: {
+    resolveAssetUrl: (context: BundledFontAssetContext) => string;
+};
+/**
+ * Choose which bundled families SuperDoc advertises and renders, by LOGICAL Word family name
+ * (`"Calibri"`, never the physical `"Carlito"`).
+ *
+ * @beta
+ */
+export interface SuperDocFontsOptions {
+    /** Allow-list: ONLY these logical families are active, e.g. `['Calibri', 'Cambria']`. */
+    include?: string[];
+    /** Block-list: every bundled family EXCEPT these, e.g. `['Cooper Black', 'Brush Script MT']`. */
+    exclude?: string[];
+}
+/**
+ * The `fonts` config {@link createSuperDocFonts} returns: the bundled-asset resolver plus the
+ * curation. Structurally assignable to SuperDoc's `fonts` option.
+ *
+ * @beta
+ */
+export interface SuperDocFontsConfig {
+    resolveAssetUrl: (context: BundledFontAssetContext) => string;
+    bundled?: {
+        include?: string[];
+        exclude?: string[];
+    };
+}
+/**
+ * Build a curated `fonts` config: the bundled pack, narrowed to the families you choose.
+ *
+ *     import { createSuperDocFonts } from '@superdoc-dev/fonts';
+ *     new SuperDoc({
+ *       selector: '#editor',
+ *       document,
+ *       fonts: createSuperDocFonts({ exclude: ['Cooper Black', 'Brush Script MT'] }),
+ *     });
+ *
+ * Names are Word logical families. Pass neither `include` nor `exclude` for the full pack - that is
+ * exactly {@link superdocFonts}. Curation governs the BUNDLED pack only; your own licensed fonts stay
+ * separate (`fonts.families` / `fonts.map`).
+ *
+ * @beta
+ */
+export declare function createSuperDocFonts(options?: SuperDocFontsOptions): SuperDocFontsConfig;

package/dist/index.js

@@ -0,0 +1,158 @@
+/**
+ * `@superdoc-dev/fonts` - the reviewed metric-compatible font substitutes SuperDoc renders for
+ * proprietary Word fonts (Carlito for Calibri, Liberation Serif for Times New Roman, etc.).
+ *
+ * Optional: install it to make the bundled fallbacks load automatically in any bundler app, with
+ * no copy step and no `assetBaseUrl`. The asset URLs are written as
+ * `new URL('../assets/<file>', import.meta.url)`, which Vite, Webpack 5, Next, Nuxt, esbuild, and
+ * Parcel detect, emit, and rewrite to the final hashed path.
+ *
+ * @beta This package is in preview; its surface may change before 1.0.
+ */
+import { BUNDLED_FONT_ASSET_URLS } from './asset-urls';
+import { BUNDLED_FAMILY_NAMES } from './bundled-families';
+/**
+ * The full filename -> bundler-emitted URL map for every bundled face. Most consumers use
+ * {@link superdocFonts} or {@link resolveBundledFontAssetUrl} instead of reading this directly.
+ *
+ * @beta
+ */
+export { BUNDLED_FONT_ASSET_URLS };
+/**
+ * Resolve a bundled substitute face filename to a bundler-emitted URL.
+ *
+ * Pass as SuperDoc's `fonts.resolveAssetUrl` so the reviewed fallback pack loads from THIS
+ * package's emitted assets, with no manual copy step and no `assetBaseUrl`:
+ *
+ *     import { resolveBundledFontAssetUrl } from '@superdoc-dev/fonts';
+ *     new SuperDoc({ selector: '#editor', document, fonts: { resolveAssetUrl: resolveBundledFontAssetUrl } });
+ *
+ * Throws on an unknown file, which signals a version mismatch between `@superdoc-dev/fonts` and
+ * the `superdoc` core manifest rather than silently degrading to the logical font name.
+ *
+ * @beta
+ */
+export function resolveBundledFontAssetUrl(context) {
+    const url = BUNDLED_FONT_ASSET_URLS[context.file];
+    if (!url) {
+        throw new Error(`[@superdoc-dev/fonts] no bundled asset for "${context.file}". This pack ships ` +
+            `${Object.keys(BUNDLED_FONT_ASSET_URLS).length} faces; the file is unknown, so ` +
+            `@superdoc-dev/fonts and superdoc are likely version-mismatched. Align their versions.`);
+    }
+    return url;
+}
+/**
+ * Drop-in value for SuperDoc's `fonts` config: `new SuperDoc({ fonts: superdocFonts })`.
+ * Equivalent to `{ resolveAssetUrl: resolveBundledFontAssetUrl }`.
+ *
+ * @beta
+ */
+export const superdocFonts = {
+    resolveAssetUrl: resolveBundledFontAssetUrl,
+};
+/**
+ * Build a curated `fonts` config: the bundled pack, narrowed to the families you choose.
+ *
+ *     import { createSuperDocFonts } from '@superdoc-dev/fonts';
+ *     new SuperDoc({
+ *       selector: '#editor',
+ *       document,
+ *       fonts: createSuperDocFonts({ exclude: ['Cooper Black', 'Brush Script MT'] }),
+ *     });
+ *
+ * Names are Word logical families. Pass neither `include` nor `exclude` for the full pack - that is
+ * exactly {@link superdocFonts}. Curation governs the BUNDLED pack only; your own licensed fonts stay
+ * separate (`fonts.families` / `fonts.map`).
+ *
+ * @beta
+ */
+export function createSuperDocFonts(options = {}) {
+    const include = normalizeNameList(options.include, 'include');
+    const exclude = normalizeNameList(options.exclude, 'exclude');
+    // include and exclude are mutually exclusive intents; accepting both silently would hide which one
+    // wins. Reject at the API boundary (this runs in the consumer's setup code, so it fails fast and
+    // clearly) rather than picking one arbitrarily.
+    if (include && exclude) {
+        throw new Error('[@superdoc-dev/fonts] createSuperDocFonts: pass `include` OR `exclude`, not both. ' +
+            '`include` is an allow-list (only those families resolve and appear in the toolbar); ' +
+            '`exclude` keeps everything but the named families.');
+    }
+    // Reject names SuperDoc does not bundle. This runs in the consumer's setup code, so it fails fast
+    // and clearly - especially for `include`, where a typo would otherwise silently hide the fonts the
+    // consumer meant to keep. (Raw `fonts.bundled` set directly stays lenient and only warns.)
+    if (include)
+        assertKnownFamilies(include, 'include');
+    if (exclude)
+        assertKnownFamilies(exclude, 'exclude');
+    const config = { resolveAssetUrl: resolveBundledFontAssetUrl };
+    if (include)
+        config.bundled = { include };
+    else if (exclude)
+        config.bundled = { exclude };
+    return config;
+}
+/** Validate and clean a curation list: an array of non-empty strings, or omitted. Throws on misuse. */
+function normalizeNameList(value, field) {
+    if (value == null)
+        return undefined;
+    if (!Array.isArray(value)) {
+        throw new Error(`[@superdoc-dev/fonts] createSuperDocFonts: \`${field}\` must be an array of Word font names.`);
+    }
+    const names = value.map((name) => (typeof name === 'string' ? name.trim() : '')).filter(Boolean);
+    if (names.length !== value.length) {
+        throw new Error(`[@superdoc-dev/fonts] createSuperDocFonts: \`${field}\` must contain only non-empty font name strings ` +
+            `(e.g. ["Calibri", "Cambria"]).`);
+    }
+    return names.length ? names : undefined;
+}
+/** Normalize a family name for matching: trim, strip surrounding quotes, lowercase. */
+function normalizeKey(name) {
+    return name
+        .trim()
+        .replace(/^["']|["']$/g, '')
+        .toLowerCase();
+}
+const KNOWN_FAMILY_KEYS = new Set(BUNDLED_FAMILY_NAMES.map(normalizeKey));
+/** Bounded Levenshtein distance between two short strings, for a "did you mean" hint on a typo. */
+function editDistance(a, b) {
+    const m = a.length;
+    const n = b.length;
+    if (Math.abs(m - n) > 2)
+        return 3;
+    let prev = Array.from({ length: n + 1 }, (_, i) => i);
+    for (let i = 1; i <= m; i += 1) {
+        const curr = [i];
+        for (let j = 1; j <= n; j += 1) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            curr[j] = Math.min(curr[j - 1] + 1, prev[j] + 1, prev[j - 1] + cost);
+        }
+        prev = curr;
+    }
+    return prev[n];
+}
+/** The closest bundled family within edit distance 2, or null - so a typo gets a concrete suggestion. */
+function closestKnownFamily(name) {
+    const key = normalizeKey(name);
+    let best = null;
+    let bestDist = 3;
+    for (const family of BUNDLED_FAMILY_NAMES) {
+        const dist = editDistance(key, normalizeKey(family));
+        if (dist < bestDist) {
+            bestDist = dist;
+            best = family;
+        }
+    }
+    return best;
+}
+/** Throw on any curation name SuperDoc does not bundle, with a suggestion and the full valid list. */
+function assertKnownFamilies(names, field) {
+    const unknown = names.filter((name) => !KNOWN_FAMILY_KEYS.has(normalizeKey(name)));
+    if (unknown.length === 0)
+        return;
+    const hints = unknown.map((name) => {
+        const suggestion = closestKnownFamily(name);
+        return suggestion ? `"${name}" (did you mean "${suggestion}"?)` : `"${name}"`;
+    });
+    throw new Error(`[@superdoc-dev/fonts] createSuperDocFonts: \`${field}\` names a font SuperDoc does not bundle: ${hints.join(', ')}. ` +
+        `Curate by Word family name. Bundled families: ${BUNDLED_FAMILY_NAMES.join(', ')}.`);
+}