@bambamboole/pdf-ua-template-builder 0.2.0 → 0.3.1

package/dist/builder/inspector/TypographyControls.d.ts

@@ -0,0 +1,19 @@
+import { ReactNode } from 'react';
+import { Block, Template } from '../../types/generated/template';
+import { TemplateSchemaMetadata } from '../../types/template';
+interface TypographyControlsBaseProps {
+    metadata?: Pick<TemplateSchemaMetadata, "bundledFonts">;
+}
+export interface BlockTypographyControlsProps extends TypographyControlsBaseProps {
+    target: "block";
+    block: Block;
+    onChangeBlock: (block: Block) => void;
+}
+export interface TemplateTypographyControlsProps extends TypographyControlsBaseProps {
+    target: "template";
+    template: Template;
+    onChangeTemplate: (template: Template) => void;
+}
+export type TypographyControlsProps = BlockTypographyControlsProps | TemplateTypographyControlsProps;
+export declare function TypographyControls(props: TypographyControlsProps): ReactNode;
+export {};

package/dist/builder/inspector/alignOptions.d.ts

@@ -0,0 +1,10 @@
+export declare const ALIGN_OPTIONS: readonly [{
+    readonly value: "left";
+    readonly label: "Left";
+}, {
+    readonly value: "center";
+    readonly label: "Center";
+}, {
+    readonly value: "right";
+    readonly label: "Right";
+}];

package/dist/builder/inspector/editors/ImageBlockEditor.d.ts

@@ -0,0 +1,3 @@
+import { ReactNode } from 'react';
+import { BlockEditorProps } from './blockEditors';
+export declare function ImageBlockEditor({ block, onChangeBlock }: BlockEditorProps): ReactNode;

package/dist/builder/inspector/editors/KeyValueBlockEditor.d.ts

@@ -0,0 +1,11 @@
+import { ReactNode } from 'react';
+import { KeyValueBlock, KeyValueField } from '../../../types/generated/template';
+import { BlockEditorProps } from './blockEditors';
+export declare function moveField(fields: readonly KeyValueField[], sourceIndex: number, targetIndex: number): KeyValueField[];
+export declare function addField(block: KeyValueBlock): KeyValueBlock;
+export declare function removeField(block: KeyValueBlock, index: number): KeyValueBlock;
+export declare function renameFieldKey(block: KeyValueBlock, index: number, nextKey: string): KeyValueBlock;
+export declare function setFieldLabel(block: KeyValueBlock, index: number, nextLabel: string): KeyValueBlock;
+export declare function setValue(block: KeyValueBlock, key: string, nextValue: string): KeyValueBlock;
+export declare function reorderFields(block: KeyValueBlock, sourceIndex: number, targetIndex: number): KeyValueBlock;
+export declare function KeyValueBlockEditor({ block, onChangeBlock }: BlockEditorProps): ReactNode;

package/dist/builder/inspector/editors/SortableList.d.ts

@@ -0,0 +1,7 @@
+import { ReactNode } from 'react';
+export interface SortableListProps {
+    count: number;
+    onReorder: (sourceIndex: number, targetIndex: number) => void;
+    children: ReactNode;
+}
+export declare function SortableList({ count, onReorder, children }: SortableListProps): import("react/jsx-runtime").JSX.Element;

package/dist/builder/inspector/editors/SortableRow.d.ts

@@ -0,0 +1,10 @@
+import { ReactNode } from 'react';
+export interface SortableRowProps {
+    id: string;
+    dragLabel: string;
+    removeLabel: string;
+    removeName?: string;
+    onRemove: () => void;
+    children: ReactNode;
+}
+export declare function SortableRow({ id, dragLabel, removeLabel, removeName, onRemove, children, }: SortableRowProps): import("react/jsx-runtime").JSX.Element;

package/dist/builder/inspector/editors/TableBlockEditor.d.ts

