@twinfinity/printing 6.0.1-ci.28952-beta → 6.0.2-beta

package/src/layout/exportDrawing.ts

@@ -1,206 +1,206 @@
-/**
- * Drawing export utilities for converting SVG markup to various formats.
- *
- * This module provides functions for exporting drawings to PDF and SVG files.
- * These are pure functions that take SVG markup and export options, with no
- * dependencies on BIM viewer APIs or application state.
- *
- * @module exportDrawing
- */
-
-import { exportSectionToPdf, exportSectionToSvg } from '../printToPdf';
-
-/**
- * Extracts page dimensions from SVG markup.
- * Parses the width/height attributes from the root <svg> element.
- *
- * @param svg - SVG markup string
- * @returns Page dimensions in millimeters
- * @throws {Error} If SVG dimensions cannot be parsed
- */
-function extractPageSizeFromSvg(svg: string): { widthMm: number; heightMm: number } {
-    // Match width and height attributes (supports both "420mm" and "420" formats)
-    const widthMatch = svg.match(/width="([0-9.]+)(?:mm)?"/);
-    const heightMatch = svg.match(/height="([0-9.]+)(?:mm)?"/);
-
-    if (!widthMatch || !heightMatch) {
-        throw new Error(
-            'Cannot extract page size from SVG. SVG must have width and height attributes. ' +
-                'Provide pageSize option explicitly or ensure SVG contains width/height attributes.'
-        );
-    }
-
-    const widthMm = parseFloat(widthMatch[1]);
-    const heightMm = parseFloat(heightMatch[1]);
-
-    if (!Number.isFinite(widthMm) || !Number.isFinite(heightMm) || widthMm <= 0 || heightMm <= 0) {
-        throw new Error(
-            `Invalid page dimensions extracted from SVG: ${widthMm}mm × ${heightMm}mm. ` +
-                'Provide pageSize option explicitly.'
-        );
-    }
-
-    return { widthMm, heightMm };
-}
-
-/**
- * Options for exporting a drawing to PDF format.
- */
-export interface ExportPdfOptions {
-    /**
-     * Output filename (with or without .pdf extension).
-     * Default: "drawing.pdf"
-     */
-    filename?: string;
-
-    /**
-     * Optional page dimensions in millimeters.
-     * If not provided, automatically extracted from SVG width/height attributes.
-     * Only needed if you want to override the SVG's embedded page size.
-     */
-    pageSize?: {
-        widthMm: number;
-        heightMm: number;
-    };
-
-    /**
-     * If true, opens PDF in a new browser tab.
-     * If false, downloads the PDF file.
-     * Default: false (download)
-     */
-    openInNewTab?: boolean;
-}
-
-/**
- * Options for exporting a drawing to SVG format.
- */
-export interface ExportSvgOptions {
-    /**
-     * Output filename (with or without .svg extension).
-     * Default: "drawing.svg"
-     */
-    filename?: string;
-
-    /**
-     * If true, opens SVG in a new browser tab.
-     * If false, downloads the SVG file.
-     * Default: false (download)
-     */
-    openInNewTab?: boolean;
-}
-
-/**
- * Exports an SVG drawing to PDF format.
- *
- * Converts the SVG markup to a vector PDF using jsPDF and svg2pdf.js.
- * The PDF maintains full vector quality with no rasterization.
- *
- * **Page size is automatically extracted from the SVG** (width/height attributes),
- * so you don't need to specify it manually. The template's page dimensions are
- * embedded in the SVG markup by renderDrawing() or renderLayout().
- *
- * **Features:**
- * - ✅ Vector PDF output (scalable, searchable text)
- * - ✅ Preserves colors, strokes, fills, fonts
- * - ✅ No quality loss (unlike raster export)
- * - ✅ Small file size (vector graphics)
- * - ✅ Automatic page size detection from SVG
- *
- * **Use cases:**
- * - Print-ready construction documents
- * - Archival drawings
- * - Sharing with clients/contractors
- * - CAD import (vector format)
- *
- * @param svg - SVG markup string (from renderDrawing() or renderLayout())
- * @param options - Export options (filename, optional page size override, open vs download)
- * @returns Promise that resolves when export completes
- *
- * @example
- * ```typescript
- * // Basic usage - page size is automatically extracted from SVG
- * const { svg } = await renderDrawing({ template, models });
- * await exportToPdf(svg, {
- *   filename: "floor-plan.pdf",
- *   openInNewTab: true
- * });
- *
- * // With custom filename
- * await exportToPdf(svg, {
- *   filename: `${template.id}-${new Date().toISOString().slice(0,10)}.pdf`
- * });
- *
- * // Override page size if needed (rare)
- * await exportToPdf(svg, {
- *   filename: "custom.pdf",
- *   pageSize: { widthMm: 420, heightMm: 297 },  // A3 landscape override
- *   openInNewTab: false
- * });
- * ```
- *
- * @throws {Error} If PDF generation fails or SVG page size cannot be extracted
- */
-export async function exportToPdf(svg: string, options: ExportPdfOptions = {}): Promise<void> {
-    const filename = options.filename ?? 'drawing.pdf';
-    const filenameWithExt = filename.endsWith('.pdf') ? filename : `${filename}.pdf`;
-
-    // Extract page size from SVG if not provided
-    const pageSize = options.pageSize ?? extractPageSizeFromSvg(svg);
-
-    await exportSectionToPdf({
-        svgMarkup: svg,
-        fileName: filenameWithExt,
-        pageSizeMm: pageSize as any,
-        openInNewTab: options.openInNewTab ?? false
-    });
-}
-
-/**
- * Exports an SVG drawing to SVG file format.
- *
- * Saves or displays the SVG markup as a standalone .svg file.
- * The SVG can be opened in browsers, vector editors (Inkscape, Illustrator),
- * or imported into CAD software.
- *
- * **Features:**
- * - ✅ Native vector format (editable in SVG editors)
- * - ✅ Smallest file size (XML text)
- * - ✅ Web-friendly (can embed in HTML)
- * - ✅ Full styling preserved
- *
- * **Use cases:**
- * - Web display (embed in HTML)
- * - Vector editing (Inkscape, Illustrator)
- * - Further processing (scripting, automation)
- * - Archival (open standard format)
- *
- * @param svg - SVG markup string (from renderDrawing())
- * @param options - Export options (filename, open vs download)
- * @returns Promise that resolves when export completes
- *
- * @example
- * ```typescript
- * // Basic usage
- * const { svg } = await renderDrawing({ template, models });
- * await exportToSvg(svg, {
- *   filename: "floor-plan.svg",
- *   openInNewTab: true
- * });
- *
- * // Download with custom name
- * await exportToSvg(svg, {
- *   filename: `${template.id}-${Date.now()}.svg`,
- *   openInNewTab: false
- * });
- * ```
- */
-export function exportToSvg(svg: string, options: ExportSvgOptions = {}): void {
-    const filename = options.filename ?? 'drawing.svg';
-    const filenameWithExt = filename.endsWith('.svg') ? filename : `${filename}.svg`;
-
-    exportSectionToSvg({
-        svgMarkup: svg,
-        fileName: filenameWithExt,
-        openInNewTab: options.openInNewTab ?? false
-    });
-}
+/**
+ * Drawing export utilities for converting SVG markup to various formats.
+ *
+ * This module provides functions for exporting drawings to PDF and SVG files.
+ * These are pure functions that take SVG markup and export options, with no
+ * dependencies on BIM viewer APIs or application state.
+ *
+ * @module exportDrawing
+ */
+
+import { exportSectionToPdf, exportSectionToSvg } from '../printToPdf';
+
+/**
+ * Extracts page dimensions from SVG markup.
+ * Parses the width/height attributes from the root <svg> element.
+ *
+ * @param svg - SVG markup string
+ * @returns Page dimensions in millimeters
+ * @throws {Error} If SVG dimensions cannot be parsed
+ */
+function extractPageSizeFromSvg(svg: string): { widthMm: number; heightMm: number } {
+    // Match width and height attributes (supports both "420mm" and "420" formats)
+    const widthMatch = svg.match(/width="([0-9.]+)(?:mm)?"/);
+    const heightMatch = svg.match(/height="([0-9.]+)(?:mm)?"/);
+
+    if (!widthMatch || !heightMatch) {
+        throw new Error(
+            'Cannot extract page size from SVG. SVG must have width and height attributes. ' +
+                'Provide pageSize option explicitly or ensure SVG contains width/height attributes.'
+        );
+    }
+
+    const widthMm = parseFloat(widthMatch[1]);
+    const heightMm = parseFloat(heightMatch[1]);
+
+    if (!Number.isFinite(widthMm) || !Number.isFinite(heightMm) || widthMm <= 0 || heightMm <= 0) {
+        throw new Error(
+            `Invalid page dimensions extracted from SVG: ${widthMm}mm × ${heightMm}mm. ` +
+                'Provide pageSize option explicitly.'
+        );
+    }
+
+    return { widthMm, heightMm };
+}
+
+/**
+ * Options for exporting a drawing to PDF format.
+ */
+export interface ExportPdfOptions {
+    /**
+     * Output filename (with or without .pdf extension).
+     * Default: "drawing.pdf"
+     */
+    filename?: string;
+
+    /**
+     * Optional page dimensions in millimeters.
+     * If not provided, automatically extracted from SVG width/height attributes.
+     * Only needed if you want to override the SVG's embedded page size.
+     */
+    pageSize?: {
+        widthMm: number;
+        heightMm: number;
+    };
+
+    /**
+     * If true, opens PDF in a new browser tab.
+     * If false, downloads the PDF file.
+     * Default: false (download)
+     */
+    openInNewTab?: boolean;
+}
+
+/**
+ * Options for exporting a drawing to SVG format.
+ */
+export interface ExportSvgOptions {
+    /**
+     * Output filename (with or without .svg extension).
+     * Default: "drawing.svg"
+     */
+    filename?: string;
+
+    /**
+     * If true, opens SVG in a new browser tab.
+     * If false, downloads the SVG file.
+     * Default: false (download)
+     */
+    openInNewTab?: boolean;
+}
+
+/**
+ * Exports an SVG drawing to PDF format.
+ *
+ * Converts the SVG markup to a vector PDF using jsPDF and svg2pdf.js.
+ * The PDF maintains full vector quality with no rasterization.
+ *
+ * **Page size is automatically extracted from the SVG** (width/height attributes),
+ * so you don't need to specify it manually. The template's page dimensions are
+ * embedded in the SVG markup by renderDrawing() or renderLayout().
+ *
+ * **Features:**
+ * - ✅ Vector PDF output (scalable, searchable text)
+ * - ✅ Preserves colors, strokes, fills, fonts
+ * - ✅ No quality loss (unlike raster export)
+ * - ✅ Small file size (vector graphics)
+ * - ✅ Automatic page size detection from SVG
+ *
+ * **Use cases:**
+ * - Print-ready construction documents
+ * - Archival drawings
+ * - Sharing with clients/contractors
+ * - CAD import (vector format)
+ *
+ * @param svg - SVG markup string (from renderDrawing() or renderLayout())
+ * @param options - Export options (filename, optional page size override, open vs download)
+ * @returns Promise that resolves when export completes
+ *
+ * @example
+ * ```typescript
+ * // Basic usage - page size is automatically extracted from SVG
+ * const { svg } = await renderDrawing({ template, models });
+ * await exportToPdf(svg, {
+ *   filename: "floor-plan.pdf",
+ *   openInNewTab: true
+ * });
+ *
+ * // With custom filename
+ * await exportToPdf(svg, {
+ *   filename: `${template.id}-${new Date().toISOString().slice(0,10)}.pdf`
+ * });
+ *
+ * // Override page size if needed (rare)
+ * await exportToPdf(svg, {
+ *   filename: "custom.pdf",
+ *   pageSize: { widthMm: 420, heightMm: 297 },  // A3 landscape override
+ *   openInNewTab: false
+ * });
+ * ```
+ *
+ * @throws {Error} If PDF generation fails or SVG page size cannot be extracted
+ */
+export async function exportToPdf(svg: string, options: ExportPdfOptions = {}): Promise<void> {
+    const filename = options.filename ?? 'drawing.pdf';
+    const filenameWithExt = filename.endsWith('.pdf') ? filename : `${filename}.pdf`;
+
+    // Extract page size from SVG if not provided
+    const pageSize = options.pageSize ?? extractPageSizeFromSvg(svg);
+
+    await exportSectionToPdf({
+        svgMarkup: svg,
+        fileName: filenameWithExt,
+        pageSizeMm: pageSize as any,
+        openInNewTab: options.openInNewTab ?? false
+    });
+}
+
+/**
+ * Exports an SVG drawing to SVG file format.
+ *
+ * Saves or displays the SVG markup as a standalone .svg file.
+ * The SVG can be opened in browsers, vector editors (Inkscape, Illustrator),
+ * or imported into CAD software.
+ *
+ * **Features:**
+ * - ✅ Native vector format (editable in SVG editors)
+ * - ✅ Smallest file size (XML text)
+ * - ✅ Web-friendly (can embed in HTML)
+ * - ✅ Full styling preserved
+ *
+ * **Use cases:**
+ * - Web display (embed in HTML)
+ * - Vector editing (Inkscape, Illustrator)
+ * - Further processing (scripting, automation)
+ * - Archival (open standard format)
+ *
+ * @param svg - SVG markup string (from renderDrawing())
+ * @param options - Export options (filename, open vs download)
+ * @returns Promise that resolves when export completes
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const { svg } = await renderDrawing({ template, models });
+ * await exportToSvg(svg, {
+ *   filename: "floor-plan.svg",
+ *   openInNewTab: true
+ * });
+ *
+ * // Download with custom name
+ * await exportToSvg(svg, {
+ *   filename: `${template.id}-${Date.now()}.svg`,
+ *   openInNewTab: false
+ * });
+ * ```
+ */
+export function exportToSvg(svg: string, options: ExportSvgOptions = {}): void {
+    const filename = options.filename ?? 'drawing.svg';
+    const filenameWithExt = filename.endsWith('.svg') ? filename : `${filename}.svg`;
+
+    exportSectionToSvg({
+        svgMarkup: svg,
+        fileName: filenameWithExt,
+        openInNewTab: options.openInNewTab ?? false
+    });
+}

