@stll/folio-core 0.3.1 → 0.5.0

package/dist/symbols.js

@@ -0,0 +1,512 @@
+//#region src/symbols.ts
+const SYMBOL_CATEGORIES = [
+	{
+		name: "Common",
+		nameKey: "dialogs.insertSymbol.categories.common",
+		symbols: [
+			{
+				char: "©",
+				name: "Copyright"
+			},
+			{
+				char: "®",
+				name: "Registered"
+			},
+			{
+				char: "™",
+				name: "Trademark"
+			},
+			{
+				char: "•",
+				name: "Bullet"
+			},
+			{
+				char: "…",
+				name: "Ellipsis"
+			},
+			{
+				char: "—",
+				name: "Em dash"
+			},
+			{
+				char: "–",
+				name: "En dash"
+			},
+			{
+				char: "±",
+				name: "Plus-minus"
+			},
+			{
+				char: "×",
+				name: "Multiply"
+			},
+			{
+				char: "÷",
+				name: "Divide"
+			},
+			{
+				char: "≠",
+				name: "Not equal"
+			},
+			{
+				char: "≈",
+				name: "Approximately"
+			},
+			{
+				char: "≤",
+				name: "Less or equal"
+			},
+			{
+				char: "≥",
+				name: "Greater or equal"
+			},
+			{
+				char: "°",
+				name: "Degree"
+			},
+			{
+				char: "µ",
+				name: "Micro"
+			},
+			{
+				char: "¶",
+				name: "Pilcrow"
+			},
+			{
+				char: "§",
+				name: "Section"
+			},
+			{
+				char: "†",
+				name: "Dagger"
+			},
+			{
+				char: "‡",
+				name: "Double dagger"
+			},
+			{
+				char: "¿",
+				name: "Inverted question"
+			},
+			{
+				char: "¡",
+				name: "Inverted exclamation"
+			},
+			{
+				char: "‰",
+				name: "Per mille"
+			},
+			{
+				char: "∞",
+				name: "Infinity"
+			}
+		]
+	},
+	{
+		name: "Arrows",
+		nameKey: "dialogs.insertSymbol.categories.arrows",
+		symbols: [
+			{
+				char: "←",
+				name: "Left"
+			},
+			{
+				char: "→",
+				name: "Right"
+			},
+			{
+				char: "↑",
+				name: "Up"
+			},
+			{
+				char: "↓",
+				name: "Down"
+			},
+			{
+				char: "↔",
+				name: "Left-right"
+			},
+			{
+				char: "↕",
+				name: "Up-down"
+			},
+			{
+				char: "⇐",
+				name: "Double left"
+			},
+			{
+				char: "⇒",
+				name: "Double right"
+			},
+			{
+				char: "⇑",
+				name: "Double up"
+			},
+			{
+				char: "⇓",
+				name: "Double down"
+			},
+			{
+				char: "⇔",
+				name: "Double left-right"
+			},
+			{
+				char: "➡",
+				name: "Heavy right"
+			},
+			{
+				char: "↩",
+				name: "Return"
+			},
+			{
+				char: "↪",
+				name: "Curved right"
+			},
+			{
+				char: "↻",
+				name: "Clockwise"
+			},
+			{
+				char: "↺",
+				name: "Counter-clockwise"
+			}
+		]
+	},
+	{
+		name: "Math",
+		nameKey: "dialogs.insertSymbol.categories.math",
+		symbols: [
+			{
+				char: "∑",
+				name: "Summation"
+			},
+			{
+				char: "∏",
+				name: "Product"
+			},
+			{
+				char: "∫",
+				name: "Integral"
+			},
+			{
+				char: "√",
+				name: "Square root"
+			},
+			{
+				char: "∂",
+				name: "Partial diff"
+			},
+			{
+				char: "∇",
+				name: "Nabla"
+			},
+			{
+				char: "∈",
+				name: "Element of"
+			},
+			{
+				char: "∉",
+				name: "Not element"
+			},
+			{
+				char: "⊂",
+				name: "Subset"
+			},
+			{
+				char: "⊃",
+				name: "Superset"
+			},
+			{
+				char: "∪",
+				name: "Union"
+			},
+			{
+				char: "∩",
+				name: "Intersection"
+			},
+			{
+				char: "∧",
+				name: "And"
+			},
+			{
+				char: "∨",
+				name: "Or"
+			},
+			{
+				char: "¬",
+				name: "Not"
+			},
+			{
+				char: "∀",
+				name: "For all"
+			},
+			{
+				char: "∃",
+				name: "Exists"
+			},
+			{
+				char: "∅",
+				name: "Empty set"
+			},
+			{
+				char: "∝",
+				name: "Proportional"
+			},
+			{
+				char: "∠",
+				name: "Angle"
+			}
+		]
+	},
+	{
+		name: "Greek",
+		nameKey: "dialogs.insertSymbol.categories.greek",
+		symbols: [
+			{
+				char: "α",
+				name: "alpha"
+			},
+			{
+				char: "β",
+				name: "beta"
+			},
+			{
+				char: "γ",
+				name: "gamma"
+			},
+			{
+				char: "δ",
+				name: "delta"
+			},
+			{
+				char: "ε",
+				name: "epsilon"
+			},
+			{
+				char: "ζ",
+				name: "zeta"
+			},
+			{
+				char: "η",
+				name: "eta"
+			},
+			{
+				char: "θ",
+				name: "theta"
+			},
+			{
+				char: "λ",
+				name: "lambda"
+			},
+			{
+				char: "μ",
+				name: "mu"
+			},
+			{
+				char: "π",
+				name: "pi"
+			},
+			{
+				char: "ρ",
+				name: "rho"
+			},
+			{
+				char: "σ",
+				name: "sigma"
+			},
+			{
+				char: "τ",
+				name: "tau"
+			},
+			{
+				char: "φ",
+				name: "phi"
+			},
+			{
+				char: "ψ",
+				name: "psi"
+			},
+			{
+				char: "ω",
+				name: "omega"
+			},
+			{
+				char: "Δ",
+				name: "Delta"
+			},
+			{
+				char: "Σ",
+				name: "Sigma"
+			},
+			{
+				char: "Ω",
+				name: "Omega"
+			},
+			{
+				char: "Π",
+				name: "Pi"
+			},
+			{
+				char: "Φ",
+				name: "Phi"
+			},
+			{
+				char: "Ψ",
+				name: "Psi"
+			},
+			{
+				char: "Θ",
+				name: "Theta"
+			}
+		]
+	},
+	{
+		name: "Currency",
+		nameKey: "dialogs.insertSymbol.categories.currency",
+		symbols: [
+			{
+				char: "$",
+				name: "Dollar"
+			},
+			{
+				char: "€",
+				name: "Euro"
+			},
+			{
+				char: "£",
+				name: "Pound"
+			},
+			{
+				char: "¥",
+				name: "Yen"
+			},
+			{
+				char: "₹",
+				name: "Rupee"
+			},
+			{
+				char: "₽",
+				name: "Ruble"
+			},
+			{
+				char: "₩",
+				name: "Won"
+			},
+			{
+				char: "₿",
+				name: "Bitcoin"
+			},
+			{
+				char: "¢",
+				name: "Cent"
+			},
+			{
+				char: "₫",
+				name: "Dong"
+			},
+			{
+				char: "₺",
+				name: "Lira"
+			},
+			{
+				char: "₴",
+				name: "Hryvnia"
+			}
+		]
+	},
+	{
+		name: "Shapes",
+		nameKey: "dialogs.insertSymbol.categories.shapes",
+		symbols: [
+			{
+				char: "■",
+				name: "Black square"
+			},
+			{
+				char: "□",
+				name: "White square"
+			},
+			{
+				char: "▲",
+				name: "Up triangle"
+			},
+			{
+				char: "▼",
+				name: "Down triangle"
+			},
+			{
+				char: "●",
+				name: "Black circle"
+			},
+			{
+				char: "○",
+				name: "White circle"
+			},
+			{
+				char: "◆",
+				name: "Black diamond"
+			},
+			{
+				char: "◇",
+				name: "White diamond"
+			},
+			{
+				char: "★",
+				name: "Black star"
+			},
+			{
+				char: "☆",
+				name: "White star"
+			},
+			{
+				char: "♠",
+				name: "Spade"
+			},
+			{
+				char: "♥",
+				name: "Heart"
+			},
+			{
+				char: "♦",
+				name: "Diamond"
+			},
+			{
+				char: "♣",
+				name: "Club"
+			},
+			{
+				char: "✓",
+				name: "Check mark"
+			},
+			{
+				char: "✗",
+				name: "Ballot X"
+			},
+			{
+				char: "✦",
+				name: "Four pointed star"
+			},
+			{
+				char: "◌",
+				name: "Dotted circle"
+			}
+		]
+	}
+];
+/** Every catalog symbol, flattened and tagged with its category. */
+const ALL_SYMBOLS = SYMBOL_CATEGORIES.flatMap((category) => category.symbols.map((symbol) => ({
+	...symbol,
+	category: category.name
+})));
+/**
+* Symbols whose descriptive name contains `query` (case-insensitive), or whose
+* character is exactly `query`. An empty/whitespace query returns `[]` so
+* callers fall back to the active category.
+*/
+function filterSymbols(query) {
+	const q = query.trim().toLowerCase();
+	if (!q) return [];
+	return ALL_SYMBOLS.filter((symbol) => symbol.name.toLowerCase().includes(q) || symbol.char === q);
+}
+//#endregion
+export { ALL_SYMBOLS, SYMBOL_CATEGORIES, filterSymbols };

