@json-to-office/shared 0.13.2 → 0.21.0

package/dist/chunk-6KUQYVPT.js

@@ -0,0 +1,177 @@
+// src/schemas/font-catalog.ts
+import { Type } from "@sinclair/typebox";
+var SAFE_FONTS = [
+  "Arial",
+  "Calibri",
+  "Cambria",
+  "Consolas",
+  "Courier New",
+  "Georgia",
+  "Segoe UI",
+  "Tahoma",
+  "Times New Roman",
+  "Trebuchet MS",
+  "Verdana",
+  "Helvetica",
+  "Helvetica Neue",
+  "Menlo",
+  "Monaco"
+];
+function isSafeFont(name) {
+  const lower = name.toLowerCase();
+  return SAFE_FONTS.some((f) => f.toLowerCase() === lower);
+}
+var FontFamilyNameSchema = Type.String({
+  description: "Font family name. Prefer a SAFE_FONTS entry (Arial, Calibri, Cambria, Consolas, Courier New, Georgia, Segoe UI, Tahoma, Times New Roman, Trebuchet MS, Verdana, Helvetica, Helvetica Neue, Menlo, Monaco) for zero-setup rendering. For any other font, register it in props.fontRegistry[] and reference it here by family. Unregistered non-safe names render with a host fallback.",
+  examples: ["Arial", "Calibri", "Georgia", "Inter", "Roboto"]
+});
+var FontWeightSchema = Type.Number({
+  minimum: 100,
+  maximum: 900,
+  description: "OpenType weight (100 thin ... 900 black). Default 400."
+});
+var FontItalicSchema = Type.Boolean({
+  description: "Whether this source is italic. Default false."
+});
+var SafeFontSourceSchema = Type.Object(
+  {
+    kind: Type.Literal("safe"),
+    family: Type.String({
+      description: "A SAFE_FONTS name \u2014 installed with Office."
+    })
+  },
+  {
+    additionalProperties: false,
+    description: "Office-installed font \u2014 no embedding"
+  }
+);
+var GoogleFontSourceSchema = Type.Object(
+  {
+    kind: Type.Literal("google"),
+    family: Type.String({
+      description: 'Exact Google Fonts family name (e.g. "Inter").'
+    }),
+    weights: Type.Optional(
+      Type.Array(FontWeightSchema, {
+        description: "Weights to fetch. Default [400, 700]."
+      })
+    ),
+    italics: Type.Optional(
+      Type.Boolean({ description: "Include italic variants. Default false." })
+    )
+  },
+  {
+    additionalProperties: false,
+    description: "Google Fonts \u2014 auto-fetched and embedded"
+  }
+);
+var FileFontSourceSchema = Type.Object(
+  {
+    kind: Type.Literal("file"),
+    path: Type.String({
+      description: "Path to a .ttf/.otf file. Relative paths are resolved against the JSON document file."
+    }),
+    weight: Type.Optional(FontWeightSchema),
+    italic: Type.Optional(FontItalicSchema)
+  },
+  { additionalProperties: false, description: "Local font file to embed" }
+);
+var UrlFontSourceSchema = Type.Object(
+  {
+    kind: Type.Literal("url"),
+    url: Type.String({
+      description: "HTTPS URL of a TTF or OTF file."
+    }),
+    weight: Type.Optional(FontWeightSchema),
+    italic: Type.Optional(FontItalicSchema)
+  },
+  {
+    additionalProperties: false,
+    description: "Direct TTF/OTF URL (non-Google CDN)"
+  }
+);
+var VariableFontSourceSchema = Type.Object(
+  {
+    kind: Type.Literal("variable"),
+    url: Type.String({
+      description: "HTTPS URL of a variable TTF (`fvar` axis table required)."
+    }),
+    weight: FontWeightSchema,
+    italic: Type.Optional(FontItalicSchema),
+    axes: Type.Optional(
+      Type.Record(Type.String(), Type.Number(), {
+        description: "Additional axis pin values (e.g. `{ ital: 1, opsz: 14 }`) merged on top of the derived `wght` pin. Uncommon \u2014 the `weight` field is usually enough."
+      })
+    )
+  },
+  {
+    additionalProperties: false,
+    description: "Variable-font instancer. The fetcher pins `wght` to `weight` (plus any `axes` overrides) and emits a clean static TTF, bypassing upstream distributions that collapse multiple static weights onto the same glyph geometry."
+  }
+);
+var DataFontSourceSchema = Type.Object(
+  {
+    kind: Type.Literal("data"),
+    data: Type.String({
+      description: "Base64-encoded TTF/OTF or data: URL (data:font/ttf;base64,...). Makes the JSON self-contained at the cost of size."
+    }),
+    weight: Type.Optional(FontWeightSchema),
+    italic: Type.Optional(FontItalicSchema)
+  },
+  { additionalProperties: false, description: "Inline base64 font \u2014 portable" }
+);
+var FontSourceSchema = Type.Union(
+  [
+    SafeFontSourceSchema,
+    GoogleFontSourceSchema,
+    FileFontSourceSchema,
+    DataFontSourceSchema,
+    UrlFontSourceSchema,
+    VariableFontSourceSchema
+  ],
+  {
+    description: 'A single font variant source. Use kind:"safe" for installed fonts, kind:"google" for Google Fonts, kind:"file" for local files, kind:"data" for base64, kind:"url" for direct HTTPS TTF/OTF URLs, kind:"variable" to instance a variable TTF at a specific weight.'
+  }
+);
+var FontCategorySchema = Type.Union(
+  [
+    Type.Literal("sans"),
+    Type.Literal("serif"),
+    Type.Literal("mono"),
+    Type.Literal("display"),
+    Type.Literal("handwriting")
+  ],
+  { description: "Broad category used for fallback selection" }
+);
+var FontRegistryEntrySchema = Type.Object(
+  {
+    id: Type.String({
+      description: 'Registry key. By convention, match the display family name ("Inter", "Roboto Slab").'
+    }),
+    family: Type.String({
+      description: "Display family used in font.family / fontFace / theme.fonts.*. Usually identical to id."
+    }),
+    category: Type.Optional(FontCategorySchema),
+    sources: Type.Array(FontSourceSchema, {
+      minItems: 1,
+      description: "One or more weight/style variants. List at least a regular (weight 400, italic false)."
+    })
+  },
+  {
+    additionalProperties: false,
+    description: "A font registered for this document. Referenced by family from font.family, fontFace, and theme.fonts.*."
+  }
+);
+var FontRegistrySchema = Type.Array(FontRegistryEntrySchema, {
+  description: "Document-scoped font registry. Every non-safe font used in this document must be registered here."
+});
+
+export {
+  SAFE_FONTS,
+  isSafeFont,
+  FontFamilyNameSchema,
+  FontSourceSchema,
+  FontRegistryEntrySchema,
+  FontRegistrySchema
+};
+//# sourceMappingURL=chunk-6KUQYVPT.js.map

