@templatical/import-beefree 0.54.2 → 0.55.0

package/README.md

@@ -22,8 +22,9 @@ const beefreeJson = await fetch('/path/to/beefree-template.json').then(r => r.js
 
 const result = convertBeeFreeTemplate(beefreeJson);
 
-console.log(result.content);   // → Templatical TemplateContent
-console.log(result.report);    // → conversion report (per-module status, warnings, summary)
+console.log(result.content);      // → Templatical TemplateContent
+console.log(result.report);       // → conversion report (per-module status, warnings, summary)
+console.log(result.customFonts);  // → { name, url }[] for fonts.customFonts and render
 
 // Inspect modules that didn't convert cleanly
 for (const entry of result.report.entries) {
@@ -59,11 +60,11 @@ Unknown or partially-supported modules are flagged in `result.report` so you can
 
 ## API
 
-- `convertBeeFreeTemplate(template)` — converts a BeeFree JSON template, returns `{ content, report }`
+- `convertBeeFreeTemplate(template)` — converts a BeeFree JSON template, returns `{ content, report, customFonts }`
 
 Types:
 - `BeeFreeTemplate` — input shape (see source for full structure)
-- `ImportResult` — `{ content: TemplateContent, report: ImportReport }`
+- `ImportResult` — `{ content: TemplateContent, report: ImportReport, customFonts: CustomFont[] }`
 - `ImportReport` — `{ entries: ImportReportEntry[], warnings: string[], summary: { total, converted, approximated, htmlFallback, skipped } }`
 - `ImportReportEntry` — `{ beeFreeModuleType, templaticalBlockType, status, note? }`
 - `ConversionStatus` — `'converted' | 'approximated' | 'html-fallback' | 'skipped'`

package/dist/index.d.ts

@@ -166,6 +166,10 @@ interface BeeFreeeSocialIcon {
     src?: string;
     href?: string;
     alt?: string;
+    target?: string;
+    /** The icon file's size. A number of px, or a px length. */
+    width?: string | number;
+    height?: string | number;
   };
   name?: string;
   text?: string;
@@ -240,6 +244,12 @@ interface ImportReport {
 interface ImportResult {
   content: import("@templatical/types").TemplateContent;
   report: ImportReport;
+  /**
+   * Web fonts to load, taken from `page.body.webFonts` entries that carry a
+   * URL. A host passes them to the editor's `fonts.customFonts` and to
+   * `render`. System stacks and `inherit` are left out.
+   */
+  customFonts: import("@templatical/types").CustomFont[];
 }
 interface ConvertBeeFreeOptions {
   /** Used when the source declares no default language. */