@@ -0,0 +1,20 @@
+import { ReactNode } from 'react';
+import { TableBlock, TableColumn } from '../../../types/generated/template';
+import { BlockEditorProps } from './blockEditors';
+type TableRow = Record<string, string>;
+export declare function moveColumn(columns: readonly TableColumn[], sourceIndex: number, targetIndex: number): TableColumn[];
+export declare function moveRow(rows: readonly TableRow[], sourceIndex: number, targetIndex: number): TableRow[];
+export declare function addColumn(block: TableBlock): TableBlock;
+export declare function removeColumn(block: TableBlock, index: number): TableBlock;
+export declare function renameColumnKey(block: TableBlock, index: number, nextKey: string): TableBlock;
+export declare function setColumnLabel(block: TableBlock, index: number, nextLabel: string): TableBlock;
+export declare function setColumnAlign(block: TableBlock, index: number, nextAlign: string): TableBlock;
+export declare function setTableNumberRows(block: TableBlock, value: boolean | undefined): TableBlock;
+export declare function reorderColumns(block: TableBlock, sourceIndex: number, targetIndex: number): TableBlock;
+export declare function addRow(rows: readonly TableRow[], columns: readonly TableColumn[]): TableRow[];
+export declare function removeRow(rows: readonly TableRow[], index: number): TableRow[];
+export declare function setCellValue(rows: readonly TableRow[], index: number, key: string, nextValue: string): TableRow[];
+export declare function removeColumnKeyFromRows(rows: readonly TableRow[], key: string): TableRow[];
+export declare function renameColumnKeyInRows(rows: readonly TableRow[], previousKey: string, nextKey: string): TableRow[];
+export declare function TableBlockEditor({ block, rowData, onChangeBlock, onChangeRowData, }: BlockEditorProps): ReactNode;
+export {};

package/dist/builder/inspector/editors/blockEditors.d.ts

@@ -0,0 +1,7 @@
+import { Block } from '../../../types/generated/template';
+export interface BlockEditorProps {
+    block: Block;
+    onChangeBlock: (block: Block) => void;
+    rowData?: unknown;
+    onChangeRowData?: (data: unknown) => void;
+}

package/dist/builder/lib/records.d.ts

@@ -0,0 +1,4 @@
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function omitKey<TValue>(record: Record<string, TValue>, key: string): Record<string, TValue>;
+export declare function renameKey<TValue>(record: Record<string, TValue>, previousKey: string, nextKey: string): Record<string, TValue>;
+export declare function nextKeyIndex(keys: readonly string[], prefix: string): number;

package/dist/builder/lib/sensors.d.ts

@@ -0,0 +1 @@
+export declare function useBuilderSensors(): import('@dnd-kit/core').SensorDescriptor<import('@dnd-kit/core').SensorOptions>[];

package/dist/builder/primitives/Button.d.ts

