@pyreon/document 0.11.5 → 0.11.6

package/src/builder.ts

@@ -1,4 +1,4 @@
-import { download } from "./download"
+import { download } from './download'
 import {
   Button,
   Code,
@@ -16,8 +16,8 @@ import {
   Spacer,
   Table,
   Text,
-} from "./nodes"
-import { render } from "./render"
+} from './nodes'
+import { render } from './render'
 import type {
   ButtonProps,
   CodeProps,
@@ -33,7 +33,7 @@ import type {
   RenderOptions,
   TableProps,
   TextProps,
-} from "./types"
+} from './types'
 
 /**
  * Create a document using the builder pattern — no JSX needed.
@@ -57,21 +57,21 @@ export function createDocument(props: DocumentProps = {}): DocumentBuilder {
   }
 
   const builder: DocumentBuilder = {
-    heading(text: string, p?: Omit<HeadingProps, "children">) {
+    heading(text: string, p?: Omit<HeadingProps, 'children'>) {
       sections.push(Heading({ ...p, children: text }))
       return builder
     },
 
-    text(text: string, p?: Omit<TextProps, "children">) {
+    text(text: string, p?: Omit<TextProps, 'children'>) {
       sections.push(Text({ ...p, children: text }))
       return builder
     },
 
-    paragraph(text: string, p?: Omit<TextProps, "children">) {
+    paragraph(text: string, p?: Omit<TextProps, 'children'>) {
       return builder.text(text, p)
     },
 
-    image(src: string, p?: Omit<ImageProps, "src">) {
+    image(src: string, p?: Omit<ImageProps, 'src'>) {
       sections.push(Image({ src, ...p }))
       return builder
     },
@@ -81,7 +81,7 @@ export function createDocument(props: DocumentProps = {}): DocumentBuilder {
       return builder
     },
 
-    list(items: string[], p?: Omit<ListProps, "children">) {
+    list(items: string[], p?: Omit<ListProps, 'children'>) {
       sections.push(
         List({
           ...p,
@@ -91,7 +91,7 @@ export function createDocument(props: DocumentProps = {}): DocumentBuilder {
       return builder
     },
 
-    code(text: string, p?: Omit<CodeProps, "children">) {
+    code(text: string, p?: Omit<CodeProps, 'children'>) {
       sections.push(Code({ ...p, children: text }))
       return builder
     },
@@ -106,17 +106,17 @@ export function createDocument(props: DocumentProps = {}): DocumentBuilder {
       return builder
     },
 
-    quote(text: string, p?: Omit<QuoteProps, "children">) {
+    quote(text: string, p?: Omit<QuoteProps, 'children'>) {
       sections.push(Quote({ ...p, children: text }))
       return builder
     },
 
-    button(text: string, p: Omit<ButtonProps, "children">) {
+    button(text: string, p: Omit<ButtonProps, 'children'>) {
       sections.push(Button({ ...p, children: text }))
       return builder
     },
 
-    link(text: string, p: Omit<LinkProps, "children">) {
+    link(text: string, p: Omit<LinkProps, 'children'>) {
       sections.push(Link({ ...p, children: text }))
       return builder
     },
@@ -144,7 +144,7 @@ export function createDocument(props: DocumentProps = {}): DocumentBuilder {
       // Try to get data URL from chart instance
       const inst = instance as { getDataURL?: (opts: unknown) => string }
       if (inst?.getDataURL) {
-        const dataUrl = inst.getDataURL({ type: "png", pixelRatio: 2 })
+        const dataUrl = inst.getDataURL({ type: 'png', pixelRatio: 2 })
         sections.push(
           Image({
             src: dataUrl,
@@ -156,9 +156,9 @@ export function createDocument(props: DocumentProps = {}): DocumentBuilder {
       } else {
         sections.push(
           Text({
-            children: "[Chart]",
+            children: '[Chart]',
             italic: true,
-            color: "#999",
+            color: '#999',
           } as TextProps & { children: string }),
         )
       }
@@ -181,9 +181,9 @@ export function createDocument(props: DocumentProps = {}): DocumentBuilder {
       } else {
         sections.push(
           Text({
-            children: "[Flow Diagram]",
+            children: '[Flow Diagram]',
             italic: true,
-            color: "#999",
+            color: '#999',
           } as TextProps & { children: string }),
         )
       }
@@ -195,75 +195,75 @@ export function createDocument(props: DocumentProps = {}): DocumentBuilder {
     },
 
     async toHtml(options?: RenderOptions) {
-      return render(getNode(), "html", options) as Promise<string>
+      return render(getNode(), 'html', options) as Promise<string>
     },
 
     async toPdf(options?: RenderOptions) {
-      return render(getNode(), "pdf", options) as Promise<Uint8Array>
+      return render(getNode(), 'pdf', options) as Promise<Uint8Array>
     },
 
     async toDocx(options?: RenderOptions) {
-      return render(getNode(), "docx", options) as Promise<Uint8Array>
+      return render(getNode(), 'docx', options) as Promise<Uint8Array>
     },
 
     async toEmail(options?: RenderOptions) {
-      return render(getNode(), "email", options) as Promise<string>
+      return render(getNode(), 'email', options) as Promise<string>
     },
 
     async toPptx(options?: RenderOptions) {
-      return render(getNode(), "pptx", options) as Promise<Uint8Array>
+      return render(getNode(), 'pptx', options) as Promise<Uint8Array>
     },
 
     async toXlsx(options?: RenderOptions) {
-      return render(getNode(), "xlsx", options) as Promise<Uint8Array>
+      return render(getNode(), 'xlsx', options) as Promise<Uint8Array>
     },
 
     async toMarkdown(options?: RenderOptions) {
-      return render(getNode(), "md", options) as Promise<string>
+      return render(getNode(), 'md', options) as Promise<string>
     },
 
     async toText(options?: RenderOptions) {
-      return render(getNode(), "text", options) as Promise<string>
+      return render(getNode(), 'text', options) as Promise<string>
     },
 
     async toCsv(options?: RenderOptions) {
-      return render(getNode(), "csv", options) as Promise<string>
+      return render(getNode(), 'csv', options) as Promise<string>
     },
 
     async toSlack(options?: RenderOptions) {
-      return render(getNode(), "slack", options) as Promise<string>
+      return render(getNode(), 'slack', options) as Promise<string>
     },
 
     async toSvg(options?: RenderOptions) {
-      return render(getNode(), "svg", options) as Promise<string>
+      return render(getNode(), 'svg', options) as Promise<string>
     },
 
     async toTeams(options?: RenderOptions) {
-      return render(getNode(), "teams", options) as Promise<string>
+      return render(getNode(), 'teams', options) as Promise<string>
     },
 
     async toDiscord(options?: RenderOptions) {
-      return render(getNode(), "discord", options) as Promise<string>
+      return render(getNode(), 'discord', options) as Promise<string>
     },
 
     async toTelegram(options?: RenderOptions) {
-      return render(getNode(), "telegram", options) as Promise<string>
+      return render(getNode(), 'telegram', options) as Promise<string>
     },
 
     async toNotion(options?: RenderOptions) {
-      return render(getNode(), "notion", options) as Promise<string>
+      return render(getNode(), 'notion', options) as Promise<string>
     },
 
     async toConfluence(options?: RenderOptions) {
-      return render(getNode(), "confluence", options) as Promise<string>
+      return render(getNode(), 'confluence', options) as Promise<string>
     },
 
     async toWhatsApp(options?: RenderOptions) {
-      return render(getNode(), "whatsapp", options) as Promise<string>
+      return render(getNode(), 'whatsapp', options) as Promise<string>
     },
 
     async toGoogleChat(options?: RenderOptions) {
-      return render(getNode(), "google-chat", options) as Promise<string>
+      return render(getNode(), 'google-chat', options) as Promise<string>
     },
 
     async download(filename: string, options?: RenderOptions) {

package/src/download.ts

@@ -1,33 +1,33 @@
-import { render } from "./render"
-import type { DocNode, RenderOptions } from "./types"
+import { render } from './render'
+import type { DocNode, RenderOptions } from './types'
 
 const FORMAT_MAP: Record<string, string> = {
-  html: "html",
-  htm: "html",
-  pdf: "pdf",
-  docx: "docx",
-  doc: "docx",
-  xlsx: "xlsx",
-  xls: "xlsx",
-  pptx: "pptx",
-  ppt: "pptx",
-  md: "md",
-  txt: "text",
-  csv: "csv",
-  svg: "svg",
+  html: 'html',
+  htm: 'html',
+  pdf: 'pdf',
+  docx: 'docx',
+  doc: 'docx',
+  xlsx: 'xlsx',
+  xls: 'xlsx',
+  pptx: 'pptx',
+  ppt: 'pptx',
+  md: 'md',
+  txt: 'text',
+  csv: 'csv',
+  svg: 'svg',
 }
 
 const MIME_TYPES: Record<string, string> = {
-  html: "text/html",
-  pdf: "application/pdf",
-  docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-  xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-  pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
-  email: "text/html",
-  md: "text/markdown",
-  text: "text/plain",
-  csv: "text/csv",
-  svg: "image/svg+xml",
+  html: 'text/html',
+  pdf: 'application/pdf',
+  docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+  xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+  pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+  email: 'text/html',
+  md: 'text/markdown',
+  text: 'text/plain',
+  csv: 'text/csv',
+  svg: 'image/svg+xml',
 }
 
 /**
@@ -44,15 +44,15 @@ export async function download(
   filename: string,
   options?: RenderOptions,
 ): Promise<void> {
-  const ext = filename.split(".").pop()?.toLowerCase()
+  const ext = filename.split('.').pop()?.toLowerCase()
   if (!ext) {
-    throw new Error("[@pyreon/document] Filename must have an extension (e.g., report.pdf).")
+    throw new Error('[@pyreon/document] Filename must have an extension (e.g., report.pdf).')
   }
 
   const format = FORMAT_MAP[ext]
   if (!format) {
     throw new Error(
-      `[@pyreon/document] Unknown file extension '.${ext}'. Supported: ${Object.keys(FORMAT_MAP).join(", ")}`,
+      `[@pyreon/document] Unknown file extension '.${ext}'. Supported: ${Object.keys(FORMAT_MAP).join(', ')}`,
     )
   }
 
@@ -62,15 +62,15 @@ export async function download(
     result instanceof Uint8Array
       ? new Blob([result as BlobPart])
       : new Blob([result], {
-          type: MIME_TYPES[format] ?? "application/octet-stream",
+          type: MIME_TYPES[format] ?? 'application/octet-stream',
         })
 
-  if (typeof document === "undefined") {
-    throw new Error("[@pyreon/document] download() requires a browser environment.")
+  if (typeof document === 'undefined') {
+    throw new Error('[@pyreon/document] download() requires a browser environment.')
   }
 
   const url = URL.createObjectURL(blob)
-  const a = document.createElement("a")
+  const a = document.createElement('a')
   a.href = url
   a.download = filename
   a.click()

package/src/index.ts

@@ -28,9 +28,9 @@
  */
 
 // Builder