package/dist/utils/clipboard.js

@@ -86,7 +86,7 @@ async function copyRuns(runs, options = {}) {
 	try {
 		return await writeToClipboard(runsToClipboardContent(runs, includeFormatting));
 	} catch (error) {
-		onError?.(error);
+		onError?.(error instanceof Error ? error : new Error(String(error)));
 		return false;
 	}
 }
@@ -98,7 +98,7 @@ async function copyParagraphs(paragraphs, options = {}) {
 	try {
 		return await writeToClipboard(paragraphsToClipboardContent(paragraphs, includeFormatting));
 	} catch (error) {
-		onError?.(error);
+		onError?.(error instanceof Error ? error : new Error(String(error)));
 		return false;
 	}
 }
@@ -170,7 +170,7 @@ async function readFromClipboard(options = {}) {
 	try {
 		return await parseClipboardItems(await navigator.clipboard.read(), cleanWordFormatting);
 	} catch (error) {
-		onError?.(error);
+		onError?.(error instanceof Error ? error : new Error(String(error)));
 		return null;
 	}
 }

package/dist/utils/fontLoader.js

@@ -17,6 +17,8 @@ let isLoadingAny = false;
 * this map is used for font availability checks and preloading.
 */
 const FONT_MAPPING = {
+	Aptos: "Source Sans 3",
+	"Aptos Display": "Source Sans 3",
 	Calibri: "Carlito",
 	Cambria: "Caladea",
 	Arial: "Arimo",
@@ -38,6 +40,7 @@ const BUNDLED_FONTS = /* @__PURE__ */ new Set([
 	"Arimo",
 	"Tinos",
 	"Cousine",
+	"Source Sans 3",
 	"Calibri",
 	"Cambria",
 	"Arial",

package/dist/utils/fontResolver.js

@@ -44,6 +44,11 @@ const JP_MEASURED_LINE_HEIGHT = {
 	ratio: 1.303,
 	note: "Measured against real Word: 10.5pt Japanese body, non-grid section, renders at 13.68pt line pitch."
 };
+const APTOS_MEASURED_LINE_HEIGHT = {
+	source: "measured",
+	ratio: 1.2207,
+	note: "Measured against real Word: 11pt Aptos body, non-grid section, renders at 13.43pt line pitch."
+};
 /**
 * Mapping of common DOCX fonts to Google Fonts equivalents
 *
@@ -59,6 +64,30 @@ const JP_MEASURED_LINE_HEIGHT = {
 * ratios carried over unchanged, pending measurement.
 */
 const FONT_MAPPINGS = {
+	aptos: {
+		googleFont: "Source Sans 3",
+		category: "sans-serif",
+		fallbackStack: [
+			"Aptos",
+			"Source Sans 3",
+			"Arial",
+			"Helvetica",
+			"sans-serif"
+		],
+		singleLineRatio: singleLineRatioOf(APTOS_MEASURED_LINE_HEIGHT)
+	},
+	"aptos display": {
+		googleFont: "Source Sans 3",
+		category: "sans-serif",
+		fallbackStack: [
+			"Aptos Display",
+			"Source Sans 3",
+			"Arial",
+			"Helvetica",
+			"sans-serif"
+		],
+		singleLineRatio: singleLineRatioOf(APTOS_MEASURED_LINE_HEIGHT)
+	},
 	calibri: {
 		googleFont: "Carlito",
 		category: "sans-serif",
@@ -128,6 +157,23 @@ const FONT_MAPPINGS = {
 			unitsPerEm: 2048
 		})
 	},
+	"cg times": {
+		googleFont: "Tinos",
+		category: "serif",
+		fallbackStack: [
+			"Times New Roman",
+			"Tinos",
+			"Times",
+			"serif"
+		],
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 1825,
+			hheaDescent: -443,
+			hheaLineGap: 87,
+			unitsPerEm: 2048
+		})
+	},
 	"courier new": {
 		googleFont: "Cousine",
 		category: "monospace",
@@ -196,6 +242,23 @@ const FONT_MAPPINGS = {
 			unitsPerEm: 2048
 		})
 	},