@@ -0,0 +1,10 @@
+import { ButtonHTMLAttributes, ReactNode } from 'react';
+export type ButtonVariant = "default" | "primary" | "danger" | "ghost";
+export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    variant?: ButtonVariant;
+    /** Render as a square icon button (no label padding). */
+    icon?: boolean;
+    children: ReactNode;
+}
+export declare function Button({ variant, icon, type, className, children, ...rest }: ButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function AddButton({ type, className, children, ...rest }: ButtonHTMLAttributes<HTMLButtonElement>): import("react/jsx-runtime").JSX.Element;

package/dist/builder/primitives/Chip.d.ts

@@ -0,0 +1,7 @@
+import { ReactNode } from 'react';
+export interface ChipProps {
+    children: ReactNode;
+    /** Grow to fit multi-character labels instead of staying a 22×22 square. */
+    wide?: boolean;
+}
+export declare function Chip({ children, wide }: ChipProps): import("react/jsx-runtime").JSX.Element;

package/dist/builder/schema/schemaAdapter.d.ts

@@ -1,9 +1,6 @@
 import { Block } from '../../types/generated/template';
-import { TemplateSchemaMetadata } from '../../types/template';
-export type JsonSchemaValue = string | number | boolean | null | JsonSchemaObject | JsonSchemaValue[];
-export interface JsonSchemaObject {
-    [key: string]: unknown;
-}
+import { JsonSchemaObject, JsonSchemaValue, TemplateSchemaMetadata } from '../../types/template';
+export type { JsonSchemaObject, JsonSchemaValue };
 export declare function getSchemaMetadata(schema: JsonSchemaObject): TemplateSchemaMetadata;
 export declare function resolveRef(schema: JsonSchemaObject, ref: string): JsonSchemaObject;
 export declare function getBlockTypes(schema: JsonSchemaObject): string[];

package/dist/builder/state/configUpdates.d.ts

@@ -0,0 +1,23 @@
+import { Block, BlockConfig, DividerConfig, HeadingConfig, ImageConfig, KeyValueConfig, SpacingConfig, SpacerConfig, TableConfig, Template, TypographyConfig } from '../../types/generated/template';
+type EmptyConfigValue = "" | null | undefined;
+type BlockType = Block["type"];
+type BlockByType<TType extends BlockType> = Extract<Block, {
+    type: TType;
+}>;
+type BlockConfigByType = {
+    text: BlockConfig;
+    html: BlockConfig;
+    heading: HeadingConfig;
+    image: ImageConfig;
+    "key-value": KeyValueConfig;
+    spacer: SpacerConfig;
+    divider: DividerConfig;
+    table: TableConfig;
+};
+type BlockConfigFor<TType extends BlockType> = BlockConfigByType[TType];
+export declare function setBlockConfigField<TType extends BlockType, TKey extends keyof BlockConfigFor<TType>>(block: BlockByType<TType>, field: TKey, value: BlockConfigFor<TType>[TKey] | EmptyConfigValue): BlockByType<TType>;
+export declare function setBlockTypographyField<TType extends BlockType, TKey extends keyof TypographyConfig>(block: BlockByType<TType>, field: TKey, value: TypographyConfig[TKey] | EmptyConfigValue): BlockByType<TType>;
+export declare function setBlockSpacingField<TType extends BlockType, TKey extends keyof SpacingConfig>(block: BlockByType<TType>, field: TKey, value: SpacingConfig[TKey] | EmptyConfigValue): BlockByType<TType>;
+export declare function setTemplateTypographyField<TKey extends keyof TypographyConfig>(template: Template, field: TKey, value: TypographyConfig[TKey] | EmptyConfigValue): Template;
+export declare function setTemplatePageMargin<TKey extends keyof SpacingConfig>(template: Template, field: TKey, value: SpacingConfig[TKey] | EmptyConfigValue): Template;
+export {};

package/dist/builder/state/dragDrop.d.ts

@@ -0,0 +1,17 @@
+import { UniqueIdentifier } from '@dnd-kit/core';
+import { EditorArea, EditorModel } from './editorModel';
+export interface DragData {
+    source?: string;
+    type?: string;
+    rowUid?: string;
+    blockUid?: string;
+    area?: EditorArea;
+}
+export interface DropTarget {
+    rowUid: string | null;
+    index: number;
+    area: EditorArea;
+}
+export declare function getDragData(value: unknown): DragData;
+export declare function getDropTarget(model: EditorModel, overId: UniqueIdentifier | undefined, overData: DragData): DropTarget;
+export declare function getRowIndex(model: EditorModel, overId: UniqueIdentifier | undefined, overData: DragData): number | null;

package/dist/builder/state/editorModel.d.ts

@@ -27,6 +27,7 @@ export declare function removeBlock(model: EditorModel, blockUid: string): Edito
 export declare function moveBlock(model: EditorModel, blockUid: string, rowUid: string | null, index: number, area?: EditorArea): EditorModel;
 export declare function moveRow(model: EditorModel, rowUid: string, index: number): EditorModel;
 export declare function updateBlock(model: EditorModel, blockUid: string, block: Block): EditorModel;
+export declare function updateTemplateSettings(model: EditorModel, template: Template): EditorModel;
 export declare function getPageSize(model: EditorModel): ResolvedPageSize;
 export declare function setPageSize(model: EditorModel, format: PageFormat, orientation: Orientation): EditorModel;
 export declare function setRowWidths(model: EditorModel, rowUid: string, widths: string[]): EditorModel;
@@ -34,3 +35,7 @@ export declare function getFooterRepeat(model: EditorModel): boolean;
 export declare function setFooterRepeat(model: EditorModel, repeat: boolean): EditorModel;
 export declare function getPageNumbers(model: EditorModel): PageNumbersValue;
 export declare function setPageNumbers(model: EditorModel, value: PageNumbersValue): EditorModel;
+export declare function findEditorBlock(model: EditorModel, blockUid: string): EditorBlock | undefined;
+export declare function resolveSelectedEditorBlock(model: EditorModel, blockUid: string | null): EditorBlock | null;
+export declare function reconcileSelectedBlockUid(model: EditorModel, blockUid: string | null): string | null;
+export declare function createNextBlockId(model: EditorModel, blockType: string): string;

package/dist/builder/state/editorReducer.d.ts

@@ -0,0 +1,71 @@
+import { UniqueIdentifier } from '@dnd-kit/core';
+import { Block, Orientation, PageFormat, Template } from '../../types/generated/template';
+import { JsonSchemaObject, TemplateData } from '../../types/template';
+import { DragData } from './dragDrop';
+import { EditorModel, PageNumbersValue } from './editorModel';
+export interface EditorState {
+    model: EditorModel;
+    data: TemplateData;
+    selectedBlockUid: string | null;
+}
+export type EditorAction = {
+    type: "selectBlock";
+    blockUid: string;
+} | {
+    type: "deselect";
+} | {
+    type: "changeBlock";
+    blockUid: string;
+    block: Block;
+} | {
+    type: "removeBlock";
+    blockUid: string;
+} | {
+    type: "changeTemplateSettings";
+    template: Template;
+} | {
+    type: "setRowWidths";
+    rowUid: string;
+    widths: string[];
+} | {
+    type: "addBlock";
+    schema: JsonSchemaObject;
+    blockType: string;
+} | {
+    type: "setFormat";
+    format: PageFormat;
+} | {
+    type: "setOrientation";
+    orientation: Orientation;
+} | {
+    type: "setFooterRepeat";
+    repeat: boolean;
+} | {
+    type: "setPageNumbers";
+    value: PageNumbersValue;
+} | {
+    type: "setData";
+    data: TemplateData;
+} | {
+    type: "loadExample";
+    template: Template;
+    data: TemplateData;
+} | {
+    type: "dropFromPalette";
+    schema: JsonSchemaObject;
+    blockType: string;
+    overId?: UniqueIdentifier;
+    overData: DragData;
+} | {
+    type: "moveRowTo";
+    rowUid: string;
+    overId?: UniqueIdentifier;
+    overData: DragData;
+} | {
+    type: "moveBlockTo";
+    blockUid: string;
+    overId?: UniqueIdentifier;
+    overData: DragData;
+};
+export declare function createEditorState(template: Template, data: TemplateData): EditorState;
+export declare function editorReducer(state: EditorState, action: EditorAction): EditorState;

package/dist/editor/CodeEditor.d.ts

@@ -0,0 +1,4 @@
+export interface CodeEditorProps {
+    className?: string;
+}
+export declare function CodeEditor({ className }?: CodeEditorProps): import("react/jsx-runtime").JSX.Element;

package/dist/editor/TemplateEditor.d.ts

@@ -0,0 +1,23 @@
+import { Template } from '../types/generated/template';
+import { TemplateData } from '../types/template';
+export interface TemplateEditorProps {
+    /** Base URL of a running pdf-ua-api instance. Defaults to "" (relative URLs / proxy). */
+    apiUrl?: string;
+    /** Template seeded into the editor as pretty-printed JSON on first render. */
+    initialTemplate?: Template;
+    /** Runtime data keyed by block id, passed through to render. */
+    data?: TemplateData;
+    /** Fires on every edit; `template` is null while the JSON is invalid. */
+    onChange?: (template: Template | null, text: string) => void;
+    /** Fires after a successful render with the produced PDF blob. */
+    onRendered?: (pdf: Blob) => void;
+    /** Optional className appended to the root element. */
+    className?: string;
+}
+/**
+ * All-in-one preset: a JSON template editor and a rendered-PDF preview side by side.
+ *
+ * For custom layouts, compose directly with `TemplateEditorProvider`, `CodeEditor`,
+ * and `Preview`.
+ */
+export declare function TemplateEditor({ apiUrl, initialTemplate, data, onChange, onRendered, className, }?: TemplateEditorProps): import("react/jsx-runtime").JSX.Element;

package/dist/editor/TemplateEditorContext.d.ts

@@ -0,0 +1,20 @@
+import { ReactNode } from 'react';
+import { Template } from '../types/generated/template';
+import { TemplateData } from '../types/template';
+export interface TemplateEditorProviderProps {
+    apiUrl?: string;
+    initialTemplate?: Template;
+    data?: TemplateData;
+    onChange?: (template: Template | null, text: string) => void;
+    onRendered?: (pdf: Blob) => void;
+    children: ReactNode;
+}
+export interface TemplateEditorContextValue {
+    text: string;
+    setText: (text: string) => void;
+    template: Template | null;
+    error: string | null;
+    data: TemplateData;
+}
+export declare function useTemplateEditor(): TemplateEditorContextValue;
+export declare function TemplateEditorProvider({ apiUrl: apiUrlProp, initialTemplate, data, onChange, onRendered, children, }: TemplateEditorProviderProps): import("react/jsx-runtime").JSX.Element;

package/dist/editor/editorTheme.d.ts

@@ -0,0 +1 @@
+export declare const editorTheme: import('@codemirror/state').Extension[];

package/dist/editor/parseTemplate.d.ts

@@ -0,0 +1,6 @@
+import { Template } from '../types/generated/template';
+export interface ParsedTemplate {
+    template: Template | null;
+    error: string | null;
+}
+export declare function parseTemplate(text: string): ParsedTemplate;

package/dist/editor/templateSchema.d.ts

@@ -0,0 +1 @@
+export declare const templateSchema: Record<string, unknown>;

package/dist/index.d.ts

@@ -1,11 +1,23 @@
 export { TemplateBuilder } from './builder/TemplateBuilder';
 export type { TemplateBuilderProps } from './builder/TemplateBuilder';
+export { Builder } from './builder/Builder';
+export type { BuilderProps } from './builder/Builder';
+export { Preview } from './render/Preview';
+export type { PreviewProps } from './render/Preview';
+export { TemplateBuilderProvider, useTemplateBuilder } from './builder/context/BuilderContext';
+export type { TemplateBuilderProviderProps, BuilderContextValue, TemplateExample, } from './builder/context/BuilderContext';
 export { createInvoiceExample } from './builder/schema/invoiceExample';
 export type { InvoiceExample, InvoiceData, TableRow } from './builder/schema/invoiceExample';
 export { PAGE_SIZES_MM, pageSizeForFormat } from './builder/lib/pageSizes';
 export { mmToPx } from './builder/lib/displayScale';
 export { createEditorModel, serializeTemplate, getPageSize, setPageSize, getFooterRepeat, setFooterRepeat, getPageNumbers, setPageNumbers, } from './builder/state/editorModel';
 export type { EditorArea, EditorBlock, EditorModel, EditorRow, PageNumbersValue, ResolvedPageSize, } from './builder/state/editorModel';
+export { TemplateEditor } from './editor/TemplateEditor';
+export type { TemplateEditorProps } from './editor/TemplateEditor';
+export { CodeEditor } from './editor/CodeEditor';
+export type { CodeEditorProps } from './editor/CodeEditor';
+export { TemplateEditorProvider, useTemplateEditor, } from './editor/TemplateEditorContext';
+export type { TemplateEditorProviderProps, TemplateEditorContextValue, } from './editor/TemplateEditorContext';
 export { fetchTemplateSchema, renderTemplatePdf, resolveDefaultApiUrl } from './api/pdfUaApi';
 export type { TemplateData, TemplateSchemaResponse } from './types/template';
 export type { Align, Block, HeadingBlock, ImageBlock, KeyValueBlock, Orientation, PageConfig, PageFormat, PageSize, Row, SpacerBlock, TableBlock, Template, TextBlock, } from './types/generated/template';