@pyreon/document-primitives 0.24.5 → 0.24.6

package/src/primitives/DocPage.ts

@@ -1,21 +0,0 @@
-import { Element } from '@pyreon/elements'
-import rocketstyle from '@pyreon/rocketstyle'
-
-const DocPage = rocketstyle()({ name: 'DocPage', component: Element })
-  .theme({
-    backgroundColor: '#ffffff',
-    padding: '25mm',
-  })
-  .statics({ _documentType: 'page' as const })
-  .attrs<{
-    size?: string
-    orientation?: string
-  }>((props) => ({
-    tag: 'div',
-    _documentProps: {
-      ...(props.size ? { size: props.size } : {}),
-      ...(props.orientation ? { orientation: props.orientation } : {}),
-    },
-  }))
-
-export default DocPage

package/src/primitives/DocPageBreak.ts

@@ -1,11 +0,0 @@
-import { Element } from '@pyreon/elements'
-import rocketstyle from '@pyreon/rocketstyle'
-
-const DocPageBreak = rocketstyle()({ name: 'DocPageBreak', component: Element })
-  .statics({ _documentType: 'page-break' as const })
-  .attrs(() => ({
-    tag: 'div',
-    _documentProps: {},
-  }))
-
-export default DocPageBreak

package/src/primitives/DocQuote.ts

@@ -1,17 +0,0 @@
-import { Element } from '@pyreon/elements'
-import rocketstyle from '@pyreon/rocketstyle'
-
-const DocQuote = rocketstyle()({ name: 'DocQuote', component: Element })
-  .theme({
-    borderColor: '#4f46e5',
-    padding: '8px 16px',
-    fontStyle: 'italic',
-    color: '#666666',
-  })
-  .statics({ _documentType: 'quote' as const })
-  .attrs<{ borderColor?: string }>((props) => ({
-    tag: 'blockquote',
-    _documentProps: props.borderColor ? { borderColor: props.borderColor } : {},
-  }))
-
-export default DocQuote

package/src/primitives/DocRow.ts

@@ -1,19 +0,0 @@
-import { Element } from '@pyreon/elements'
-import rocketstyle from '@pyreon/rocketstyle'
-
-/**
- * Horizontal row of inline children. Per project conventions, layout
- * props (`direction`, `gap`) live in `.attrs()`, not `.theme()`. The
- * Element base accepts `direction: 'inline' | 'rows' | 'reverseInline'
- * | 'reverseRows'` — `'row'` is not a valid value.
- */
-const DocRow = rocketstyle()({ name: 'DocRow', component: Element })
-  .statics({ _documentType: 'row' as const })
-  .attrs(() => ({
-    tag: 'div',
-    direction: 'inline' as const,
-    gap: 8,
-    _documentProps: {},
-  }))
-
-export default DocRow

package/src/primitives/DocSection.ts

@@ -1,23 +0,0 @@
-import { Element } from '@pyreon/elements'
-import rocketstyle from '@pyreon/rocketstyle'
-
-const DocSection = rocketstyle({
-  dimensions: {
-    directions: 'direction',
-  },
-  useBooleans: false,
-})({ name: 'DocSection', component: Element })
-  .theme({
-    padding: 0,
-  })
-  .directions({
-    column: {},
-    row: { direction: 'row' },
-  })
-  .statics({ _documentType: 'section' as const })
-  .attrs<{ direction?: string }>((props) => ({
-    tag: 'div',
-    _documentProps: { direction: props.direction ?? 'column' },
-  }))
-
-export default DocSection

package/src/primitives/DocSpacer.ts

@@ -1,11 +0,0 @@
-import { Element } from '@pyreon/elements'
-import rocketstyle from '@pyreon/rocketstyle'
-
-const DocSpacer = rocketstyle()({ name: 'DocSpacer', component: Element })
-  .statics({ _documentType: 'spacer' as const })
-  .attrs<{ height?: number }>((props) => ({
-    tag: 'div',
-    _documentProps: { height: props.height ?? 16 },
-  }))
-
-export default DocSpacer

package/src/primitives/DocTable.ts

@@ -1,57 +0,0 @@
-import { Element } from '@pyreon/elements'
-import rocketstyle from '@pyreon/rocketstyle'
-
-/**
- * Tabular data primitive.
- *
- * The `columns`, `rows`, `headerStyle`, `striped`, `bordered`, and
- * `caption` props are document-export metadata — they belong in
- * `_documentProps` only and must NOT be forwarded to the rendered
- * `<table>` element. The `filter` option on `.attrs()` strips them
- * from the props that flow into the DOM.
- *
- * Why this matters: HTMLTableElement's `rows` property is a
- * read-only `HTMLCollection` of `<tr>` elements. If `rows` were
- * forwarded as a DOM attr, the runtime would call
- * `el.rows = [...]` and crash with
- * `TypeError: Cannot set property rows of [object Object] which has
- * only a getter`. Same family for `columns` (`HTMLTableColElement`'s
- * column collection on parent table). Filtering them at the
- * rocketstyle layer keeps the DOM render path clean.
- */
-const DocTable = rocketstyle({
-  dimensions: {
-    variants: 'variant',
-  },
-  useBooleans: true,
-})({ name: 'DocTable', component: Element })
-  .theme({
-    fontSize: 14,
-    borderColor: '#dddddd',
-  })
-  .statics({ _documentType: 'table' as const })
-  .attrs<{
-    columns?: unknown[]
-    rows?: unknown[]
-    headerStyle?: Record<string, unknown>
-    striped?: boolean
-    bordered?: boolean
-    caption?: string
-  }>(
-    (props) => ({
-      tag: 'table',
-      _documentProps: {
-        columns: props.columns ?? [],
-        rows: props.rows ?? [],
-        ...(props.headerStyle ? { headerStyle: props.headerStyle } : {}),
-        ...(props.striped ? { striped: props.striped } : {}),
-        ...(props.bordered ? { bordered: props.bordered } : {}),
-        ...(props.caption ? { caption: props.caption } : {}),
-      },
-    }),
-    {
-      filter: ['columns', 'rows', 'headerStyle', 'striped', 'bordered', 'caption'],
-    },
-  )
-
-export default DocTable