+	montserrat: {
+		googleFont: "Montserrat",
+		category: "sans-serif",
+		fallbackStack: [
+			"Montserrat",
+			"Arial",
+			"Helvetica",
+			"sans-serif"
+		],
+		singleLineRatio: singleLineRatioOf({
+			source: "hhea",
+			hheaAscent: 968,
+			hheaDescent: -251,
+			hheaLineGap: 0,
+			unitsPerEm: 1e3
+		})
+	},
 	"trebuchet ms": {
 		googleFont: "Fira Sans",
 		category: "sans-serif",
@@ -742,7 +805,8 @@ function resolveFontFamily(docxFontName) {
 			singleLineRatio: mapping.singleLineRatio
 		};
 	}
-	const defaultFallback = DEFAULT_FALLBACKS[detectFontCategory(docxFontName)];
+	const category = detectFontCategory(docxFontName);
+	const defaultFallback = DEFAULT_FALLBACKS[category];
 	return {
 		googleFont: null,
 		cssFallback: withArabicFallback(`${quoteFontName(docxFontName)}, ${defaultFallback}`),

package/dist/utils/zoom.d.ts

@@ -0,0 +1,21 @@
+//#region src/utils/zoom.d.ts
+/**
+ * Canonical zoom limits shared by every folio adapter (React, Vue, ...).
+ *
+ * Adapters must source their zoom range from here rather than hard-coding their
+ * own, so the reachable zoom span stays identical across framework hosts.
+ * Historically React clamped 0.25-4x while Vue clamped 0.5-2x; this module is
+ * the single source of truth that keeps them from drifting again.
+ *
+ * Note: the discrete zoom-level menu each adapter shows in its toolbar dropdown
+ * is a separate, deliberately curated subset (50-200%); it is not derived from
+ * these limits.
+ */
+/** Minimum reachable zoom level (25%). */
+declare const ZOOM_MIN = 0.25;
+/** Maximum reachable zoom level (400%). */
+declare const ZOOM_MAX = 4;
+/** Step applied per zoom-in / zoom-out action and per keyboard shortcut. */
+declare const ZOOM_STEP = 0.1;
+//#endregion
+export { ZOOM_MAX, ZOOM_MIN, ZOOM_STEP };

package/dist/utils/zoom.js

@@ -0,0 +1,21 @@
+//#region src/utils/zoom.ts
+/**
+* Canonical zoom limits shared by every folio adapter (React, Vue, ...).
+*
+* Adapters must source their zoom range from here rather than hard-coding their
+* own, so the reachable zoom span stays identical across framework hosts.
+* Historically React clamped 0.25-4x while Vue clamped 0.5-2x; this module is
+* the single source of truth that keeps them from drifting again.
+*
+* Note: the discrete zoom-level menu each adapter shows in its toolbar dropdown
+* is a separate, deliberately curated subset (50-200%); it is not derived from
+* these limits.
+*/
+/** Minimum reachable zoom level (25%). */
+const ZOOM_MIN = .25;
+/** Maximum reachable zoom level (400%). */
+const ZOOM_MAX = 4;
+/** Step applied per zoom-in / zoom-out action and per keyboard shortcut. */
+const ZOOM_STEP = .1;
+//#endregion
+export { ZOOM_MAX, ZOOM_MIN, ZOOM_STEP };