package/src/layout/filters.ts

@@ -1,80 +1,80 @@
-import { resolveProperty } from './renderUtils';
-
-import { isRecord, getProp } from './typeGuards';
-
-import type { WhereCondition } from './types';
-
-const normalizeClass = (cls: unknown): string | null => (typeof cls === 'string' ? cls.trim().toLowerCase() : null);
-
-/** Compare two class strings, treating the 'Ifc' prefix as optional.
- *  e.g. "IfcSpace" matches "Space", "space", and "IfcSpace". */
-const classEquals = (a: string | null, b: string | null): boolean => {
-    if (a === null || b === null) return false;
-    if (a === b) return true;
-    // Try with/without Ifc prefix in both directions
-    const stripIfc = (s: string): string => (s.startsWith('ifc') ? s.slice(3) : s);
-    return stripIfc(a) === stripIfc(b);
-};
-const normalizeValue = (v: unknown): unknown => (typeof v === 'string' ? v.toLowerCase().trim() : v);
-
-/**
- * Check whether an item's ifcClass matches the given class filter.
- *
- * Uses normalizeClass() for string comparison — works for extracted items
- * where we have a normalized ifcClass string (not a live product).
- *
- * For live products, the caller should use product.class.is() directly.
- */
-const matchesClass = (itemClass: unknown, classFilter: string | string[] | undefined): boolean => {
-    if (classFilter === undefined) return true;
-    const classes = Array.isArray(classFilter) ? classFilter : [classFilter];
-    const normalized = normalizeClass(itemClass);
-    if (normalized === null) return false;
-    return classes.some((c) => classEquals(normalizeClass(c), normalized));
-};
-
-/**
- * Check whether an item matches a `where` condition.
- *
- * Each key in `where` is a short property path (e.g. "BIP.spacetype").
- * Each value is either a scalar (equality check) or an array (any-of check).
- * Multiple keys = AND. String comparison is case-insensitive.
- */
-const matchesWhere = (item: unknown, where: WhereCondition | undefined): boolean => {
-    if (!where) return true;
-    for (const [path, expected] of Object.entries(where)) {
-        const value = resolveProperty(item, path);
-        if (Array.isArray(expected)) {
-            const target = normalizeValue(value);
-            if (!expected.some((v) => normalizeValue(v) === target)) return false;
-        } else {
-            if (normalizeValue(value) !== normalizeValue(expected)) return false;
-        }
-    }
-    return true;
-};
-
-/**
- * V2 filter: match items by class + where conditions.
- *
- * @param item - An object with ifcClass and propertySets
- * @param classFilter - IFC class name(s) to match, or undefined for any
- * @param where - Property conditions (short paths), or undefined for no conditions
- */
-export const matchesV2Filter = (
-    item: unknown,
-    classFilter: string | string[] | undefined,
-    where: WhereCondition | undefined
-): boolean => {
-    if (classFilter !== undefined && isRecord(item)) {
-        const itemClass = getProp(item, 'ifcClass');
-        const itemClassId = getProp(item, 'ifcClassId');
-        if (!matchesClass(itemClass, classFilter) && !matchesClass(itemClassId, classFilter)) {
-            return false;
-        }
-    }
-    if (!matchesWhere(item, where)) return false;
-    return true;
-};
-
-export { normalizeClass, classEquals, normalizeValue, matchesClass, matchesWhere };
+import { resolveProperty } from './renderUtils';
+
+import { isRecord, getProp } from './typeGuards';
+
+import type { WhereCondition } from './types';
+
+const normalizeClass = (cls: unknown): string | null => (typeof cls === 'string' ? cls.trim().toLowerCase() : null);
+
+/** Compare two class strings, treating the 'Ifc' prefix as optional.
+ *  e.g. "IfcSpace" matches "Space", "space", and "IfcSpace". */
+const classEquals = (a: string | null, b: string | null): boolean => {
+    if (a === null || b === null) return false;
+    if (a === b) return true;
+    // Try with/without Ifc prefix in both directions
+    const stripIfc = (s: string): string => (s.startsWith('ifc') ? s.slice(3) : s);
+    return stripIfc(a) === stripIfc(b);
+};
+const normalizeValue = (v: unknown): unknown => (typeof v === 'string' ? v.toLowerCase().trim() : v);
+
+/**
+ * Check whether an item's ifcClass matches the given class filter.
+ *
+ * Uses normalizeClass() for string comparison — works for extracted items
+ * where we have a normalized ifcClass string (not a live product).
+ *
+ * For live products, the caller should use product.class.is() directly.
+ */
+const matchesClass = (itemClass: unknown, classFilter: string | string[] | undefined): boolean => {
+    if (classFilter === undefined) return true;
+    const classes = Array.isArray(classFilter) ? classFilter : [classFilter];
+    const normalized = normalizeClass(itemClass);
+    if (normalized === null) return false;
+    return classes.some((c) => classEquals(normalizeClass(c), normalized));
+};
+
+/**
+ * Check whether an item matches a `where` condition.
+ *
+ * Each key in `where` is a short property path (e.g. "BIP.spacetype").
+ * Each value is either a scalar (equality check) or an array (any-of check).
+ * Multiple keys = AND. String comparison is case-insensitive.
+ */
+const matchesWhere = (item: unknown, where: WhereCondition | undefined): boolean => {
+    if (!where) return true;
+    for (const [path, expected] of Object.entries(where)) {
+        const value = resolveProperty(item, path);
+        if (Array.isArray(expected)) {
+            const target = normalizeValue(value);
+            if (!expected.some((v) => normalizeValue(v) === target)) return false;
+        } else {
+            if (normalizeValue(value) !== normalizeValue(expected)) return false;
+        }
+    }
+    return true;
+};
+
+/**
+ * V2 filter: match items by class + where conditions.
+ *
+ * @param item - An object with ifcClass and propertySets
+ * @param classFilter - IFC class name(s) to match, or undefined for any
+ * @param where - Property conditions (short paths), or undefined for no conditions
+ */
+export const matchesV2Filter = (
+    item: unknown,
+    classFilter: string | string[] | undefined,
+    where: WhereCondition | undefined
+): boolean => {
+    if (classFilter !== undefined && isRecord(item)) {
+        const itemClass = getProp(item, 'ifcClass');
+        const itemClassId = getProp(item, 'ifcClassId');
+        if (!matchesClass(itemClass, classFilter) && !matchesClass(itemClassId, classFilter)) {
+            return false;
+        }
+    }
+    if (!matchesWhere(item, where)) return false;
+    return true;
+};
+
+export { normalizeClass, classEquals, normalizeValue, matchesClass, matchesWhere };

package/src/layout/geometryConstants.ts

@@ -1,11 +1,11 @@
-/**
- * Geometric computation constants
- */
-
-// Epsilon values for floating-point comparisons
-export const EPSILON_INTERSECTION = 1e-9; // Used for detecting parallel lines
-export const EPSILON_DIVISION_SAFETY = 1e-9; // Used to prevent division by zero
-export const EPSILON_MIN_DIMENSION = 1e-6; // Minimum valid dimension for model bounds
-
-// Geometric multipliers
-export const CENTER_FRACTION = 0.5; // For calculating center/midpoint (x * 0.5)
+/**
+ * Geometric computation constants
+ */
+
+// Epsilon values for floating-point comparisons
+export const EPSILON_INTERSECTION = 1e-9; // Used for detecting parallel lines
+export const EPSILON_DIVISION_SAFETY = 1e-9; // Used to prevent division by zero
+export const EPSILON_MIN_DIMENSION = 1e-6; // Minimum valid dimension for model bounds
+
+// Geometric multipliers
+export const CENTER_FRACTION = 0.5; // For calculating center/midpoint (x * 0.5)