pptx-ts 0.0.1

package/dist/units-1kRzYShk.js

@@ -0,0 +1,231 @@
+import { n as InvalidOptionError } from "./errors-Bvln0H-7.js";
+//#region src/diagnostics.ts
+/** Prefix stamped on every warning so consumers can attribute console noise to this library. */
+const WARN_PREFIX = "ts-pptx";
+/** The default handler: one `console.warn` line per diagnostic, prefixed. */
+const consoleHandler = (diagnostic) => {
+	console.warn(`${WARN_PREFIX}: ${diagnostic.message}`);
+};
+let handler = consoleHandler;
+/**
+* Route every library diagnostic to `handler`, or pass `null` to restore the default
+* (one prefixed `console.warn` per diagnostic).
+*
+* This is process-global rather than per-presentation, deliberately: the emitting code is a tree
+* of free functions in `gen/**` with no presentation in scope, and threading a handler through
+* every signature would be a far larger and worse change than the problem warrants. The practical
+* consequence is that a process building several decks concurrently cannot attribute a diagnostic
+* to one of them; if that matters, correlate on `code` or set the handler around each build.
+*
+* A throwing handler propagates out of whatever library call emitted the diagnostic, which is the
+* supported way to make a specific condition fatal:
+*
+* ```ts
+* setDiagnosticHandler((d) => {
+*   if (d.code === 'coord/bare-number-is-inches') throw new Error(d.message)
+* })
+* ```
+* @param next - the receiver, or `null` to restore the console default
+*/
+function setDiagnosticHandler(next) {
+	handler = next ?? consoleHandler;
+}
+/**
+* Emit a library diagnostic.
+* @param code - the stable condition identifier ({@link DiagnosticCode})
+* @param message - explanation, without a `ts-pptx:` prefix (the default handler adds one)
+* @param detail - optional structured context
+*/
+function warn(code, message, detail) {
+	handler(detail === void 0 ? {
+		code,
+		message
+	} : {
+		code,
+		message,
+		detail
+	});
+}
+const seen = /* @__PURE__ */ new Set();
+/**
+* Emit a library diagnostic at most once per distinct code+message.
+*
+* "Once" is **process-global**, the same scope {@link setDiagnosticHandler} has and for the
+* same reason: the emitting code is a tree of free functions in `gen/**` with no presentation
+* in scope. The consequence is different, though, and worth stating on its own — a process that
+* builds several decks does not get a second report of a condition an earlier deck already
+* tripped, so the second deck's diagnostics are incomplete rather than merely unattributed.
+* {@link resetDiagnosticState} is how a host that cares gets each build a clean slate.
+*
+* @param code - the stable condition identifier ({@link DiagnosticCode})
+* @param message - explanation (see {@link warn})
+* @param detail - optional structured context
+*/
+function warnOnce(code, message, detail) {
+	const key = `${code}\0${message}`;
+	if (seen.has(key)) return;
+	seen.add(key);
+	warn(code, message, detail);
+}
+/**
+* Clear the {@link warnOnce} dedupe set, so a condition already reported reports again.
+*
+* Call it between builds in a host that builds more than one deck per process and wants each
+* build's diagnostics complete. Without it, deck two is silent about anything deck one already
+* warned for, which reads as "no problems found" rather than as "already mentioned".
+*
+* It also bounds the set. Most `warnOnce` messages interpolate the offending value, so a server
+* building decks from user input accumulates one entry per distinct bad value with no way to
+* release them.
+*
+* This does not touch the handler — {@link setDiagnosticHandler} owns that, and the two are
+* reset independently on purpose: a host usually installs its handler once and wants it to
+* survive.
+*/
+function resetDiagnosticState() {
+	seen.clear();
+}
+//#endregion
+//#region src/units.ts
+/**
+* Public unit conversion helpers and standard PowerPoint slide-layout constants.
+*/
+const EMU_PER_INCH = 914400;
+const EMU_PER_POINT = 12700;
+const POINTS_PER_INCH = 72;
+/**
+* DrawingML angle unit. `ST_Angle` (`rot`, shadow `dir`, gradient `ang`, …) is measured in
+* sixtieths-of-a-thousandth of a degree, i.e. 60000 units per degree. Multiply a value in
+* degrees by this to get the OOXML integer.
+*/
+const ANGLE_UNITS_PER_DEGREE = 6e4;
+/**
+* DrawingML fixed-point percentage scale. `ST_Percentage` / `ST_PositiveFixedPercentage` and
+* related types (`<a:alpha>`, `<a:spcPct>`, shape adjustment guides, `<p:tav tm>`, …) encode
+* 100% as the integer 100000. Multiply a 0-1 fraction by this to get the OOXML value.
+*/
+const PERCENT_SCALE = 1e5;
+/**
+* Scale for a percentage supplied as 0-100 (rather than a 0-1 fraction) into the same
+* fixed-point percentage integer as {@link PERCENT_SCALE} (1% = 1000 units, i.e. thousandths
+* of a percent). Use for inputs documented as percents: transparency/alpha, image crop insets,
+* gradient stops, bullet size, connector adjust, etc.
+*/
+const FIXED_PCT_PER_PERCENT = PERCENT_SCALE / 100;
+/**
+* DrawingML text measures font size (`sz`), character spacing (`spc`) and point line/paragraph
+* spacing (`<a:spcPts val>`) in hundredths of a point. Multiply a value in points by this to get
+* the OOXML integer.
+*/
+const HUNDREDTHS_PER_POINT = 100;
+/**
+* Convert a value in points to hundredths of a point (rounded), the integer unit DrawingML uses
+* for `sz`, `spc`, and `<a:spcPts val>`. See {@link HUNDREDTHS_PER_POINT}.
+*/
+function ptToHundredths(pt) {
+	assertFiniteNumber(pt, "points");
+	return Math.round(pt * 100);
+}
+/** A bare number larger than this (in inches) is almost certainly a mistake — likely a raw EMU
+*  value passed where inches are expected. We interpret it as inches (the documented contract) but
+*  warn, pointing at the explicit `"<n>emu"` form. ~1000in is far beyond any real slide. */
+const IMPLAUSIBLE_INCHES = 1e3;
+/** Default pixel density for the `"<n>px"` coordinate unit: CSS reference pixels, also the
+*  density ts-pptx assumes when reading an image header's pixel dimensions. */
+const DEFAULT_PX_PER_INCH = 96;
+function inchesToEmu(inches) {
+	assertFiniteNumber(inches, "inches");
+	return Math.round(inches * EMU_PER_INCH);
+}
+function pointsToEmu(points) {
+	assertFiniteNumber(points, "points");
+	return Math.round(points * EMU_PER_POINT);
+}
+function pixelsToEmu(pixels, dpi) {
+	assertFiniteNumber(pixels, "pixels");
+	assertPositiveFiniteNumber(dpi, "dpi");
+	return inchesToEmu(pixels / dpi);
+}
+/**
+* Resolve a percentage of an axis length to EMU.
+* @param percent - percentage value (e.g. `50` for 50%)
+* @param axisEmu - the axis length in EMU (slide width for x/w, height for y/h)
+*/
+function percentToEmu(percent, axisEmu) {
+	assertFiniteNumber(percent, "percent");
+	assertFiniteNumber(axisEmu, "axisEmu");
+	return Math.round(percent / 100 * axisEmu);
+}
+/**
+* The single user-coordinate → EMU boundary. Convert each user-supplied coordinate exactly once.
+*
+* Accepts (see {@link Coord}):
+* - a bare `number` → **always inches** (the documented unit); no magnitude guessing
+* - `"<n>%"` → percentage of `axisEmu`
+* - `"<n>in"` / `"<n>pt"` / `"<n>px"` / `"<n>emu"` → explicit units (the escape hatch for non-inch
+*   values). `px` is resolved at {@link DEFAULT_PX_PER_INCH} (96), for authoring against a known
+*   web/source canvas size.
+*
+* Throws on non-finite or unparseable input rather than silently emitting a degenerate 0-size.
+* @param value - user coordinate
+* @param axisEmu - axis length in EMU, used only to resolve percentages
+*/
+function coordToEmu(value, axisEmu) {
+	if (typeof value === "number") {
+		assertFiniteNumber(value, "coordinate");
+		if (Math.abs(value) > IMPLAUSIBLE_INCHES) warn("coord/bare-number-is-inches", `coordinate ${value} interpreted as ${value} inches. A bare number is always inches; if you meant EMU, pass it as a string like "${Math.round(value)}emu".`);
+		return inchesToEmu(value);
+	}
+	const match = /^\s*(-?\d*\.?\d+)\s*(%|in|pt|px|emu)\s*$/.exec(value);
+	if (!match) throw new InvalidOptionError("coord/invalid-format", `Invalid coordinate "${value}". Expected a number (inches) or a string like "50%", "5in", "72pt", "96px", or "914400emu".`);
+	const n = Number(match[1]);
+	switch (match[2]) {
+		case "%": return percentToEmu(n, axisEmu);
+		case "in": return inchesToEmu(n);
+		case "pt": return pointsToEmu(n);
+		case "px": return pixelsToEmu(n, 96);
+		default:
+			assertFiniteNumber(n, "coordinate");
+			return Math.round(n);
+	}
+}
+function emuToInches(emu) {
+	assertFiniteNumber(emu, "emu");
+	return emu / EMU_PER_INCH;
+}
+function emuToPoints(emu) {
+	assertFiniteNumber(emu, "emu");
+	return emu / EMU_PER_POINT;
+}
+function emuToPixels(emu, dpi) {
+	assertFiniteNumber(emu, "emu");
+	assertPositiveFiniteNumber(dpi, "dpi");
+	return Math.round(emuToInches(emu) * dpi);
+}
+function standardLayout(layout, name, widthIn, heightIn) {
+	return Object.freeze({
+		layout,
+		name,
+		widthIn,
+		heightIn,
+		widthEmu: inchesToEmu(widthIn),
+		heightEmu: inchesToEmu(heightIn)
+	});
+}
+const STANDARD_LAYOUTS = Object.freeze({
+	LAYOUT_4x3: standardLayout("LAYOUT_4x3", "screen4x3", 10, 7.5),
+	LAYOUT_16x9: standardLayout("LAYOUT_16x9", "screen16x9", 10, 5.625),
+	LAYOUT_16x10: standardLayout("LAYOUT_16x10", "screen16x10", 10, 6.25),
+	LAYOUT_WIDE: standardLayout("LAYOUT_WIDE", "custom", 40 / 3, 7.5)
+});
+function assertFiniteNumber(value, name) {
+	if (!Number.isFinite(value)) throw new InvalidOptionError("coord/non-finite", `${name} must be a finite number`);
+}
+function assertPositiveFiniteNumber(value, name) {
+	assertFiniteNumber(value, name);
+	if (value <= 0) throw new InvalidOptionError("coord/not-positive", `${name} must be greater than 0`);
+}
+//#endregion
+export { warnOnce as S, pointsToEmu as _, FIXED_PCT_PER_PERCENT as a, setDiagnosticHandler as b, POINTS_PER_INCH as c, emuToInches as d, emuToPixels as f, pixelsToEmu as g, percentToEmu as h, EMU_PER_POINT as i, STANDARD_LAYOUTS as l, inchesToEmu as m, DEFAULT_PX_PER_INCH as n, HUNDREDTHS_PER_POINT as o, emuToPoints as p, EMU_PER_INCH as r, PERCENT_SCALE as s, ANGLE_UNITS_PER_DEGREE as t, coordToEmu as u, ptToHundredths as v, warn as x, resetDiagnosticState as y };
+
+//# sourceMappingURL=units-1kRzYShk.js.map