package/dist/chunk-6KUQYVPT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/font-catalog.ts"],"sourcesContent":["/**\n * Font catalog + registry schemas.\n *\n * Shared by DOCX and PPTX pipelines. Defines:\n * - SAFE_FONTS: Office-safe font names (installed on Windows/macOS with Office).\n * - FontFamilyNameSchema: free-form string for `font.family` / `fontFace`, with LLM-facing guidance.\n * - FontSourceSchema: one binary variant (safe | google | file | data).\n * - FontRegistryEntrySchema / FontRegistrySchema: document-scoped font registry.\n */\n\nimport { Type, Static } from '@sinclair/typebox';\n\n/**\n * Fonts pre-installed with Microsoft Office on Windows + macOS.\n * Using one of these requires no registration and no embedding.\n */\nexport const SAFE_FONTS = [\n  'Arial',\n  'Calibri',\n  'Cambria',\n  'Consolas',\n  'Courier New',\n  'Georgia',\n  'Segoe UI',\n  'Tahoma',\n  'Times New Roman',\n  'Trebuchet MS',\n  'Verdana',\n  'Helvetica',\n  'Helvetica Neue',\n  'Menlo',\n  'Monaco',\n] as const;\n\nexport type SafeFontName = (typeof SAFE_FONTS)[number];\n\n/** Case-insensitive membership test against SAFE_FONTS. */\nexport function isSafeFont(name: string): boolean {\n  const lower = name.toLowerCase();\n  return SAFE_FONTS.some((f) => f.toLowerCase() === lower);\n}\n\n/**\n * Font family name used in `font.family` / `fontFace`.\n *\n * Stays a free-form string so users can reference custom or Google fonts.\n * Description + examples guide LLMs and JSON Schema consumers toward SAFE_FONTS.\n */\nexport const FontFamilyNameSchema = Type.String({\n  description:\n    'Font family name. Prefer a SAFE_FONTS entry (Arial, Calibri, Cambria, Consolas, Courier New, Georgia, Segoe UI, Tahoma, Times New Roman, Trebuchet MS, Verdana, Helvetica, Helvetica Neue, Menlo, Monaco) for zero-setup rendering. For any other font, register it in props.fontRegistry[] and reference it here by family. Unregistered non-safe names render with a host fallback.',\n  examples: ['Arial', 'Calibri', 'Georgia', 'Inter', 'Roboto'],\n});\n\n// ----------------------------------------------------------------------------\n// Font sources — one weight/style variant\n// ----------------------------------------------------------------------------\n\nconst FontWeightSchema = Type.Number({\n  minimum: 100,\n  maximum: 900,\n  description: 'OpenType weight (100 thin ... 900 black). Default 400.',\n});\n\nconst FontItalicSchema = Type.Boolean({\n  description: 'Whether this source is italic. Default false.',\n});\n\n/** Safe reference — no embedding needed. */\nconst SafeFontSourceSchema = Type.Object(\n  {\n    kind: Type.Literal('safe'),\n    family: Type.String({\n      description: 'A SAFE_FONTS name — installed with Office.',\n    }),\n  },\n  {\n    additionalProperties: false,\n    description: 'Office-installed font — no embedding',\n  }\n);\n\n/** Google Fonts — fetched and embedded at generate time. */\nconst GoogleFontSourceSchema = Type.Object(\n  {\n    kind: Type.Literal('google'),\n    family: Type.String({\n      description: 'Exact Google Fonts family name (e.g. \"Inter\").',\n    }),\n    weights: Type.Optional(\n      Type.Array(FontWeightSchema, {\n        description: 'Weights to fetch. Default [400, 700].',\n      })\n    ),\n    italics: Type.Optional(\n      Type.Boolean({ description: 'Include italic variants. Default false.' })\n    ),\n  },\n  {\n    additionalProperties: false,\n    description: 'Google Fonts — auto-fetched and embedded',\n  }\n);\n\n/** Local TTF/OTF file — resolved relative to the JSON file, or absolute. */\nconst FileFontSourceSchema = Type.Object(\n  {\n    kind: Type.Literal('file'),\n    path: Type.String({\n      description:\n        'Path to a .ttf/.otf file. Relative paths are resolved against the JSON document file.',\n    }),\n    weight: Type.Optional(FontWeightSchema),\n    italic: Type.Optional(FontItalicSchema),\n  },\n  { additionalProperties: false, description: 'Local font file to embed' }\n);\n\n/**\n * Direct URL to a TTF/OTF. Used to bypass Google Fonts redistribution for\n * families with known metadata defects — e.g. rsms/inter hosted on jsDelivr.\n * A single URL fetches one variant; multiple URLs build a multi-weight family.\n */\nconst UrlFontSourceSchema = Type.Object(\n  {\n    kind: Type.Literal('url'),\n    url: Type.String({\n      description: 'HTTPS URL of a TTF or OTF file.',\n    }),\n    weight: Type.Optional(FontWeightSchema),\n    italic: Type.Optional(FontItalicSchema),\n  },\n  {\n    additionalProperties: false,\n    description: 'Direct TTF/OTF URL (non-Google CDN)',\n  }\n);\n\n/**\n * Variable-font-instanced variant. Points at a variable TTF URL plus a\n * target weight (and optional additional `axes` pins); the fetcher\n * downloads the variable TTF once (disk-cached) and uses harfbuzz to pin\n * the `wght` axis (plus any additional axes) to produce a clean static\n * TTF for embedding.\n *\n * Used to escape Google Fonts' lossy per-weight static generation — e.g.\n * Google ships Inter Thin and Inter ExtraLight as near-identical glyph\n * files (both sourced around wght=250), but the upstream variable Inter\n * produces properly distinct static instances when pinned precisely at\n * wght=100 vs wght=200.\n */\nconst VariableFontSourceSchema = Type.Object(\n  {\n    kind: Type.Literal('variable'),\n    url: Type.String({\n      description: 'HTTPS URL of a variable TTF (`fvar` axis table required).',\n    }),\n    weight: FontWeightSchema,\n    italic: Type.Optional(FontItalicSchema),\n    axes: Type.Optional(\n      Type.Record(Type.String(), Type.Number(), {\n        description:\n          'Additional axis pin values (e.g. `{ ital: 1, opsz: 14 }`) merged on top of the derived `wght` pin. Uncommon — the `weight` field is usually enough.',\n      })\n    ),\n  },\n  {\n    additionalProperties: false,\n    description:\n      'Variable-font instancer. The fetcher pins `wght` to `weight` (plus any `axes` overrides) and emits a clean static TTF, bypassing upstream distributions that collapse multiple static weights onto the same glyph geometry.',\n  }\n);\n\n/** Inline base64 / data-URL — self-contained JSON. */\nconst DataFontSourceSchema = Type.Object(\n  {\n    kind: Type.Literal('data'),\n    data: Type.String({\n      description:\n        'Base64-encoded TTF/OTF or data: URL (data:font/ttf;base64,...). Makes the JSON self-contained at the cost of size.',\n    }),\n    weight: Type.Optional(FontWeightSchema),\n    italic: Type.Optional(FontItalicSchema),\n  },\n  { additionalProperties: false, description: 'Inline base64 font — portable' }\n);\n\n/**\n * One weight/style variant backing a font registry entry.\n *\n * Kinds:\n * - safe: references an Office-installed font; no embedding.\n * - google: Google Fonts family; fetched and embedded at generate time.\n * - file: local .ttf/.otf read from disk.\n * - data: inline base64, makes JSON self-contained.\n */\nexport const FontSourceSchema = Type.Union(\n  [\n    SafeFontSourceSchema,\n    GoogleFontSourceSchema,\n    FileFontSourceSchema,\n    DataFontSourceSchema,\n    UrlFontSourceSchema,\n    VariableFontSourceSchema,\n  ],\n  {\n    description:\n      'A single font variant source. Use kind:\"safe\" for installed fonts, kind:\"google\" for Google Fonts, kind:\"file\" for local files, kind:\"data\" for base64, kind:\"url\" for direct HTTPS TTF/OTF URLs, kind:\"variable\" to instance a variable TTF at a specific weight.',\n  }\n);\n\nexport type FontSource = Static<typeof FontSourceSchema>;\n\n// ----------------------------------------------------------------------------\n// Font registry entry\n// ----------------------------------------------------------------------------\n\nconst FontCategorySchema = Type.Union(\n  [\n    Type.Literal('sans'),\n    Type.Literal('serif'),\n    Type.Literal('mono'),\n    Type.Literal('display'),\n    Type.Literal('handwriting'),\n  ],\n  { description: 'Broad category used for fallback selection' }\n);\n\nexport const FontRegistryEntrySchema = Type.Object(\n  {\n    id: Type.String({\n      description:\n        'Registry key. By convention, match the display family name (\"Inter\", \"Roboto Slab\").',\n    }),\n    family: Type.String({\n      description:\n        'Display family used in font.family / fontFace / theme.fonts.*. Usually identical to id.',\n    }),\n    category: Type.Optional(FontCategorySchema),\n    sources: Type.Array(FontSourceSchema, {\n      minItems: 1,\n      description:\n        'One or more weight/style variants. List at least a regular (weight 400, italic false).',\n    }),\n  },\n  {\n    additionalProperties: false,\n    description:\n      'A font registered for this document. Referenced by family from font.family, fontFace, and theme.fonts.*.',\n  }\n);\n\nexport type FontRegistryEntry = Static<typeof FontRegistryEntrySchema>;\n\n/**\n * Document-scoped font registry.\n *\n * Ships with the JSON — no runtime side-channel needed for the common case.\n * Every font name used in font.family / fontFace / theme.fonts.* that isn't\n * in SAFE_FONTS must resolve to an entry here (by family) or tooling warns.\n */\nexport const FontRegistrySchema = Type.Array(FontRegistryEntrySchema, {\n  description:\n    'Document-scoped font registry. Every non-safe font used in this document must be registered here.',\n});\n\nexport type FontRegistryDefinition = Static<typeof FontRegistrySchema>;\n"],"mappings":"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","names":[]}