-export { createDocument } from "./builder"
+export { createDocument } from './builder'
 // Download (browser)
-export { download } from "./download"
+export { download } from './download'
 // Primitives
 export {
   Button,
@@ -52,15 +52,10 @@ export {
   Spacer,
   Table,
   Text,
-} from "./nodes"
+} from './nodes'
 
 // Render
-export {
-  _resetRenderers,
-  registerRenderer,
-  render,
-  unregisterRenderer,
-} from "./render"
+export { _resetRenderers, registerRenderer, render, unregisterRenderer } from './render'
 
 // Types
 export type {
@@ -93,4 +88,4 @@ export type {
   TableColumn,
   TableProps,
   TextProps,
-} from "./types"
+} from './types'

package/src/nodes.ts

@@ -19,7 +19,7 @@ import type {
   SpacerProps,
   TableProps,
   TextProps,
-} from "./types"
+} from './types'
 
 // ─── Node Constructor ───────────────────────────────────────────────────────
 
@@ -33,13 +33,13 @@ function createNode(type: NodeType, props: object, children: unknown): DocNode {
 
 function normalizeChildren(children: unknown): DocChild[] {
   if (children == null || children === false) return []
-  if (typeof children === "string") return [children]
-  if (typeof children === "number") return [String(children)]
+  if (typeof children === 'string') return [children]
+  if (typeof children === 'number') return [String(children)]
   if (Array.isArray(children)) return children.flatMap(normalizeChildren)
   if (isDocNode(children)) return [children]
-  if (typeof children === "object") {
+  if (typeof children === 'object') {
     throw new Error(
-      "[@pyreon/document] Invalid child: plain objects are not valid document children. Use a document node (Text, Heading, etc.) instead.",
+      '[@pyreon/document] Invalid child: plain objects are not valid document children. Use a document node (Text, Heading, etc.) instead.',
     )
   }
   return [String(children)]
@@ -48,11 +48,11 @@ function normalizeChildren(children: unknown): DocChild[] {
 /** Type guard — checks if a value is a DocNode. */
 export function isDocNode(value: unknown): value is DocNode {
   return (
-    typeof value === "object" &&
+    typeof value === 'object' &&
     value !== null &&
-    "type" in value &&
-    "props" in value &&
-    "children" in value
+    'type' in value &&
+    'props' in value &&
+    'children' in value
   )
 }
 
@@ -70,9 +70,9 @@ export function isDocNode(value: unknown): value is DocNode {
  */
 export function Document(props: DocumentProps): DocNode {
   const { children, ...rest } = props
-  return createNode("document", rest, children)
+  return createNode('document', rest, children)
 }
-Document._documentType = "document" as const
+Document._documentType = 'document' as const
 
 /**
  * Page container. Maps to a PDF page, DOCX section, or email block.
@@ -86,9 +86,9 @@ Document._documentType = "document" as const
  */
 export function Page(props: PageProps): DocNode {
   const { children, ...rest } = props
-  return createNode("page", rest, children)
+  return createNode('page', rest, children)
 }
-Page._documentType = "page" as const
+Page._documentType = 'page' as const
 
 /**
  * Layout section — groups content with optional direction, padding, background.
@@ -103,9 +103,9 @@ Page._documentType = "page" as const
  */
 export function Section(props: SectionProps): DocNode {
   const { children, ...rest } = props
-  return createNode("section", rest, children)
+  return createNode('section', rest, children)
 }
-Section._documentType = "section" as const
+Section._documentType = 'section' as const
 
 /**
  * Horizontal layout container.
@@ -120,18 +120,18 @@ Section._documentType = "section" as const
  */
 export function Row(props: RowProps): DocNode {
   const { children, ...rest } = props
-  return createNode("row", rest, children)
+  return createNode('row', rest, children)
 }
-Row._documentType = "row" as const
+Row._documentType = 'row' as const
 
 /**
  * Column within a Row.
  */
 export function Column(props: ColumnProps): DocNode {
   const { children, ...rest } = props
-  return createNode("column", rest, children)
+  return createNode('column', rest, children)
 }
-Column._documentType = "column" as const
+Column._documentType = 'column' as const
 
 /**
  * Heading text (h1–h6).
@@ -144,9 +144,9 @@ Column._documentType = "column" as const
  */
 export function Heading(props: HeadingProps): DocNode {
   const { children, ...rest } = props
-  return createNode("heading", { level: 1, ...rest }, children)
+  return createNode('heading', { level: 1, ...rest }, children)
 }
-Heading._documentType = "heading" as const
+Heading._documentType = 'heading' as const
 
 /**
  * Text paragraph with optional formatting.
@@ -159,9 +159,9 @@ Heading._documentType = "heading" as const
  */
 export function Text(props: TextProps): DocNode {
   const { children, ...rest } = props
-  return createNode("text", rest, children)
+  return createNode('text', rest, children)
 }
-Text._documentType = "text" as const
+Text._documentType = 'text' as const
 
 /**
  * Hyperlink.
@@ -173,9 +173,9 @@ Text._documentType = "text" as const
  */
 export function Link(props: LinkProps): DocNode {
   const { children, ...rest } = props
-  return createNode("link", rest, children)
+  return createNode('link', rest, children)
 }
-Link._documentType = "link" as const
+Link._documentType = 'link' as const
 
 /**
  * Image with optional sizing and caption.
@@ -187,9 +187,9 @@ Link._documentType = "link" as const
  * ```
  */
 export function Image(props: ImageProps): DocNode {
-  return createNode("image", props, [])
+  return createNode('image', props, [])
 }
-Image._documentType = "image" as const
+Image._documentType = 'image' as const
 
 /**
  * Data table with columns and rows.
@@ -205,9 +205,9 @@ Image._documentType = "image" as const
  * ```
  */
 export function Table(props: TableProps): DocNode {
-  return createNode("table", props, [])
+  return createNode('table', props, [])
 }
-Table._documentType = "table" as const
+Table._documentType = 'table' as const
 
 /**
  * Ordered or unordered list.
@@ -222,18 +222,18 @@ Table._documentType = "table" as const
  */
 export function List(props: ListProps): DocNode {
   const { children, ...rest } = props
-  return createNode("list", rest, children)
+  return createNode('list', rest, children)
 }
-List._documentType = "list" as const
+List._documentType = 'list' as const
 
 /**
  * Single list item within a List.
  */
 export function ListItem(props: ListItemProps): DocNode {
   const { children } = props
-  return createNode("list-item", {}, children)
+  return createNode('list-item', {}, children)
 }
-ListItem._documentType = "list-item" as const
+ListItem._documentType = 'list-item' as const
 
 /**
  * Code block with optional language hint.
@@ -245,9 +245,9 @@ ListItem._documentType = "list-item" as const
  */
 export function Code(props: CodeProps): DocNode {
   const { children, ...rest } = props
-  return createNode("code", rest, children)
+  return createNode('code', rest, children)
 }
-Code._documentType = "code" as const
+Code._documentType = 'code' as const
 
 /**
  * Horizontal divider line.
@@ -258,9 +258,9 @@ Code._documentType = "code" as const
  * ```
  */
 export function Divider(props: DividerProps = {}): DocNode {
-  return createNode("divider", props, [])
+  return createNode('divider', props, [])
 }
-Divider._documentType = "divider" as const
+Divider._documentType = 'divider' as const
 
 /**
  * Page break — forces content after this point to the next page (PDF/DOCX)
@@ -272,9 +272,9 @@ Divider._documentType = "divider" as const
  * ```
  */
 export function PageBreak(): DocNode {
-  return createNode("page-break", {}, [])
+  return createNode('page-break', {}, [])
 }
-PageBreak._documentType = "page-break" as const
+PageBreak._documentType = 'page-break' as const
 
 /**
  * Vertical spacer.
@@ -285,9 +285,9 @@ PageBreak._documentType = "page-break" as const
  * ```
  */
 export function Spacer(props: SpacerProps): DocNode {
-  return createNode("spacer", props, [])
+  return createNode('spacer', props, [])
 }
-Spacer._documentType = "spacer" as const
+Spacer._documentType = 'spacer' as const
 
 /**
  * CTA button — renders as a bulletproof button in email, styled link in PDF/DOCX.
@@ -301,9 +301,9 @@ Spacer._documentType = "spacer" as const
  */
 export function Button(props: ButtonProps): DocNode {
   const { children, ...rest } = props
-  return createNode("button", rest, children)
+  return createNode('button', rest, children)
 }
-Button._documentType = "button" as const
+Button._documentType = 'button' as const
 
 /**
  * Block quote.
@@ -315,6 +315,6 @@ Button._documentType = "button" as const
  */
 export function Quote(props: QuoteProps): DocNode {
   const { children, ...rest } = props
-  return createNode("quote", rest, children)
+  return createNode('quote', rest, children)
 }
-Quote._documentType = "quote" as const
+Quote._documentType = 'quote' as const