package/src/primitives/DocText.ts

@@ -1,31 +0,0 @@
-import { Text } from '@pyreon/elements'
-import rocketstyle from '@pyreon/rocketstyle'
-
-const DocText = rocketstyle({
-  dimensions: {
-    variants: 'variant',
-    weights: 'weight',
-  },
-  useBooleans: true,
-})({ name: 'DocText', component: Text })
-  .theme({
-    color: '#333333',
-    lineHeight: 1.5,
-    marginBottom: 8,
-  })
-  .variants({
-    body: { fontSize: 14 },
-    caption: { fontSize: 12, color: '#666666' },
-    label: { fontSize: 11, fontWeight: 'bold' },
-  })
-  .weights({
-    normal: { fontWeight: 'normal' },
-    bold: { fontWeight: 'bold' },
-  })
-  .statics({ _documentType: 'text' as const })
-  .attrs(() => ({
-    tag: 'p',
-    _documentProps: {},
-  }))
-
-export default DocText

package/src/theme.ts

@@ -1,37 +0,0 @@
-export const documentTheme = {
-  colors: {
-    primary: '#4f46e5',
-    text: '#333333',
-    textSecondary: '#666666',
-    background: '#ffffff',
-    border: '#dddddd',
-    headerBg: '#1a1a2e',
-    headerText: '#ffffff',
-    stripedRow: '#f9f9f9',
-  },
-  fonts: {
-    heading: 'system-ui, -apple-system, sans-serif',
-    body: 'system-ui, -apple-system, sans-serif',
-    mono: 'ui-monospace, monospace',
-  },
-  sizes: {
-    h1: 32,
-    h2: 24,
-    h3: 20,
-    h4: 18,
-    h5: 16,
-    h6: 14,
-    body: 14,
-    caption: 12,
-    label: 11,
-  },
-  spacing: {
-    xs: 4,
-    sm: 8,
-    md: 16,
-    lg: 24,
-    xl: 40,
-  },
-}
-
-export type DocumentTheme = typeof documentTheme

package/src/useDocumentExport.ts

@@ -1,84 +0,0 @@
-import type { DocNode, ExtractOptions } from '@pyreon/connector-document'
-import { extractDocumentTree } from '@pyreon/connector-document'
-
-export interface DocumentExportOptions extends ExtractOptions {
-  /** Theme object to provide during extraction. */
-  theme?: Record<string, unknown>
-  /** Mode: 'light' or 'dark'. */
-  mode?: 'light' | 'dark'
-}
-
-export interface DocumentExport {
-  /** Extract the DocNode tree from the template. */
-  getDocNode: () => DocNode
-}
-
-/**
- * One-step helper: extract a DocNode tree from a template function.
- *
- * Equivalent to `createDocumentExport(templateFn).getDocNode()` but
- * without the wrapper-object indirection. Use this when you just
- * need the tree to feed into `@pyreon/document`'s `render()` or
- * `download()` — which is the only thing the wrapper object was
- * ever used for in practice.
- *
- * ```ts
- * import { extractDocNode } from '@pyreon/document-primitives'
- * import { download } from '@pyreon/document'
- *
- * function ResumeTemplate({ resume }: { resume: () => Resume }) {
- *   return (
- *     <DocDocument title={() => `${resume().name} — Resume`}>
- *       <DocPage>...</DocPage>
- *     </DocDocument>
- *   )
- * }
- *
- * // Export click handler:
- * const tree = extractDocNode(() => <ResumeTemplate resume={store.resume} />)
- * await download(tree, 'resume.pdf')
- * ```
- *
- * The two-step `createDocumentExport` form is still exported for
- * backward compatibility and for callers that want to pass the
- * helper object around (e.g. to wrapper components that take a
- * `DocumentExport` instance). New code should prefer this one-step
- * form unless you specifically need the helper object.
- */
-export function extractDocNode(
-  templateFn: () => unknown,
-  options: DocumentExportOptions = {},
-): DocNode {
-  return extractDocumentTree(templateFn(), options)
-}
-
-/**
- * Create a document export helper from a template function.
- *
- * The template function should return a VNode tree built with
- * document primitives (DocHeading, DocText, DocTable, etc.).
- *
- * ```ts
- * const doc = createDocumentExport(() =>
- *   DocDocument({ title: 'Report', children: [
- *     DocHeading({ h1: true, children: 'Sales Report' }),
- *     DocText({ children: 'Q4 summary.' }),
- *   ]})
- * )
- *
- * const tree = doc.getDocNode()
- * // Pass to @pyreon/document's render() for any format
- * ```
- *
- * **Most consumers should use `extractDocNode(templateFn)` instead**
- * — it's the same operation in one call without the wrapper
- * object. `createDocumentExport` is kept for callers that want to
- * pass the helper object around.
- */
-export function createDocumentExport(
-  templateFn: () => unknown,
-  options: DocumentExportOptions = {},
-): DocumentExport {
-  const getDocNode = (): DocNode => extractDocNode(templateFn, options)
-  return { getDocNode }
-}