package/dist/units-1kRzYShk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"units-1kRzYShk.js","names":[],"sources":["../src/diagnostics.ts","../src/units.ts"],"sourcesContent":["/**\n * Central sink for library diagnostics.\n *\n * Every user-facing warning is routed through {@link warn} / {@link warnOnce} rather than calling\n * `console.warn` directly, so there is one place to apply a consistent prefix and one place a\n * consumer can take over — see {@link setDiagnosticHandler}. This module has no *runtime* imports\n * so it can be used from anywhere without risking an import cycle; `codes.ts` is types only and is\n * erased at compile time, so it does not cost that property.\n *\n * **A diagnostic's `code` is API; its `message` is not.** The code is a stable identifier a\n * consumer may branch on (`if (d.code === 'chart/non-finite-value')`); the wording behind it is\n * free to improve in any release. The vocabulary lives in `codes.ts` and is shared with the thrown\n * surface (`errors.ts`), so a condition that can both warn and throw reads the same either way.\n */\n\nimport type { DiagnosticCode } from './codes.js'\n\nexport type { DiagnosticCode }\n\n/** One diagnostic emitted by the library. */\nexport interface Diagnostic {\n\t/** Stable condition identifier — see {@link DiagnosticCode}. Branch on this, not on the text. */\n\treadonly code: DiagnosticCode\n\t/** Human-readable explanation. Free to change in any release; do not parse it. */\n\treadonly message: string\n\t/**\n\t * Structured context for the condition, when a site has any to give. No site populates it\n\t * today; it exists so one can start to without a breaking signature change.\n\t */\n\treadonly detail?: Readonly<Record<string, unknown>>\n}\n\n/** Receives every {@link Diagnostic} the library emits. See {@link setDiagnosticHandler}. */\nexport type DiagnosticHandler = (diagnostic: Diagnostic) => void\n\n/** Prefix stamped on every warning so consumers can attribute console noise to this library. */\nconst WARN_PREFIX = 'ts-pptx'\n\n/** The default handler: one `console.warn` line per diagnostic, prefixed. */\nconst consoleHandler: DiagnosticHandler = (diagnostic) => {\n\tconsole.warn(`${WARN_PREFIX}: ${diagnostic.message}`)\n}\n\nlet handler: DiagnosticHandler = consoleHandler\n\n/**\n * Route every library diagnostic to `handler`, or pass `null` to restore the default\n * (one prefixed `console.warn` per diagnostic).\n *\n * This is process-global rather than per-presentation, deliberately: the emitting code is a tree\n * of free functions in `gen/**` with no presentation in scope, and threading a handler through\n * every signature would be a far larger and worse change than the problem warrants. The practical\n * consequence is that a process building several decks concurrently cannot attribute a diagnostic\n * to one of them; if that matters, correlate on `code` or set the handler around each build.\n *\n * A throwing handler propagates out of whatever library call emitted the diagnostic, which is the\n * supported way to make a specific condition fatal:\n *\n * ```ts\n * setDiagnosticHandler((d) => {\n *   if (d.code === 'coord/bare-number-is-inches') throw new Error(d.message)\n * })\n * ```\n * @param next - the receiver, or `null` to restore the console default\n */\nexport function setDiagnosticHandler(next: DiagnosticHandler | null): void {\n\thandler = next ?? consoleHandler\n}\n\n/**\n * Emit a library diagnostic.\n * @param code - the stable condition identifier ({@link DiagnosticCode})\n * @param message - explanation, without a `ts-pptx:` prefix (the default handler adds one)\n * @param detail - optional structured context\n */\nexport function warn(code: DiagnosticCode, message: string, detail?: Readonly<Record<string, unknown>>): void {\n\thandler(detail === undefined ? { code, message } : { code, message, detail })\n}\n\n// Track diagnostics already emitted so a recurring condition (e.g. the same out-of-range fontSize\n// on every cell of a table) is reported once instead of flooding the handler. Keyed on code AND\n// message, so a *different* offending value under the same code still reports.\nconst seen = new Set<string>()\n\n/**\n * Emit a library diagnostic at most once per distinct code+message.\n *\n * \"Once\" is **process-global**, the same scope {@link setDiagnosticHandler} has and for the\n * same reason: the emitting code is a tree of free functions in `gen/**` with no presentation\n * in scope. The consequence is different, though, and worth stating on its own — a process that\n * builds several decks does not get a second report of a condition an earlier deck already\n * tripped, so the second deck's diagnostics are incomplete rather than merely unattributed.\n * {@link resetDiagnosticState} is how a host that cares gets each build a clean slate.\n *\n * @param code - the stable condition identifier ({@link DiagnosticCode})\n * @param message - explanation (see {@link warn})\n * @param detail - optional structured context\n */\nexport function warnOnce(code: DiagnosticCode, message: string, detail?: Readonly<Record<string, unknown>>): void {\n\tconst key = `${code}\\0${message}`\n\tif (seen.has(key)) return\n\tseen.add(key)\n\twarn(code, message, detail)\n}\n\n/**\n * Clear the {@link warnOnce} dedupe set, so a condition already reported reports again.\n *\n * Call it between builds in a host that builds more than one deck per process and wants each\n * build's diagnostics complete. Without it, deck two is silent about anything deck one already\n * warned for, which reads as \"no problems found\" rather than as \"already mentioned\".\n *\n * It also bounds the set. Most `warnOnce` messages interpolate the offending value, so a server\n * building decks from user input accumulates one entry per distinct bad value with no way to\n * release them.\n *\n * This does not touch the handler — {@link setDiagnosticHandler} owns that, and the two are\n * reset independently on purpose: a host usually installs its handler once and wants it to\n * survive.\n */\nexport function resetDiagnosticState(): void {\n\tseen.clear()\n}\n","import { warn } from './diagnostics.js'\nimport { InvalidOptionError } from './errors.js'\n/**\n * Public unit conversion helpers and standard PowerPoint slide-layout constants.\n */\n\nexport const EMU_PER_INCH = 914400\nexport const EMU_PER_POINT = 12700\nexport const POINTS_PER_INCH = 72\n\n/**\n * DrawingML angle unit. `ST_Angle` (`rot`, shadow `dir`, gradient `ang`, …) is measured in\n * sixtieths-of-a-thousandth of a degree, i.e. 60000 units per degree. Multiply a value in\n * degrees by this to get the OOXML integer.\n */\nexport const ANGLE_UNITS_PER_DEGREE = 60000\n\n/**\n * DrawingML fixed-point percentage scale. `ST_Percentage` / `ST_PositiveFixedPercentage` and\n * related types (`<a:alpha>`, `<a:spcPct>`, shape adjustment guides, `<p:tav tm>`, …) encode\n * 100% as the integer 100000. Multiply a 0-1 fraction by this to get the OOXML value.\n */\nexport const PERCENT_SCALE = 100000\n\n/**\n * Scale for a percentage supplied as 0-100 (rather than a 0-1 fraction) into the same\n * fixed-point percentage integer as {@link PERCENT_SCALE} (1% = 1000 units, i.e. thousandths\n * of a percent). Use for inputs documented as percents: transparency/alpha, image crop insets,\n * gradient stops, bullet size, connector adjust, etc.\n */\nexport const FIXED_PCT_PER_PERCENT = PERCENT_SCALE / 100\n\n/**\n * DrawingML text measures font size (`sz`), character spacing (`spc`) and point line/paragraph\n * spacing (`<a:spcPts val>`) in hundredths of a point. Multiply a value in points by this to get\n * the OOXML integer.\n */\nexport const HUNDREDTHS_PER_POINT = 100\n\n/**\n * Convert a value in points to hundredths of a point (rounded), the integer unit DrawingML uses\n * for `sz`, `spc`, and `<a:spcPts val>`. See {@link HUNDREDTHS_PER_POINT}.\n */\nexport function ptToHundredths(pt: number): number {\n\tassertFiniteNumber(pt, 'points')\n\treturn Math.round(pt * HUNDREDTHS_PER_POINT)\n}\n\n/**\n * English Metric Units — the integer unit OOXML serializes geometry in (914400 per inch).\n *\n * Branded so a value that has already been resolved to EMU cannot be silently fed back into a\n * unit converter: {@link coordToEmu} only accepts a user `Coord`, so passing an `Emu` into it is\n * a compile-time error. This replaces the old runtime \"a number ≥ 100 must already be EMU\"\n * magnitude guess, which silently mis-rendered values near the threshold.\n */\nexport type Emu = number & { readonly __unit: 'emu' }\n\n/** A bare number larger than this (in inches) is almost certainly a mistake — likely a raw EMU\n *  value passed where inches are expected. We interpret it as inches (the documented contract) but\n *  warn, pointing at the explicit `\"<n>emu\"` form. ~1000in is far beyond any real slide. */\nconst IMPLAUSIBLE_INCHES = 1000\n\n/** Default pixel density for the `\"<n>px\"` coordinate unit: CSS reference pixels, also the\n *  density ts-pptx assumes when reading an image header's pixel dimensions. */\nexport const DEFAULT_PX_PER_INCH = 96\n\nexport type StandardLayoutName = 'LAYOUT_4x3' | 'LAYOUT_16x9' | 'LAYOUT_16x10' | 'LAYOUT_WIDE'\n\nexport interface StandardLayout {\n\t/** ts-pptx layout key used with `pptx.layout`. */\n\treadonly layout: StandardLayoutName\n\t/** PresentationML slide-size preset name, or `custom` for PowerPoint widescreen. */\n\treadonly name: string\n\t/** Slide width in inches — inches is ts-pptx's default coordinate unit, so this is the value to use for `addText`/`addShape` math. */\n\treadonly widthIn: number\n\t/** Slide height in inches. */\n\treadonly heightIn: number\n\t/** Slide width in English Metric Units. */\n\treadonly widthEmu: number\n\t/** Slide height in English Metric Units. */\n\treadonly heightEmu: number\n}\n\nexport function inchesToEmu(inches: number): Emu {\n\tassertFiniteNumber(inches, 'inches')\n\treturn Math.round(inches * EMU_PER_INCH) as Emu\n}\n\nexport function pointsToEmu(points: number): Emu {\n\tassertFiniteNumber(points, 'points')\n\treturn Math.round(points * EMU_PER_POINT) as Emu\n}\n\nexport function pixelsToEmu(pixels: number, dpi: number): Emu {\n\tassertFiniteNumber(pixels, 'pixels')\n\tassertPositiveFiniteNumber(dpi, 'dpi')\n\treturn inchesToEmu(pixels / dpi)\n}\n\n/**\n * Resolve a percentage of an axis length to EMU.\n * @param percent - percentage value (e.g. `50` for 50%)\n * @param axisEmu - the axis length in EMU (slide width for x/w, height for y/h)\n */\nexport function percentToEmu(percent: number, axisEmu: number): Emu {\n\tassertFiniteNumber(percent, 'percent')\n\tassertFiniteNumber(axisEmu, 'axisEmu')\n\treturn Math.round((percent / 100) * axisEmu) as Emu\n}\n\n/**\n * The single user-coordinate → EMU boundary. Convert each user-supplied coordinate exactly once.\n *\n * Accepts (see {@link Coord}):\n * - a bare `number` → **always inches** (the documented unit); no magnitude guessing\n * - `\"<n>%\"` → percentage of `axisEmu`\n * - `\"<n>in\"` / `\"<n>pt\"` / `\"<n>px\"` / `\"<n>emu\"` → explicit units (the escape hatch for non-inch\n *   values). `px` is resolved at {@link DEFAULT_PX_PER_INCH} (96), for authoring against a known\n *   web/source canvas size.\n *\n * Throws on non-finite or unparseable input rather than silently emitting a degenerate 0-size.\n * @param value - user coordinate\n * @param axisEmu - axis length in EMU, used only to resolve percentages\n */\nexport function coordToEmu(value: number | string, axisEmu: number): Emu {\n\tif (typeof value === 'number') {\n\t\tassertFiniteNumber(value, 'coordinate')\n\t\tif (Math.abs(value) > IMPLAUSIBLE_INCHES) {\n\t\t\twarn(\n\t\t\t\t'coord/bare-number-is-inches',\n\t\t\t\t`coordinate ${value} interpreted as ${value} inches. A bare number is always inches; ` +\n\t\t\t\t\t`if you meant EMU, pass it as a string like \"${Math.round(value)}emu\".`\n\t\t\t)\n\t\t}\n\t\treturn inchesToEmu(value)\n\t}\n\n\tconst match = /^\\s*(-?\\d*\\.?\\d+)\\s*(%|in|pt|px|emu)\\s*$/.exec(value)\n\tif (!match) {\n\t\tthrow new InvalidOptionError(\n\t\t\t'coord/invalid-format',\n\t\t\t`Invalid coordinate \"${value}\". Expected a number (inches) or a string like \"50%\", \"5in\", \"72pt\", \"96px\", or \"914400emu\".`\n\t\t)\n\t}\n\tconst n = Number(match[1])\n\tswitch (match[2]) {\n\t\tcase '%':\n\t\t\treturn percentToEmu(n, axisEmu)\n\t\tcase 'in':\n\t\t\treturn inchesToEmu(n)\n\t\tcase 'pt':\n\t\t\treturn pointsToEmu(n)\n\t\tcase 'px':\n\t\t\treturn pixelsToEmu(n, DEFAULT_PX_PER_INCH)\n\t\tdefault: // 'emu'\n\t\t\tassertFiniteNumber(n, 'coordinate')\n\t\t\treturn Math.round(n) as Emu\n\t}\n}\n\nexport function emuToInches(emu: number): number {\n\tassertFiniteNumber(emu, 'emu')\n\treturn emu / EMU_PER_INCH\n}\n\nexport function emuToPoints(emu: number): number {\n\tassertFiniteNumber(emu, 'emu')\n\treturn emu / EMU_PER_POINT\n}\n\nexport function emuToPixels(emu: number, dpi: number): number {\n\tassertFiniteNumber(emu, 'emu')\n\tassertPositiveFiniteNumber(dpi, 'dpi')\n\treturn Math.round(emuToInches(emu) * dpi)\n}\n\nfunction standardLayout(layout: StandardLayoutName, name: string, widthIn: number, heightIn: number): StandardLayout {\n\treturn Object.freeze({\n\t\tlayout,\n\t\tname,\n\t\twidthIn,\n\t\theightIn,\n\t\twidthEmu: inchesToEmu(widthIn),\n\t\theightEmu: inchesToEmu(heightIn),\n\t})\n}\n\nexport const STANDARD_LAYOUTS: Readonly<Record<StandardLayoutName, StandardLayout>> = Object.freeze({\n\tLAYOUT_4x3: standardLayout('LAYOUT_4x3', 'screen4x3', 10, 7.5),\n\tLAYOUT_16x9: standardLayout('LAYOUT_16x9', 'screen16x9', 10, 5.625),\n\tLAYOUT_16x10: standardLayout('LAYOUT_16x10', 'screen16x10', 10, 6.25),\n\tLAYOUT_WIDE: standardLayout('LAYOUT_WIDE', 'custom', 40 / 3, 7.5),\n})\n\nfunction assertFiniteNumber(value: number, name: string): void {\n\tif (!Number.isFinite(value)) throw new InvalidOptionError('coord/non-finite', `${name} must be a finite number`)\n}\n\nfunction assertPositiveFiniteNumber(value: number, name: string): void {\n\tassertFiniteNumber(value, name)\n\tif (value <= 0) throw new InvalidOptionError('coord/not-positive', `${name} must be greater than 0`)\n}\n"],"mappings":"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"}