package/dist/{chunk-TDDHCW5S.js → chunk-GPNPMKVZ.js}

@@ -1,11 +1,11 @@
-import {
-  isValidSemver,
-  latestVersion
-} from "./chunk-244MHDOZ.js";
 import {
   formatErrorSummary,
   transformValueErrors
 } from "./chunk-ZKD5BAMU.js";
+import {
+  isValidSemver,
+  latestVersion
+} from "./chunk-244MHDOZ.js";
 
 // src/plugin/createComponent.ts
 function createVersion(version) {
@@ -198,4 +198,4 @@ export {
   isValidationSuccess,
   getValidationSummary
 };
-//# sourceMappingURL=chunk-TDDHCW5S.js.map
+//# sourceMappingURL=chunk-GPNPMKVZ.js.map

package/dist/index.d.ts

@@ -12,14 +12,74 @@ import '@sinclair/typebox/value';
 /**
  * Service configuration types for external integrations (e.g. Highcharts export server)
  */
+/** Default raster resolution when a `visual` does not specify one. */
+declare const DEFAULT_VISUAL_DPI = 200;
+/** Minimum accepted raster resolution. */
+declare const MIN_VISUAL_DPI = 36;
+/** Maximum accepted raster resolution (bounds bitmap size / DoS surface). */
+declare const MAX_VISUAL_DPI = 600;
+/** Clamp an arbitrary dpi to [MIN_VISUAL_DPI, MAX_VISUAL_DPI]; non-finite → default. */
+declare function clampVisualDpi(dpi: unknown): number;
 type HighchartsHeaders = Record<string, string>;
 type HighchartsHeadersResolver = (body: unknown) => HighchartsHeaders | Promise<HighchartsHeaders>;
 interface HighchartsServiceConfig {
     serverUrl?: string;
     headers?: HighchartsHeaders | HighchartsHeadersResolver;
 }
+type PptxServiceHeaders = Record<string, string>;
+type PptxServiceHeadersResolver = (body: unknown) => PptxServiceHeaders | Promise<PptxServiceHeaders>;
+/**
+ * Request handed to a pptx rasterizer: a single-slide pptx presentation
+ * component definition plus the target resolution.
+ */
+interface PptxRasterizeRequest {
+    /** A pptx presentation component definition ({ name: 'pptx', ... }) with one slide */
+    presentation: unknown;
+    /** Target raster resolution in dots-per-inch */
+    dpi: number;
+}
+/**
+ * Result returned by a pptx rasterizer.
+ */
+interface PptxRasterizeResult {
+    /** Rendered PNG as a base64 data URI (data:image/png;base64,...) */
+    base64DataUri: string;
+    /** Natural pixel width of the rendered image */
+    width: number;
+    /** Natural pixel height of the rendered image */
+    height: number;
+}
+/**
+ * In-process rasterizer callback. Implementations build the .pptx from the
+ * presentation JSON and rasterize it to a PNG (e.g. via LibreOffice + poppler).
+ */
+type PptxRasterizer = (request: PptxRasterizeRequest) => Promise<PptxRasterizeResult>;
+/**
+ * Configuration for the pptx rasterization service backing `visual` components.
+ *
+ * Mirrors {@link HighchartsServiceConfig}: the published packages depend on this
+ * interface, never on a binary. A host injects either an in-process `render`
+ * callback or an HTTP `serverUrl`.
+ */
+interface PptxServiceConfig {
+    /**
+     * In-process rasterizer. Takes precedence over `serverUrl` when provided.
+     * Ideal for tests (no binaries) and single-process hosts.
+     */
+    render?: PptxRasterizer;
+    /**
+     * HTTP rasterization service URL. The service receives
+     * `{ presentation, dpi }` and returns a {@link PptxRasterizeResult}.
+     */
+    serverUrl?: string;
+    /** Optional headers (or async resolver) for the HTTP service. */
+    headers?: PptxServiceHeaders | PptxServiceHeadersResolver;
+    /** Default DPI applied when a `visual` does not specify one. */
+    dpi?: number;
+}
 interface ServicesConfig {
     highcharts?: HighchartsServiceConfig;
+    pptx?: PptxServiceConfig;
 }
 
 /** Scan an arbitrary doc tree (DOCX or PPTX) for every font family referenced. */
@@ -470,4 +530,4 @@ declare function applyExportMode<D, T>(input: ApplyExportModeInput<D, T>): Apply
  */
 declare function mergeWithDefaults<T>(userConfig: T, themeDefaults: Partial<T>): T;
 
-export { type FontIssueCode, FontRegistry, FontRegistryEntry, type FontRegistryInput, type FontResolutionIssue, FontRuntimeOpts, type FontSubstitution, type FontValidationInput, type FontValidationResult, type HighchartsHeaders, type HighchartsHeadersResolver, type HighchartsServiceConfig, POPULAR_GOOGLE_FONTS, type PopularGoogleFont, ResolvedFont, ResolvedFontSource, type ServicesConfig, type SynthesizedFamily, UPSTREAM_OVERRIDES, type UpstreamOverride, type UpstreamVariant, WEIGHT_LABELS, applyExportMode, applyFontSubstitution, buildDefaultSubstitutionMap, collectFontNamesFromDocx, collectFontNamesFromPptx, defaultSubstituteFor, detectFontFormat, fetchGoogleFontSources, getUpstreamOverride, mergeWithDefaults, rewriteFontFamilyName, scopedThemeName, synthesizeFamilyName, validateFontReferences };
+export { DEFAULT_VISUAL_DPI, type FontIssueCode, FontRegistry, FontRegistryEntry, type FontRegistryInput, type FontResolutionIssue, FontRuntimeOpts, type FontSubstitution, type FontValidationInput, type FontValidationResult, type HighchartsHeaders, type HighchartsHeadersResolver, type HighchartsServiceConfig, MAX_VISUAL_DPI, MIN_VISUAL_DPI, POPULAR_GOOGLE_FONTS, type PopularGoogleFont, type PptxRasterizeRequest, type PptxRasterizeResult, type PptxRasterizer, type PptxServiceConfig, type PptxServiceHeaders, type PptxServiceHeadersResolver, ResolvedFont, ResolvedFontSource, type ServicesConfig, type SynthesizedFamily, UPSTREAM_OVERRIDES, type UpstreamOverride, type UpstreamVariant, WEIGHT_LABELS, applyExportMode, applyFontSubstitution, buildDefaultSubstitutionMap, clampVisualDpi, collectFontNamesFromDocx, collectFontNamesFromPptx, defaultSubstituteFor, detectFontFormat, fetchGoogleFontSources, getUpstreamOverride, mergeWithDefaults, rewriteFontFamilyName, scopedThemeName, synthesizeFamilyName, validateFontReferences };

package/dist/index.js

@@ -12,20 +12,7 @@ import {
   isValidationSuccess,
   resolveComponentVersion,
   validateCustomComponentProps
-} from "./chunk-TDDHCW5S.js";
-import {
-  convertToJsonSchema,
-  createComponentSchema,
-  createComponentSchemaObject,
-  exportSchemaToFile,
-  fixSchemaReferences
-} from "./chunk-5J43F4XD.js";
-import {
-  compareSemver,
-  isValidSemver,
-  latestVersion,
-  parseSemver
-} from "./chunk-244MHDOZ.js";
+} from "./chunk-GPNPMKVZ.js";
 import {
   DEFAULT_ERROR_CONFIG,
   ERROR_EMOJIS,
@@ -46,174 +33,37 @@ import {
   transformValueError,
   transformValueErrors
 } from "./chunk-ZKD5BAMU.js";
+import {
+  convertToJsonSchema,
+  createComponentSchema,
+  createComponentSchemaObject,
+  exportSchemaToFile,
+  fixSchemaReferences
+} from "./chunk-5J43F4XD.js";
+import {
+  FontFamilyNameSchema,
+  FontRegistryEntrySchema,
+  FontRegistrySchema,
+  FontSourceSchema,
+  SAFE_FONTS,
+  isSafeFont
+} from "./chunk-6KUQYVPT.js";
+import {
+  compareSemver,
+  isValidSemver,
+  latestVersion,
+  parseSemver
+} from "./chunk-244MHDOZ.js";
 
-// src/schemas/font-catalog.ts
-import { Type } from "@sinclair/typebox";
-var SAFE_FONTS = [
-  "Arial",
-  "Calibri",
-  "Cambria",
-  "Consolas",
-  "Courier New",
-  "Georgia",
-  "Segoe UI",
-  "Tahoma",
-  "Times New Roman",
-  "Trebuchet MS",
-  "Verdana",
-  "Helvetica",
-  "Helvetica Neue",
-  "Menlo",
-  "Monaco"
-];
-function isSafeFont(name) {
-  const lower = name.toLowerCase();
-  return SAFE_FONTS.some((f) => f.toLowerCase() === lower);
+// src/types/services.ts
+var DEFAULT_VISUAL_DPI = 200;
+var MIN_VISUAL_DPI = 36;
+var MAX_VISUAL_DPI = 600;
+function clampVisualDpi(dpi) {
+  if (typeof dpi !== "number" || !Number.isFinite(dpi))
+    return DEFAULT_VISUAL_DPI;
+  return Math.min(MAX_VISUAL_DPI, Math.max(MIN_VISUAL_DPI, Math.round(dpi)));
 }
-var FontFamilyNameSchema = Type.String({
-  description: "Font family name. Prefer a SAFE_FONTS entry (Arial, Calibri, Cambria, Consolas, Courier New, Georgia, Segoe UI, Tahoma, Times New Roman, Trebuchet MS, Verdana, Helvetica, Helvetica Neue, Menlo, Monaco) for zero-setup rendering. For any other font, register it in props.fontRegistry[] and reference it here by family. Unregistered non-safe names render with a host fallback.",
-  examples: ["Arial", "Calibri", "Georgia", "Inter", "Roboto"]
-});
-var FontWeightSchema = Type.Number({
-  minimum: 100,
-  maximum: 900,
-  description: "OpenType weight (100 thin ... 900 black). Default 400."
-});
-var FontItalicSchema = Type.Boolean({
-  description: "Whether this source is italic. Default false."
-});
-var SafeFontSourceSchema = Type.Object(
-  {
-    kind: Type.Literal("safe"),
-    family: Type.String({
-      description: "A SAFE_FONTS name \u2014 installed with Office."
-    })
-  },
-  {
-    additionalProperties: false,
-    description: "Office-installed font \u2014 no embedding"
-  }
-);
-var GoogleFontSourceSchema = Type.Object(
-  {
-    kind: Type.Literal("google"),
-    family: Type.String({
-      description: 'Exact Google Fonts family name (e.g. "Inter").'
-    }),
-    weights: Type.Optional(
-      Type.Array(FontWeightSchema, {
-        description: "Weights to fetch. Default [400, 700]."
-      })
-    ),
-    italics: Type.Optional(
-      Type.Boolean({ description: "Include italic variants. Default false." })
-    )
-  },
-  {
-    additionalProperties: false,
-    description: "Google Fonts \u2014 auto-fetched and embedded"
-  }
-);
-var FileFontSourceSchema = Type.Object(
-  {
-    kind: Type.Literal("file"),
-    path: Type.String({
-      description: "Path to a .ttf/.otf file. Relative paths are resolved against the JSON document file."
-    }),
-    weight: Type.Optional(FontWeightSchema),
-    italic: Type.Optional(FontItalicSchema)
-  },
-  { additionalProperties: false, description: "Local font file to embed" }
-);
-var UrlFontSourceSchema = Type.Object(
-  {
-    kind: Type.Literal("url"),
-    url: Type.String({
-      description: "HTTPS URL of a TTF or OTF file."
-    }),
-    weight: Type.Optional(FontWeightSchema),
-    italic: Type.Optional(FontItalicSchema)
-  },
-  {
-    additionalProperties: false,
-    description: "Direct TTF/OTF URL (non-Google CDN)"
-  }
-);
-var VariableFontSourceSchema = Type.Object(
-  {
-    kind: Type.Literal("variable"),
-    url: Type.String({
-      description: "HTTPS URL of a variable TTF (`fvar` axis table required)."
-    }),
-    weight: FontWeightSchema,
-    italic: Type.Optional(FontItalicSchema),
-    axes: Type.Optional(
-      Type.Record(Type.String(), Type.Number(), {
-        description: "Additional axis pin values (e.g. `{ ital: 1, opsz: 14 }`) merged on top of the derived `wght` pin. Uncommon \u2014 the `weight` field is usually enough."
-      })
-    )
-  },
-  {
-    additionalProperties: false,
-    description: "Variable-font instancer. The fetcher pins `wght` to `weight` (plus any `axes` overrides) and emits a clean static TTF, bypassing upstream distributions that collapse multiple static weights onto the same glyph geometry."
-  }
-);
-var DataFontSourceSchema = Type.Object(
-  {
-    kind: Type.Literal("data"),
-    data: Type.String({
-      description: "Base64-encoded TTF/OTF or data: URL (data:font/ttf;base64,...). Makes the JSON self-contained at the cost of size."
-    }),
-    weight: Type.Optional(FontWeightSchema),
-    italic: Type.Optional(FontItalicSchema)
-  },
-  { additionalProperties: false, description: "Inline base64 font \u2014 portable" }
-);
-var FontSourceSchema = Type.Union(
-  [
-    SafeFontSourceSchema,
-    GoogleFontSourceSchema,
-    FileFontSourceSchema,
-    DataFontSourceSchema,
-    UrlFontSourceSchema,
-    VariableFontSourceSchema
-  ],
-  {
-    description: 'A single font variant source. Use kind:"safe" for installed fonts, kind:"google" for Google Fonts, kind:"file" for local files, kind:"data" for base64, kind:"url" for direct HTTPS TTF/OTF URLs, kind:"variable" to instance a variable TTF at a specific weight.'
-  }
-);
-var FontCategorySchema = Type.Union(
-  [
-    Type.Literal("sans"),
-    Type.Literal("serif"),
-    Type.Literal("mono"),
-    Type.Literal("display"),
-    Type.Literal("handwriting")
-  ],
-  { description: "Broad category used for fallback selection" }
-);
-var FontRegistryEntrySchema = Type.Object(
-  {
-    id: Type.String({
-      description: 'Registry key. By convention, match the display family name ("Inter", "Roboto Slab").'
-    }),
-    family: Type.String({
-      description: "Display family used in font.family / fontFace / theme.fonts.*. Usually identical to id."
-    }),
-    category: Type.Optional(FontCategorySchema),
-    sources: Type.Array(FontSourceSchema, {
-      minItems: 1,
-      description: "One or more weight/style variants. List at least a regular (weight 400, italic false)."
-    })
-  },
-  {
-    additionalProperties: false,
-    description: "A font registered for this document. Referenced by family from font.family, fontFace, and theme.fonts.*."
-  }
-);
-var FontRegistrySchema = Type.Array(FontRegistryEntrySchema, {
-  description: "Document-scoped font registry. Every non-safe font used in this document must be registered here."
-});
 
 // src/fonts/collect.ts
 var FONT_NAME_KEYS = /* @__PURE__ */ new Set([
@@ -1533,6 +1383,7 @@ function mergeWithDefaults(userConfig, themeDefaults) {
 export {
   ComponentValidationError,
   DEFAULT_ERROR_CONFIG,
+  DEFAULT_VISUAL_DPI,
   DuplicateComponentError,
   ERROR_EMOJIS,
   FontFamilyNameSchema,
@@ -1540,6 +1391,8 @@ export {
   FontRegistryEntrySchema,
   FontRegistrySchema,
   FontSourceSchema,
+  MAX_VISUAL_DPI,
+  MIN_VISUAL_DPI,
   POPULAR_GOOGLE_FONTS,
   SAFE_FONTS,
   UPSTREAM_OVERRIDES,
@@ -1549,6 +1402,7 @@ export {
   applyFontSubstitution,
   buildDefaultSubstitutionMap,
   calculatePosition,
+  clampVisualDpi,
   clearComponentNamesCache,
   collectFontNamesFromDocx,
   collectFontNamesFromPptx,