npm - @ai-matrx/print - Versions diffs - 0.2.0 → 0.3.1 - Mend

@ai-matrx/print 0.2.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (46) hide show

package/dist/core.cjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/core.ts"],"sourcesContent":["/*\n @ai-matrx/print/core — the Block Print contract & print-window composition.\n \n Ported VERBATIM from matrx-frontend `lib/block-print/block-print-utils.ts`\n * (2026-08-29 state, including the `number` and `select` PrintSetting types the\n * commerce label lane added). Zero dependencies; touches `window` only at call\n * time, so the module stays import-inert and RSC-safe.\n \n BlockPrinter is the only interface a host system needs to know about.\n * Each printable unit exports its own BlockPrinter alongside its render\n * component; host code only ever calls print(data, variantId, settings).\n \n `buildFitTextScript` is the ONE auto-shrink script (the flashcards\n * FIT_TEXT pattern, parameterized by selector so the label lane shares it).\n /\n\n// ─── Contract ────────────────────────────────────────────────────────────────\n\nexport interface PrintVariant {\n id: string;\n label: string;\n description?: string;\n}\n\n/\n A single user-configurable setting shown in the print dialog.\n * Extend the discriminated union for new control types\n * without breaking existing printers.\n /\nexport type PrintSetting =\n \| {\n type: \"boolean\";\n id: string;\n label: string;\n description?: string;\n /* Default value shown when the dialog first opens /\n defaultValue: boolean;\n /* Which variant IDs this setting applies to. Omit = applies to all. /\n appliesTo?: string[];\n }\n \| {\n /\n A numeric \"from → to\" range control, rendered as two small number inputs.\n * Writes two entries into the resolved PrintSettings map — one under fromId,\n * one under toId. Printers interpret 0 (or missing) as \"no bound\" by convention.\n /\n type: \"range\";\n /* Stable id used as React key — not written to the settings map /\n id: string;\n label: string;\n description?: string;\n /* Settings map key for the lower bound value /\n fromId: string;\n /* Settings map key for the upper bound value /\n toId: string;\n defaultFrom: number;\n defaultTo: number;\n /* Minimum accepted value for each input (inclusive). Default 0. /\n min?: number;\n /* Placeholder shown when the input is empty (0). Default \"start\" / \"end\". /\n fromPlaceholder?: string;\n toPlaceholder?: string;\n /* Which variant IDs this setting applies to. Omit = applies to all. /\n appliesTo?: string[];\n }\n \| {\n /* A single numeric input (e.g. \"start at label #\", \"copies\"). /\n type: \"number\";\n id: string;\n label: string;\n description?: string;\n defaultValue: number;\n /* Minimum accepted value (inclusive). Default 0. /\n min?: number;\n /* Maximum accepted value (inclusive). Omit = unbounded. /\n max?: number;\n /* Which variant IDs this setting applies to. Omit = applies to all. /\n appliesTo?: string[];\n }\n \| {\n /* A one-of-N choice rendered as a compact segmented row. /\n type: \"select\";\n id: string;\n label: string;\n description?: string;\n options: { value: string; label: string }[];\n defaultValue: string;\n /* Which variant IDs this setting applies to. Omit = applies to all. /\n appliesTo?: string[];\n };\n\n/* A resolved map of setting id → current value, passed to print(). /\nexport type PrintSettings = Record<string, boolean \| string \| number>;\n\n/\n The self-contained print capability that each block can export.\n * Host code only ever calls print(data, variantId, settings) — it never inspects internals.\n /\nexport interface BlockPrinter {\n /* Tooltip / aria-label for the print button in the block header /\n label: string;\n\n /\n Variants offered to the user before printing.\n * Empty array = no options dialog shown; prints immediately with defaults.\n /\n variants: PrintVariant[];\n\n /\n Optional user-configurable settings shown below the variant picker.\n * Omit entirely if the block has no configurable settings.\n /\n settings?: PrintSetting[];\n\n /\n Execute the print.\n * data — the block's structured data (serverData or parsed content)\n * variantId — which variant was chosen (undefined = default / no variants)\n * settings — resolved setting values chosen by the user\n /\n print: (\n data: unknown,\n variantId?: string,\n settings?: PrintSettings,\n ) => void \| Promise<void>;\n}\n\n// ─── Shared Utilities ─────────────────────────────────────────────────────────\n\nconst PRINT_STYLES = `\n , ::before, ::after { box-sizing: border-box; margin: 0; padding: 0; }\n\n body {\n font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Helvetica Neue', Arial, sans-serif;\n font-size: 11pt;\n line-height: 1.6;\n color: #1a1a1a;\n background: #fff;\n max-width: 860px;\n margin: 0 auto;\n padding: 28px 36px;\n }\n\n .print-actions {\n display: flex;\n gap: 10px;\n margin-bottom: 24px;\n padding-bottom: 18px;\n border-bottom: 2px solid #e5e7eb;\n }\n\n .print-btn {\n display: inline-flex;\n align-items: center;\n gap: 6px;\n padding: 8px 20px;\n border-radius: 8px;\n font-size: 13px;\n font-family: inherit;\n cursor: pointer;\n border: none;\n font-weight: 600;\n }\n\n .print-btn-primary { background: #2563eb; color: #fff; }\n .print-btn-secondary { background: #f3f4f6; color: #374151; border: 1px solid #d1d5db; }\n\n h1 { font-size: 22pt; font-weight: 700; margin-bottom: 0.5em; }\n h2 { font-size: 16pt; font-weight: 700; margin: 1.2em 0 0.4em; border-bottom: 1px solid #e5e7eb; padding-bottom: 0.2em; }\n h3 { font-size: 13pt; font-weight: 600; margin: 1em 0 0.3em; }\n p { margin-bottom: 0.7em; }\n\n table {\n width: 100%;\n border-collapse: collapse;\n margin: 1em 0;\n font-size: 10pt;\n }\n th {\n background: #1e293b;\n color: #f8fafc;\n font-weight: 600;\n text-align: left;\n padding: 7px 12px;\n border: 1px solid #334155;\n }\n td {\n padding: 6px 12px;\n border: 1px solid #e2e8f0;\n vertical-align: top;\n }\n tr:nth-child(even) td { background: #f8fafc; }\n\n @media print {\n body { max-width: 100%; padding: 0; }\n .print-actions { display: none !important; }\n th { -webkit-print-color-adjust: exact; print-color-adjust: exact; }\n }\n`;\n\nfunction escapeHtml(str: string): string {\n return str\n .replace(/&/g, \"&\")\n .replace(/</g, \"<\")\n .replace(/>/g, \">\")\n .replace(/\"/g, \""\")\n .replace(/'/g, \"'\");\n}\n\n/*\n Wrap body HTML in a complete, styled print document.\n /\nexport function buildPrintDocument(\n bodyHtml: string,\n title = \"AI Response\",\n extraStyles = \"\",\n): string {\n return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n <title>${escapeHtml(title)}</title>\n <style>\n${PRINT_STYLES}\n${extraStyles}\n </style>\n</head>\n<body>\n <div class=\"print-actions\">\n <button class=\"print-btn print-btn-primary\" onclick=\"window.print()\">Print / Save as PDF</button>\n <button class=\"print-btn print-btn-secondary\" onclick=\"window.close()\">Close</button>\n </div>\n <div class=\"content\">\n${bodyHtml}\n </div>\n</body>\n</html>`;\n}\n\n/\n Open a new browser window and write a complete HTML document into it.\n * Falls back to downloading an .html file if the popup is blocked.\n /\nexport function openPrintWindow(\n htmlDocument: string,\n filename = \"print\",\n): void {\n const win = window.open(\"\", \"_blank\", \"width=920,height=720,scrollbars=yes\");\n if (!win) {\n // Popup blocked — fall back to file download\n const blob = new Blob([htmlDocument], { type: \"text/html;charset=utf-8\" });\n const url = URL.createObjectURL(blob);\n const a = document.createElement(\"a\");\n a.href = url;\n a.download = `${filename.replace(/\\s+/g, \"-\").toLowerCase()}.html`;\n document.body.appendChild(a);\n a.click();\n document.body.removeChild(a);\n URL.revokeObjectURL(url);\n return;\n }\n win.document.open();\n win.document.write(htmlDocument);\n win.document.close();\n}\n\n/\n Shorthand: build the document and open it in one call.\n /\nexport function printHtmlContent(\n bodyHtml: string,\n title = \"AI Response\",\n extraStyles = \"\",\n): void {\n const doc = buildPrintDocument(bodyHtml, title, extraStyles);\n openPrintWindow(doc, title);\n}\n\n/\n Build the auto-shrink script that runs INSIDE a printed window: for every\n * element matching each selector, its font-size is reduced (0.5pt steps, 6pt\n * floor) until it fits its parent element's box. This is the flashcards\n * FIT_TEXT behavior verbatim, parameterized by selector so every lane\n * (flashcards card text, Avery text, label captions) shares the ONE loop.\n \n Pass the same selectors the original used to get byte-identical behavior:\n * flashcards passes `[\".card-text .card-text-inner\", \".avery-text-wrap .avery-text\"]`.\n */\nexport function buildFitTextScript(selectors: readonly string[]): string {\n const selectorsJson = JSON.stringify([...selectors]);\n return `\n<script>\n(function() {\n function fitText(el, container) {\n // container is the bounding box we must fit inside\n var maxW = container.clientWidth;\n var maxH = container.clientHeight;\n var size = parseFloat(window.getComputedStyle(el).fontSize);\n var minSize = 6;\n // Give the element a chance to reflow at current size before measuring\n el.style.fontSize = size + \"pt\";\n while (size > minSize && (el.scrollWidth > maxW + 1 \|\| el.scrollHeight > maxH + 1)) {\n size -= 0.5;\n el.style.fontSize = size + \"pt\";\n }\n }\n function runAll() {\n var selectors = ${selectorsJson};\n for (var s = 0; s < selectors.length; s++) {\n var els = document.querySelectorAll(selectors[s]);\n for (var i = 0; i < els.length; i++) {\n fitText(els[i], els[i].parentElement);\n }\n }\n }\n if (document.readyState === \"loading\") {\n document.addEventListener(\"DOMContentLoaded\", runAll);\n } else {\n // document.write pages may already be loaded\n setTimeout(runAll, 0);\n }\n})();\n</script>`;\n}\n\nexport { escapeHtml };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAiIA,IAAM,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuErB,SAAS,WAAW,KAAqB;AACvC,SAAO,IACJ,QAAQ,MAAM,OAAO,EACrB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,QAAQ,EACtB,QAAQ,MAAM,OAAO;AAC1B;AAKO,SAAS,mBACd,UACA,QAAQ,eACR,cAAc,IACN;AACR,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA,WAKE,WAAW,KAAK,CAAC;AAAA;AAAA,EAE1B,YAAY;AAAA,EACZ,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASX,QAAQ;AAAA;AAAA;AAAA;AAIV;AAMO,SAAS,gBACd,cACA,WAAW,SACL;AACN,QAAM,MAAM,OAAO,KAAK,IAAI,UAAU,qCAAqC;AAC3E,MAAI,CAAC,KAAK;AAER,UAAM,OAAO,IAAI,KAAK,CAAC,YAAY,GAAG,EAAE,MAAM,0BAA0B,CAAC;AACzE,UAAM,MAAM,IAAI,gBAAgB,IAAI;AACpC,UAAM,IAAI,SAAS,cAAc,GAAG;AACpC,MAAE,OAAO;AACT,MAAE,WAAW,GAAG,SAAS,QAAQ,QAAQ,GAAG,EAAE,YAAY,CAAC;AAC3D,aAAS,KAAK,YAAY,CAAC;AAC3B,MAAE,MAAM;AACR,aAAS,KAAK,YAAY,CAAC;AAC3B,QAAI,gBAAgB,GAAG;AACvB;AAAA,EACF;AACA,MAAI,SAAS,KAAK;AAClB,MAAI,SAAS,MAAM,YAAY;AAC/B,MAAI,SAAS,MAAM;AACrB;AAKO,SAAS,iBACd,UACA,QAAQ,eACR,cAAc,IACR;AACN,QAAM,MAAM,mBAAmB,UAAU,OAAO,WAAW;AAC3D,kBAAgB,KAAK,KAAK;AAC5B;AAYO,SAAS,mBAAmB,WAAsC;AACvE,QAAM,gBAAgB,KAAK,UAAU,CAAC,GAAG,SAAS,CAAC;AACnD,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAiBa,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBnC;","names":[]}
1	+ {"version":3,"sources":["../src/core.ts"],"sourcesContent":["/*\n @ai-matrx/print/core — the Block Print contract & print-window composition.\n \n Ported VERBATIM from matrx-frontend `lib/block-print/block-print-utils.ts`\n * (2026-08-29 state, including the `number` and `select` PrintSetting types the\n * commerce label lane added). Zero dependencies; touches `window` only at call\n * time, so the module stays import-inert and RSC-safe.\n \n BlockPrinter is the only interface a host system needs to know about.\n * Each printable unit exports its own BlockPrinter alongside its render\n * component; host code only ever calls print(data, variantId, settings).\n \n `buildFitTextScript` is the ONE auto-shrink script (the flashcards\n * FIT_TEXT pattern, parameterized by selector so the label lane shares it).\n /\n\n// ─── Contract ────────────────────────────────────────────────────────────────\n\nexport interface PrintVariant {\n id: string;\n label: string;\n description?: string;\n}\n\n/\n A single user-configurable setting shown in the print dialog.\n * Extend the discriminated union for new control types\n * without breaking existing printers.\n /\nexport type PrintSetting =\n \| {\n type: \"boolean\";\n id: string;\n label: string;\n description?: string;\n /* Default value shown when the dialog first opens /\n defaultValue: boolean;\n /* Which variant IDs this setting applies to. Omit = applies to all. /\n appliesTo?: string[];\n }\n \| {\n /\n A numeric \"from → to\" range control, rendered as two small number inputs.\n * Writes two entries into the resolved PrintSettings map — one under fromId,\n * one under toId. Printers interpret 0 (or missing) as \"no bound\" by convention.\n /\n type: \"range\";\n /* Stable id used as React key — not written to the settings map /\n id: string;\n label: string;\n description?: string;\n /* Settings map key for the lower bound value /\n fromId: string;\n /* Settings map key for the upper bound value /\n toId: string;\n defaultFrom: number;\n defaultTo: number;\n /* Minimum accepted value for each input (inclusive). Default 0. /\n min?: number;\n /* Placeholder shown when the input is empty (0). Default \"start\" / \"end\". /\n fromPlaceholder?: string;\n toPlaceholder?: string;\n /* Which variant IDs this setting applies to. Omit = applies to all. /\n appliesTo?: string[];\n }\n \| {\n /* A single numeric input (e.g. \"start at label #\", \"copies\"). /\n type: \"number\";\n id: string;\n label: string;\n description?: string;\n defaultValue: number;\n /* Minimum accepted value (inclusive). Default 0. /\n min?: number;\n /* Maximum accepted value (inclusive). Omit = unbounded. /\n max?: number;\n /* Which variant IDs this setting applies to. Omit = applies to all. /\n appliesTo?: string[];\n }\n \| {\n /* A one-of-N choice rendered as a compact segmented row. /\n type: \"select\";\n id: string;\n label: string;\n description?: string;\n options: { value: string; label: string }[];\n defaultValue: string;\n /* Which variant IDs this setting applies to. Omit = applies to all. /\n appliesTo?: string[];\n };\n\n/* A resolved map of setting id → current value, passed to print(). /\nexport type PrintSettings = Record<string, boolean \| string \| number>;\n\n/\n The self-contained print capability that each block can export.\n * Host code only ever calls print(data, variantId, settings) — it never inspects internals.\n /\nexport interface BlockPrinter {\n /* Tooltip / aria-label for the print button in the block header /\n label: string;\n\n /\n Variants offered to the user before printing.\n * Empty array = no options dialog shown; prints immediately with defaults.\n /\n variants: PrintVariant[];\n\n /\n Optional user-configurable settings shown below the variant picker.\n * Omit entirely if the block has no configurable settings.\n /\n settings?: PrintSetting[];\n\n /\n Execute the print.\n * data — the block's structured data (serverData or parsed content)\n * variantId — which variant was chosen (undefined = default / no variants)\n * settings — resolved setting values chosen by the user\n \n MAY resolve to a PrintOutcome (\"opened\" \| \"downloaded\") so the host can\n * tell the user when the popup-blocked download fallback fired; `void`\n * stays legal for printers that don't go through a print window.\n /\n print: (\n data: unknown,\n variantId?: string,\n settings?: PrintSettings,\n ) => void \| PrintOutcome \| Promise<void \| PrintOutcome>;\n}\n\n// ─── Shared Utilities ─────────────────────────────────────────────────────────\n\nconst PRINT_STYLES = `\n , ::before, ::after { box-sizing: border-box; margin: 0; padding: 0; }\n\n body {\n font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Helvetica Neue', Arial, sans-serif;\n font-size: 11pt;\n line-height: 1.6;\n color: #1a1a1a;\n background: #fff;\n max-width: 860px;\n margin: 0 auto;\n padding: 28px 36px;\n }\n\n .print-actions {\n display: flex;\n gap: 10px;\n margin-bottom: 24px;\n padding-bottom: 18px;\n border-bottom: 2px solid #e5e7eb;\n }\n\n .print-btn {\n display: inline-flex;\n align-items: center;\n gap: 6px;\n padding: 8px 20px;\n border-radius: 8px;\n font-size: 13px;\n font-family: inherit;\n cursor: pointer;\n border: none;\n font-weight: 600;\n }\n\n .print-btn-primary { background: #2563eb; color: #fff; }\n .print-btn-secondary { background: #f3f4f6; color: #374151; border: 1px solid #d1d5db; }\n\n h1 { font-size: 22pt; font-weight: 700; margin-bottom: 0.5em; }\n h2 { font-size: 16pt; font-weight: 700; margin: 1.2em 0 0.4em; border-bottom: 1px solid #e5e7eb; padding-bottom: 0.2em; }\n h3 { font-size: 13pt; font-weight: 600; margin: 1em 0 0.3em; }\n p { margin-bottom: 0.7em; }\n\n table {\n width: 100%;\n border-collapse: collapse;\n margin: 1em 0;\n font-size: 10pt;\n }\n th {\n background: #1e293b;\n color: #f8fafc;\n font-weight: 600;\n text-align: left;\n padding: 7px 12px;\n border: 1px solid #334155;\n }\n td {\n padding: 6px 12px;\n border: 1px solid #e2e8f0;\n vertical-align: top;\n }\n tr:nth-child(even) td { background: #f8fafc; }\n\n @media print {\n body { max-width: 100%; padding: 0; }\n .print-actions { display: none !important; }\n th { -webkit-print-color-adjust: exact; print-color-adjust: exact; }\n }\n`;\n\nfunction escapeHtml(str: string): string {\n return str\n .replace(/&/g, \"&\")\n .replace(/</g, \"<\")\n .replace(/>/g, \">\")\n .replace(/\"/g, \""\")\n .replace(/'/g, \"'\");\n}\n\n/*\n Wrap body HTML in a complete, styled print document.\n /\nexport function buildPrintDocument(\n bodyHtml: string,\n title = \"AI Response\",\n extraStyles = \"\",\n): string {\n return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n <title>${escapeHtml(title)}</title>\n <style>\n${PRINT_STYLES}\n${extraStyles}\n </style>\n</head>\n<body>\n <div class=\"print-actions\">\n <button class=\"print-btn print-btn-primary\" onclick=\"window.print()\">Print / Save as PDF</button>\n <button class=\"print-btn print-btn-secondary\" onclick=\"window.close()\">Close</button>\n </div>\n <div class=\"content\">\n${bodyHtml}\n </div>\n</body>\n</html>`;\n}\n\n/\n How a print request actually reached the user.\n \n \"opened\" — a print window/tab was opened and the document written into it.\n * \"downloaded\" — the popup was blocked, so the document was downloaded as an\n * .html file instead (the contract's fallback). Hosts SHOULD\n * surface this to the user (e.g. a toast saying the print file\n * was downloaded) — a blocked popup plus a silent download is\n * indistinguishable from \"nothing happened\", which is exactly\n * how QA filed it (2026-08-30, F5/F6/F8).\n /\nexport type PrintOutcome = \"opened\" \| \"downloaded\";\n\n/\n Open a new browser window and write a complete HTML document into it.\n * Falls back to downloading an .html file if the popup is blocked.\n \n Returns which path was taken so callers can tell the user when the\n * fallback fired. `windowFeatures` customizes the popup geometry (the\n * flashcards fixed-geometry variants pass a wider window).\n /\nexport function openPrintWindow(\n htmlDocument: string,\n filename = \"print\",\n windowFeatures = \"width=920,height=720,scrollbars=yes\",\n): PrintOutcome {\n const win = window.open(\"\", \"_blank\", windowFeatures);\n if (!win) {\n // Popup blocked — fall back to file download\n const blob = new Blob([htmlDocument], { type: \"text/html;charset=utf-8\" });\n const url = URL.createObjectURL(blob);\n const a = document.createElement(\"a\");\n a.href = url;\n a.download = `${filename.replace(/\\s+/g, \"-\").toLowerCase()}.html`;\n document.body.appendChild(a);\n a.click();\n document.body.removeChild(a);\n // Revoke on a macrotask so the browser has started the blob fetch —\n // a synchronous revoke races the download in some engines.\n setTimeout(() => URL.revokeObjectURL(url), 0);\n return \"downloaded\";\n }\n win.document.open();\n win.document.write(htmlDocument);\n win.document.close();\n return \"opened\";\n}\n\n/\n Shorthand: build the document and open it in one call.\n * Returns the same PrintOutcome as openPrintWindow.\n /\nexport function printHtmlContent(\n bodyHtml: string,\n title = \"AI Response\",\n extraStyles = \"\",\n): PrintOutcome {\n const doc = buildPrintDocument(bodyHtml, title, extraStyles);\n return openPrintWindow(doc, title);\n}\n\n/\n Build the auto-shrink script that runs INSIDE a printed window: for every\n * element matching each selector, its font-size is reduced (0.5pt steps, 6pt\n * floor) until it fits its parent element's box. This is the flashcards\n * FIT_TEXT behavior verbatim, parameterized by selector so every lane\n * (flashcards card text, Avery text, label captions) shares the ONE loop.\n \n Pass the same selectors the original used to get byte-identical behavior:\n * flashcards passes `[\".card-text .card-text-inner\", \".avery-text-wrap .avery-text\"]`.\n */\nexport function buildFitTextScript(selectors: readonly string[]): string {\n const selectorsJson = JSON.stringify([...selectors]);\n return `\n<script>\n(function() {\n function fitText(el, container) {\n // container is the bounding box we must fit inside\n var maxW = container.clientWidth;\n var maxH = container.clientHeight;\n var size = parseFloat(window.getComputedStyle(el).fontSize);\n var minSize = 6;\n // Give the element a chance to reflow at current size before measuring\n el.style.fontSize = size + \"pt\";\n while (size > minSize && (el.scrollWidth > maxW + 1 \|\| el.scrollHeight > maxH + 1)) {\n size -= 0.5;\n el.style.fontSize = size + \"pt\";\n }\n }\n function runAll() {\n var selectors = ${selectorsJson};\n for (var s = 0; s < selectors.length; s++) {\n var els = document.querySelectorAll(selectors[s]);\n for (var i = 0; i < els.length; i++) {\n fitText(els[i], els[i].parentElement);\n }\n }\n }\n if (document.readyState === \"loading\") {\n document.addEventListener(\"DOMContentLoaded\", runAll);\n } else {\n // document.write pages may already be loaded\n setTimeout(runAll, 0);\n }\n})();\n</script>`;\n}\n\nexport { escapeHtml };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqIA,IAAM,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuErB,SAAS,WAAW,KAAqB;AACvC,SAAO,IACJ,QAAQ,MAAM,OAAO,EACrB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,QAAQ,EACtB,QAAQ,MAAM,OAAO;AAC1B;AAKO,SAAS,mBACd,UACA,QAAQ,eACR,cAAc,IACN;AACR,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA,WAKE,WAAW,KAAK,CAAC;AAAA;AAAA,EAE1B,YAAY;AAAA,EACZ,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASX,QAAQ;AAAA;AAAA;AAAA;AAIV;AAuBO,SAAS,gBACd,cACA,WAAW,SACX,iBAAiB,uCACH;AACd,QAAM,MAAM,OAAO,KAAK,IAAI,UAAU,cAAc;AACpD,MAAI,CAAC,KAAK;AAER,UAAM,OAAO,IAAI,KAAK,CAAC,YAAY,GAAG,EAAE,MAAM,0BAA0B,CAAC;AACzE,UAAM,MAAM,IAAI,gBAAgB,IAAI;AACpC,UAAM,IAAI,SAAS,cAAc,GAAG;AACpC,MAAE,OAAO;AACT,MAAE,WAAW,GAAG,SAAS,QAAQ,QAAQ,GAAG,EAAE,YAAY,CAAC;AAC3D,aAAS,KAAK,YAAY,CAAC;AAC3B,MAAE,MAAM;AACR,aAAS,KAAK,YAAY,CAAC;AAG3B,eAAW,MAAM,IAAI,gBAAgB,GAAG,GAAG,CAAC;AAC5C,WAAO;AAAA,EACT;AACA,MAAI,SAAS,KAAK;AAClB,MAAI,SAAS,MAAM,YAAY;AAC/B,MAAI,SAAS,MAAM;AACnB,SAAO;AACT;AAMO,SAAS,iBACd,UACA,QAAQ,eACR,cAAc,IACA;AACd,QAAM,MAAM,mBAAmB,UAAU,OAAO,WAAW;AAC3D,SAAO,gBAAgB,KAAK,KAAK;AACnC;AAYO,SAAS,mBAAmB,WAAsC;AACvE,QAAM,gBAAgB,KAAK,UAAU,CAAC,GAAG,SAAS,CAAC;AACnD,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAiBa,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBnC;","names":[]}

package/dist/core.d.cts CHANGED Viewed

@@ -107,23 +107,44 @@ interface BlockPrinter {
      * data      — the block's structured data (serverData or parsed content)
      * variantId — which variant was chosen (undefined = default / no variants)
      * settings  — resolved setting values chosen by the user
+     *
+     * MAY resolve to a PrintOutcome ("opened" | "downloaded") so the host can
+     * tell the user when the popup-blocked download fallback fired; `void`
+     * stays legal for printers that don't go through a print window.
      */
-    print: (data: unknown, variantId?: string, settings?: PrintSettings) => void | Promise<void>;
+    print: (data: unknown, variantId?: string, settings?: PrintSettings) => void | PrintOutcome | Promise<void | PrintOutcome>;
 }
 declare function escapeHtml(str: string): string;
 /**
  * Wrap body HTML in a complete, styled print document.
  */
 declare function buildPrintDocument(bodyHtml: string, title?: string, extraStyles?: string): string;
+/**
+ * How a print request actually reached the user.
+ *
+ * "opened"     — a print window/tab was opened and the document written into it.
+ * "downloaded" — the popup was blocked, so the document was downloaded as an
+ *                .html file instead (the contract's fallback). Hosts SHOULD
+ *                surface this to the user (e.g. a toast saying the print file
+ *                was downloaded) — a blocked popup plus a silent download is
+ *                indistinguishable from "nothing happened", which is exactly
+ *                how QA filed it (2026-08-30, F5/F6/F8).
+ */
+type PrintOutcome = "opened" | "downloaded";
 /**
  * Open a new browser window and write a complete HTML document into it.
  * Falls back to downloading an .html file if the popup is blocked.
+ *
+ * Returns which path was taken so callers can tell the user when the
+ * fallback fired. `windowFeatures` customizes the popup geometry (the
+ * flashcards fixed-geometry variants pass a wider window).
  */
-declare function openPrintWindow(htmlDocument: string, filename?: string): void;
+declare function openPrintWindow(htmlDocument: string, filename?: string, windowFeatures?: string): PrintOutcome;
 /**
  * Shorthand: build the document and open it in one call.
+ * Returns the same PrintOutcome as openPrintWindow.
  */
-declare function printHtmlContent(bodyHtml: string, title?: string, extraStyles?: string): void;
+declare function printHtmlContent(bodyHtml: string, title?: string, extraStyles?: string): PrintOutcome;
 /**
  * Build the auto-shrink script that runs INSIDE a printed window: for every
  * element matching each selector, its font-size is reduced (0.5pt steps, 6pt
@@ -136,4 +157,4 @@ declare function printHtmlContent(bodyHtml: string, title?: string, extraStyles?
  */
 declare function buildFitTextScript(selectors: readonly string[]): string;
-export { type BlockPrinter, type PrintSetting, type PrintSettings, type PrintVariant, buildFitTextScript, buildPrintDocument, escapeHtml, openPrintWindow, printHtmlContent };
+export { type BlockPrinter, type PrintOutcome, type PrintSetting, type PrintSettings, type PrintVariant, buildFitTextScript, buildPrintDocument, escapeHtml, openPrintWindow, printHtmlContent };

package/dist/core.d.ts CHANGED Viewed

@@ -107,23 +107,44 @@ interface BlockPrinter {
      * data      — the block's structured data (serverData or parsed content)
      * variantId — which variant was chosen (undefined = default / no variants)
      * settings  — resolved setting values chosen by the user
+     *
+     * MAY resolve to a PrintOutcome ("opened" | "downloaded") so the host can
+     * tell the user when the popup-blocked download fallback fired; `void`
+     * stays legal for printers that don't go through a print window.
      */
-    print: (data: unknown, variantId?: string, settings?: PrintSettings) => void | Promise<void>;
+    print: (data: unknown, variantId?: string, settings?: PrintSettings) => void | PrintOutcome | Promise<void | PrintOutcome>;
 }
 declare function escapeHtml(str: string): string;
 /**
  * Wrap body HTML in a complete, styled print document.
  */
 declare function buildPrintDocument(bodyHtml: string, title?: string, extraStyles?: string): string;
+/**
+ * How a print request actually reached the user.
+ *
+ * "opened"     — a print window/tab was opened and the document written into it.
+ * "downloaded" — the popup was blocked, so the document was downloaded as an
+ *                .html file instead (the contract's fallback). Hosts SHOULD
+ *                surface this to the user (e.g. a toast saying the print file
+ *                was downloaded) — a blocked popup plus a silent download is
+ *                indistinguishable from "nothing happened", which is exactly
+ *                how QA filed it (2026-08-30, F5/F6/F8).
+ */
+type PrintOutcome = "opened" | "downloaded";
 /**
  * Open a new browser window and write a complete HTML document into it.
  * Falls back to downloading an .html file if the popup is blocked.
+ *
+ * Returns which path was taken so callers can tell the user when the
+ * fallback fired. `windowFeatures` customizes the popup geometry (the
+ * flashcards fixed-geometry variants pass a wider window).
  */
-declare function openPrintWindow(htmlDocument: string, filename?: string): void;
+declare function openPrintWindow(htmlDocument: string, filename?: string, windowFeatures?: string): PrintOutcome;
 /**
  * Shorthand: build the document and open it in one call.
+ * Returns the same PrintOutcome as openPrintWindow.
  */
-declare function printHtmlContent(bodyHtml: string, title?: string, extraStyles?: string): void;
+declare function printHtmlContent(bodyHtml: string, title?: string, extraStyles?: string): PrintOutcome;
 /**
  * Build the auto-shrink script that runs INSIDE a printed window: for every
  * element matching each selector, its font-size is reduced (0.5pt steps, 6pt
@@ -136,4 +157,4 @@ declare function printHtmlContent(bodyHtml: string, title?: string, extraStyles?
  */
 declare function buildFitTextScript(selectors: readonly string[]): string;
-export { type BlockPrinter, type PrintSetting, type PrintSettings, type PrintVariant, buildFitTextScript, buildPrintDocument, escapeHtml, openPrintWindow, printHtmlContent };
+export { type BlockPrinter, type PrintOutcome, type PrintSetting, type PrintSettings, type PrintVariant, buildFitTextScript, buildPrintDocument, escapeHtml, openPrintWindow, printHtmlContent };

package/dist/core.js CHANGED Viewed

@@ -95,8 +95,8 @@ ${bodyHtml}
 </body>
 </html>`;
 }
-function openPrintWindow(htmlDocument, filename = "print") {
-  const win = window.open("", "_blank", "width=920,height=720,scrollbars=yes");
+function openPrintWindow(htmlDocument, filename = "print", windowFeatures = "width=920,height=720,scrollbars=yes") {
+  const win = window.open("", "_blank", windowFeatures);
   if (!win) {
     const blob = new Blob([htmlDocument], { type: "text/html;charset=utf-8" });
     const url = URL.createObjectURL(blob);
@@ -106,16 +106,17 @@ function openPrintWindow(htmlDocument, filename = "print") {
     document.body.appendChild(a);
     a.click();
     document.body.removeChild(a);
-    URL.revokeObjectURL(url);
-    return;
+    setTimeout(() => URL.revokeObjectURL(url), 0);
+    return "downloaded";
   }
   win.document.open();
   win.document.write(htmlDocument);
   win.document.close();
+  return "opened";
 }
 function printHtmlContent(bodyHtml, title = "AI Response", extraStyles = "") {
   const doc = buildPrintDocument(bodyHtml, title, extraStyles);
-  openPrintWindow(doc, title);
+  return openPrintWindow(doc, title);
 }
 function buildFitTextScript(selectors) {
   const selectorsJson = JSON.stringify([...selectors]);

package/dist/core.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/core.ts"],"sourcesContent":["/*\n @ai-matrx/print/core — the Block Print contract & print-window composition.\n \n Ported VERBATIM from matrx-frontend `lib/block-print/block-print-utils.ts`\n * (2026-08-29 state, including the `number` and `select` PrintSetting types the\n * commerce label lane added). Zero dependencies; touches `window` only at call\n * time, so the module stays import-inert and RSC-safe.\n \n BlockPrinter is the only interface a host system needs to know about.\n * Each printable unit exports its own BlockPrinter alongside its render\n * component; host code only ever calls print(data, variantId, settings).\n \n `buildFitTextScript` is the ONE auto-shrink script (the flashcards\n * FIT_TEXT pattern, parameterized by selector so the label lane shares it).\n /\n\n// ─── Contract ────────────────────────────────────────────────────────────────\n\nexport interface PrintVariant {\n id: string;\n label: string;\n description?: string;\n}\n\n/\n A single user-configurable setting shown in the print dialog.\n * Extend the discriminated union for new control types\n * without breaking existing printers.\n /\nexport type PrintSetting =\n \| {\n type: \"boolean\";\n id: string;\n label: string;\n description?: string;\n /* Default value shown when the dialog first opens /\n defaultValue: boolean;\n /* Which variant IDs this setting applies to. Omit = applies to all. /\n appliesTo?: string[];\n }\n \| {\n /\n A numeric \"from → to\" range control, rendered as two small number inputs.\n * Writes two entries into the resolved PrintSettings map — one under fromId,\n * one under toId. Printers interpret 0 (or missing) as \"no bound\" by convention.\n /\n type: \"range\";\n /* Stable id used as React key — not written to the settings map /\n id: string;\n label: string;\n description?: string;\n /* Settings map key for the lower bound value /\n fromId: string;\n /* Settings map key for the upper bound value /\n toId: string;\n defaultFrom: number;\n defaultTo: number;\n /* Minimum accepted value for each input (inclusive). Default 0. /\n min?: number;\n /* Placeholder shown when the input is empty (0). Default \"start\" / \"end\". /\n fromPlaceholder?: string;\n toPlaceholder?: string;\n /* Which variant IDs this setting applies to. Omit = applies to all. /\n appliesTo?: string[];\n }\n \| {\n /* A single numeric input (e.g. \"start at label #\", \"copies\"). /\n type: \"number\";\n id: string;\n label: string;\n description?: string;\n defaultValue: number;\n /* Minimum accepted value (inclusive). Default 0. /\n min?: number;\n /* Maximum accepted value (inclusive). Omit = unbounded. /\n max?: number;\n /* Which variant IDs this setting applies to. Omit = applies to all. /\n appliesTo?: string[];\n }\n \| {\n /* A one-of-N choice rendered as a compact segmented row. /\n type: \"select\";\n id: string;\n label: string;\n description?: string;\n options: { value: string; label: string }[];\n defaultValue: string;\n /* Which variant IDs this setting applies to. Omit = applies to all. /\n appliesTo?: string[];\n };\n\n/* A resolved map of setting id → current value, passed to print(). /\nexport type PrintSettings = Record<string, boolean \| string \| number>;\n\n/\n The self-contained print capability that each block can export.\n * Host code only ever calls print(data, variantId, settings) — it never inspects internals.\n /\nexport interface BlockPrinter {\n /* Tooltip / aria-label for the print button in the block header /\n label: string;\n\n /\n Variants offered to the user before printing.\n * Empty array = no options dialog shown; prints immediately with defaults.\n /\n variants: PrintVariant[];\n\n /\n Optional user-configurable settings shown below the variant picker.\n * Omit entirely if the block has no configurable settings.\n /\n settings?: PrintSetting[];\n\n /\n Execute the print.\n * data — the block's structured data (serverData or parsed content)\n * variantId — which variant was chosen (undefined = default / no variants)\n * settings — resolved setting values chosen by the user\n /\n print: (\n data: unknown,\n variantId?: string,\n settings?: PrintSettings,\n ) => void \| Promise<void>;\n}\n\n// ─── Shared Utilities ─────────────────────────────────────────────────────────\n\nconst PRINT_STYLES = `\n , ::before, ::after { box-sizing: border-box; margin: 0; padding: 0; }\n\n body {\n font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Helvetica Neue', Arial, sans-serif;\n font-size: 11pt;\n line-height: 1.6;\n color: #1a1a1a;\n background: #fff;\n max-width: 860px;\n margin: 0 auto;\n padding: 28px 36px;\n }\n\n .print-actions {\n display: flex;\n gap: 10px;\n margin-bottom: 24px;\n padding-bottom: 18px;\n border-bottom: 2px solid #e5e7eb;\n }\n\n .print-btn {\n display: inline-flex;\n align-items: center;\n gap: 6px;\n padding: 8px 20px;\n border-radius: 8px;\n font-size: 13px;\n font-family: inherit;\n cursor: pointer;\n border: none;\n font-weight: 600;\n }\n\n .print-btn-primary { background: #2563eb; color: #fff; }\n .print-btn-secondary { background: #f3f4f6; color: #374151; border: 1px solid #d1d5db; }\n\n h1 { font-size: 22pt; font-weight: 700; margin-bottom: 0.5em; }\n h2 { font-size: 16pt; font-weight: 700; margin: 1.2em 0 0.4em; border-bottom: 1px solid #e5e7eb; padding-bottom: 0.2em; }\n h3 { font-size: 13pt; font-weight: 600; margin: 1em 0 0.3em; }\n p { margin-bottom: 0.7em; }\n\n table {\n width: 100%;\n border-collapse: collapse;\n margin: 1em 0;\n font-size: 10pt;\n }\n th {\n background: #1e293b;\n color: #f8fafc;\n font-weight: 600;\n text-align: left;\n padding: 7px 12px;\n border: 1px solid #334155;\n }\n td {\n padding: 6px 12px;\n border: 1px solid #e2e8f0;\n vertical-align: top;\n }\n tr:nth-child(even) td { background: #f8fafc; }\n\n @media print {\n body { max-width: 100%; padding: 0; }\n .print-actions { display: none !important; }\n th { -webkit-print-color-adjust: exact; print-color-adjust: exact; }\n }\n`;\n\nfunction escapeHtml(str: string): string {\n return str\n .replace(/&/g, \"&\")\n .replace(/</g, \"<\")\n .replace(/>/g, \">\")\n .replace(/\"/g, \""\")\n .replace(/'/g, \"'\");\n}\n\n/*\n Wrap body HTML in a complete, styled print document.\n /\nexport function buildPrintDocument(\n bodyHtml: string,\n title = \"AI Response\",\n extraStyles = \"\",\n): string {\n return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n <title>${escapeHtml(title)}</title>\n <style>\n${PRINT_STYLES}\n${extraStyles}\n </style>\n</head>\n<body>\n <div class=\"print-actions\">\n <button class=\"print-btn print-btn-primary\" onclick=\"window.print()\">Print / Save as PDF</button>\n <button class=\"print-btn print-btn-secondary\" onclick=\"window.close()\">Close</button>\n </div>\n <div class=\"content\">\n${bodyHtml}\n </div>\n</body>\n</html>`;\n}\n\n/\n Open a new browser window and write a complete HTML document into it.\n * Falls back to downloading an .html file if the popup is blocked.\n /\nexport function openPrintWindow(\n htmlDocument: string,\n filename = \"print\",\n): void {\n const win = window.open(\"\", \"_blank\", \"width=920,height=720,scrollbars=yes\");\n if (!win) {\n // Popup blocked — fall back to file download\n const blob = new Blob([htmlDocument], { type: \"text/html;charset=utf-8\" });\n const url = URL.createObjectURL(blob);\n const a = document.createElement(\"a\");\n a.href = url;\n a.download = `${filename.replace(/\\s+/g, \"-\").toLowerCase()}.html`;\n document.body.appendChild(a);\n a.click();\n document.body.removeChild(a);\n URL.revokeObjectURL(url);\n return;\n }\n win.document.open();\n win.document.write(htmlDocument);\n win.document.close();\n}\n\n/\n Shorthand: build the document and open it in one call.\n /\nexport function printHtmlContent(\n bodyHtml: string,\n title = \"AI Response\",\n extraStyles = \"\",\n): void {\n const doc = buildPrintDocument(bodyHtml, title, extraStyles);\n openPrintWindow(doc, title);\n}\n\n/\n Build the auto-shrink script that runs INSIDE a printed window: for every\n * element matching each selector, its font-size is reduced (0.5pt steps, 6pt\n * floor) until it fits its parent element's box. This is the flashcards\n * FIT_TEXT behavior verbatim, parameterized by selector so every lane\n * (flashcards card text, Avery text, label captions) shares the ONE loop.\n \n Pass the same selectors the original used to get byte-identical behavior:\n * flashcards passes `[\".card-text .card-text-inner\", \".avery-text-wrap .avery-text\"]`.\n */\nexport function buildFitTextScript(selectors: readonly string[]): string {\n const selectorsJson = JSON.stringify([...selectors]);\n return `\n<script>\n(function() {\n function fitText(el, container) {\n // container is the bounding box we must fit inside\n var maxW = container.clientWidth;\n var maxH = container.clientHeight;\n var size = parseFloat(window.getComputedStyle(el).fontSize);\n var minSize = 6;\n // Give the element a chance to reflow at current size before measuring\n el.style.fontSize = size + \"pt\";\n while (size > minSize && (el.scrollWidth > maxW + 1 \|\| el.scrollHeight > maxH + 1)) {\n size -= 0.5;\n el.style.fontSize = size + \"pt\";\n }\n }\n function runAll() {\n var selectors = ${selectorsJson};\n for (var s = 0; s < selectors.length; s++) {\n var els = document.querySelectorAll(selectors[s]);\n for (var i = 0; i < els.length; i++) {\n fitText(els[i], els[i].parentElement);\n }\n }\n }\n if (document.readyState === \"loading\") {\n document.addEventListener(\"DOMContentLoaded\", runAll);\n } else {\n // document.write pages may already be loaded\n setTimeout(runAll, 0);\n }\n})();\n</script>`;\n}\n\nexport { escapeHtml };\n"],"mappings":";AAiIA,IAAM,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuErB,SAAS,WAAW,KAAqB;AACvC,SAAO,IACJ,QAAQ,MAAM,OAAO,EACrB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,QAAQ,EACtB,QAAQ,MAAM,OAAO;AAC1B;AAKO,SAAS,mBACd,UACA,QAAQ,eACR,cAAc,IACN;AACR,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA,WAKE,WAAW,KAAK,CAAC;AAAA;AAAA,EAE1B,YAAY;AAAA,EACZ,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASX,QAAQ;AAAA;AAAA;AAAA;AAIV;AAMO,SAAS,gBACd,cACA,WAAW,SACL;AACN,QAAM,MAAM,OAAO,KAAK,IAAI,UAAU,qCAAqC;AAC3E,MAAI,CAAC,KAAK;AAER,UAAM,OAAO,IAAI,KAAK,CAAC,YAAY,GAAG,EAAE,MAAM,0BAA0B,CAAC;AACzE,UAAM,MAAM,IAAI,gBAAgB,IAAI;AACpC,UAAM,IAAI,SAAS,cAAc,GAAG;AACpC,MAAE,OAAO;AACT,MAAE,WAAW,GAAG,SAAS,QAAQ,QAAQ,GAAG,EAAE,YAAY,CAAC;AAC3D,aAAS,KAAK,YAAY,CAAC;AAC3B,MAAE,MAAM;AACR,aAAS,KAAK,YAAY,CAAC;AAC3B,QAAI,gBAAgB,GAAG;AACvB;AAAA,EACF;AACA,MAAI,SAAS,KAAK;AAClB,MAAI,SAAS,MAAM,YAAY;AAC/B,MAAI,SAAS,MAAM;AACrB;AAKO,SAAS,iBACd,UACA,QAAQ,eACR,cAAc,IACR;AACN,QAAM,MAAM,mBAAmB,UAAU,OAAO,WAAW;AAC3D,kBAAgB,KAAK,KAAK;AAC5B;AAYO,SAAS,mBAAmB,WAAsC;AACvE,QAAM,gBAAgB,KAAK,UAAU,CAAC,GAAG,SAAS,CAAC;AACnD,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAiBa,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBnC;","names":[]}
1	+ {"version":3,"sources":["../src/core.ts"],"sourcesContent":["/*\n @ai-matrx/print/core — the Block Print contract & print-window composition.\n \n Ported VERBATIM from matrx-frontend `lib/block-print/block-print-utils.ts`\n * (2026-08-29 state, including the `number` and `select` PrintSetting types the\n * commerce label lane added). Zero dependencies; touches `window` only at call\n * time, so the module stays import-inert and RSC-safe.\n \n BlockPrinter is the only interface a host system needs to know about.\n * Each printable unit exports its own BlockPrinter alongside its render\n * component; host code only ever calls print(data, variantId, settings).\n \n `buildFitTextScript` is the ONE auto-shrink script (the flashcards\n * FIT_TEXT pattern, parameterized by selector so the label lane shares it).\n /\n\n// ─── Contract ────────────────────────────────────────────────────────────────\n\nexport interface PrintVariant {\n id: string;\n label: string;\n description?: string;\n}\n\n/\n A single user-configurable setting shown in the print dialog.\n * Extend the discriminated union for new control types\n * without breaking existing printers.\n /\nexport type PrintSetting =\n \| {\n type: \"boolean\";\n id: string;\n label: string;\n description?: string;\n /* Default value shown when the dialog first opens /\n defaultValue: boolean;\n /* Which variant IDs this setting applies to. Omit = applies to all. /\n appliesTo?: string[];\n }\n \| {\n /\n A numeric \"from → to\" range control, rendered as two small number inputs.\n * Writes two entries into the resolved PrintSettings map — one under fromId,\n * one under toId. Printers interpret 0 (or missing) as \"no bound\" by convention.\n /\n type: \"range\";\n /* Stable id used as React key — not written to the settings map /\n id: string;\n label: string;\n description?: string;\n /* Settings map key for the lower bound value /\n fromId: string;\n /* Settings map key for the upper bound value /\n toId: string;\n defaultFrom: number;\n defaultTo: number;\n /* Minimum accepted value for each input (inclusive). Default 0. /\n min?: number;\n /* Placeholder shown when the input is empty (0). Default \"start\" / \"end\". /\n fromPlaceholder?: string;\n toPlaceholder?: string;\n /* Which variant IDs this setting applies to. Omit = applies to all. /\n appliesTo?: string[];\n }\n \| {\n /* A single numeric input (e.g. \"start at label #\", \"copies\"). /\n type: \"number\";\n id: string;\n label: string;\n description?: string;\n defaultValue: number;\n /* Minimum accepted value (inclusive). Default 0. /\n min?: number;\n /* Maximum accepted value (inclusive). Omit = unbounded. /\n max?: number;\n /* Which variant IDs this setting applies to. Omit = applies to all. /\n appliesTo?: string[];\n }\n \| {\n /* A one-of-N choice rendered as a compact segmented row. /\n type: \"select\";\n id: string;\n label: string;\n description?: string;\n options: { value: string; label: string }[];\n defaultValue: string;\n /* Which variant IDs this setting applies to. Omit = applies to all. /\n appliesTo?: string[];\n };\n\n/* A resolved map of setting id → current value, passed to print(). /\nexport type PrintSettings = Record<string, boolean \| string \| number>;\n\n/\n The self-contained print capability that each block can export.\n * Host code only ever calls print(data, variantId, settings) — it never inspects internals.\n /\nexport interface BlockPrinter {\n /* Tooltip / aria-label for the print button in the block header /\n label: string;\n\n /\n Variants offered to the user before printing.\n * Empty array = no options dialog shown; prints immediately with defaults.\n /\n variants: PrintVariant[];\n\n /\n Optional user-configurable settings shown below the variant picker.\n * Omit entirely if the block has no configurable settings.\n /\n settings?: PrintSetting[];\n\n /\n Execute the print.\n * data — the block's structured data (serverData or parsed content)\n * variantId — which variant was chosen (undefined = default / no variants)\n * settings — resolved setting values chosen by the user\n \n MAY resolve to a PrintOutcome (\"opened\" \| \"downloaded\") so the host can\n * tell the user when the popup-blocked download fallback fired; `void`\n * stays legal for printers that don't go through a print window.\n /\n print: (\n data: unknown,\n variantId?: string,\n settings?: PrintSettings,\n ) => void \| PrintOutcome \| Promise<void \| PrintOutcome>;\n}\n\n// ─── Shared Utilities ─────────────────────────────────────────────────────────\n\nconst PRINT_STYLES = `\n , ::before, ::after { box-sizing: border-box; margin: 0; padding: 0; }\n\n body {\n font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Helvetica Neue', Arial, sans-serif;\n font-size: 11pt;\n line-height: 1.6;\n color: #1a1a1a;\n background: #fff;\n max-width: 860px;\n margin: 0 auto;\n padding: 28px 36px;\n }\n\n .print-actions {\n display: flex;\n gap: 10px;\n margin-bottom: 24px;\n padding-bottom: 18px;\n border-bottom: 2px solid #e5e7eb;\n }\n\n .print-btn {\n display: inline-flex;\n align-items: center;\n gap: 6px;\n padding: 8px 20px;\n border-radius: 8px;\n font-size: 13px;\n font-family: inherit;\n cursor: pointer;\n border: none;\n font-weight: 600;\n }\n\n .print-btn-primary { background: #2563eb; color: #fff; }\n .print-btn-secondary { background: #f3f4f6; color: #374151; border: 1px solid #d1d5db; }\n\n h1 { font-size: 22pt; font-weight: 700; margin-bottom: 0.5em; }\n h2 { font-size: 16pt; font-weight: 700; margin: 1.2em 0 0.4em; border-bottom: 1px solid #e5e7eb; padding-bottom: 0.2em; }\n h3 { font-size: 13pt; font-weight: 600; margin: 1em 0 0.3em; }\n p { margin-bottom: 0.7em; }\n\n table {\n width: 100%;\n border-collapse: collapse;\n margin: 1em 0;\n font-size: 10pt;\n }\n th {\n background: #1e293b;\n color: #f8fafc;\n font-weight: 600;\n text-align: left;\n padding: 7px 12px;\n border: 1px solid #334155;\n }\n td {\n padding: 6px 12px;\n border: 1px solid #e2e8f0;\n vertical-align: top;\n }\n tr:nth-child(even) td { background: #f8fafc; }\n\n @media print {\n body { max-width: 100%; padding: 0; }\n .print-actions { display: none !important; }\n th { -webkit-print-color-adjust: exact; print-color-adjust: exact; }\n }\n`;\n\nfunction escapeHtml(str: string): string {\n return str\n .replace(/&/g, \"&\")\n .replace(/</g, \"<\")\n .replace(/>/g, \">\")\n .replace(/\"/g, \""\")\n .replace(/'/g, \"'\");\n}\n\n/*\n Wrap body HTML in a complete, styled print document.\n /\nexport function buildPrintDocument(\n bodyHtml: string,\n title = \"AI Response\",\n extraStyles = \"\",\n): string {\n return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\">\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n <title>${escapeHtml(title)}</title>\n <style>\n${PRINT_STYLES}\n${extraStyles}\n </style>\n</head>\n<body>\n <div class=\"print-actions\">\n <button class=\"print-btn print-btn-primary\" onclick=\"window.print()\">Print / Save as PDF</button>\n <button class=\"print-btn print-btn-secondary\" onclick=\"window.close()\">Close</button>\n </div>\n <div class=\"content\">\n${bodyHtml}\n </div>\n</body>\n</html>`;\n}\n\n/\n How a print request actually reached the user.\n \n \"opened\" — a print window/tab was opened and the document written into it.\n * \"downloaded\" — the popup was blocked, so the document was downloaded as an\n * .html file instead (the contract's fallback). Hosts SHOULD\n * surface this to the user (e.g. a toast saying the print file\n * was downloaded) — a blocked popup plus a silent download is\n * indistinguishable from \"nothing happened\", which is exactly\n * how QA filed it (2026-08-30, F5/F6/F8).\n /\nexport type PrintOutcome = \"opened\" \| \"downloaded\";\n\n/\n Open a new browser window and write a complete HTML document into it.\n * Falls back to downloading an .html file if the popup is blocked.\n \n Returns which path was taken so callers can tell the user when the\n * fallback fired. `windowFeatures` customizes the popup geometry (the\n * flashcards fixed-geometry variants pass a wider window).\n /\nexport function openPrintWindow(\n htmlDocument: string,\n filename = \"print\",\n windowFeatures = \"width=920,height=720,scrollbars=yes\",\n): PrintOutcome {\n const win = window.open(\"\", \"_blank\", windowFeatures);\n if (!win) {\n // Popup blocked — fall back to file download\n const blob = new Blob([htmlDocument], { type: \"text/html;charset=utf-8\" });\n const url = URL.createObjectURL(blob);\n const a = document.createElement(\"a\");\n a.href = url;\n a.download = `${filename.replace(/\\s+/g, \"-\").toLowerCase()}.html`;\n document.body.appendChild(a);\n a.click();\n document.body.removeChild(a);\n // Revoke on a macrotask so the browser has started the blob fetch —\n // a synchronous revoke races the download in some engines.\n setTimeout(() => URL.revokeObjectURL(url), 0);\n return \"downloaded\";\n }\n win.document.open();\n win.document.write(htmlDocument);\n win.document.close();\n return \"opened\";\n}\n\n/\n Shorthand: build the document and open it in one call.\n * Returns the same PrintOutcome as openPrintWindow.\n /\nexport function printHtmlContent(\n bodyHtml: string,\n title = \"AI Response\",\n extraStyles = \"\",\n): PrintOutcome {\n const doc = buildPrintDocument(bodyHtml, title, extraStyles);\n return openPrintWindow(doc, title);\n}\n\n/\n Build the auto-shrink script that runs INSIDE a printed window: for every\n * element matching each selector, its font-size is reduced (0.5pt steps, 6pt\n * floor) until it fits its parent element's box. This is the flashcards\n * FIT_TEXT behavior verbatim, parameterized by selector so every lane\n * (flashcards card text, Avery text, label captions) shares the ONE loop.\n \n Pass the same selectors the original used to get byte-identical behavior:\n * flashcards passes `[\".card-text .card-text-inner\", \".avery-text-wrap .avery-text\"]`.\n */\nexport function buildFitTextScript(selectors: readonly string[]): string {\n const selectorsJson = JSON.stringify([...selectors]);\n return `\n<script>\n(function() {\n function fitText(el, container) {\n // container is the bounding box we must fit inside\n var maxW = container.clientWidth;\n var maxH = container.clientHeight;\n var size = parseFloat(window.getComputedStyle(el).fontSize);\n var minSize = 6;\n // Give the element a chance to reflow at current size before measuring\n el.style.fontSize = size + \"pt\";\n while (size > minSize && (el.scrollWidth > maxW + 1 \|\| el.scrollHeight > maxH + 1)) {\n size -= 0.5;\n el.style.fontSize = size + \"pt\";\n }\n }\n function runAll() {\n var selectors = ${selectorsJson};\n for (var s = 0; s < selectors.length; s++) {\n var els = document.querySelectorAll(selectors[s]);\n for (var i = 0; i < els.length; i++) {\n fitText(els[i], els[i].parentElement);\n }\n }\n }\n if (document.readyState === \"loading\") {\n document.addEventListener(\"DOMContentLoaded\", runAll);\n } else {\n // document.write pages may already be loaded\n setTimeout(runAll, 0);\n }\n})();\n</script>`;\n}\n\nexport { escapeHtml };\n"],"mappings":";AAqIA,IAAM,eAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAuErB,SAAS,WAAW,KAAqB;AACvC,SAAO,IACJ,QAAQ,MAAM,OAAO,EACrB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,QAAQ,EACtB,QAAQ,MAAM,OAAO;AAC1B;AAKO,SAAS,mBACd,UACA,QAAQ,eACR,cAAc,IACN;AACR,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA,WAKE,WAAW,KAAK,CAAC;AAAA;AAAA,EAE1B,YAAY;AAAA,EACZ,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASX,QAAQ;AAAA;AAAA;AAAA;AAIV;AAuBO,SAAS,gBACd,cACA,WAAW,SACX,iBAAiB,uCACH;AACd,QAAM,MAAM,OAAO,KAAK,IAAI,UAAU,cAAc;AACpD,MAAI,CAAC,KAAK;AAER,UAAM,OAAO,IAAI,KAAK,CAAC,YAAY,GAAG,EAAE,MAAM,0BAA0B,CAAC;AACzE,UAAM,MAAM,IAAI,gBAAgB,IAAI;AACpC,UAAM,IAAI,SAAS,cAAc,GAAG;AACpC,MAAE,OAAO;AACT,MAAE,WAAW,GAAG,SAAS,QAAQ,QAAQ,GAAG,EAAE,YAAY,CAAC;AAC3D,aAAS,KAAK,YAAY,CAAC;AAC3B,MAAE,MAAM;AACR,aAAS,KAAK,YAAY,CAAC;AAG3B,eAAW,MAAM,IAAI,gBAAgB,GAAG,GAAG,CAAC;AAC5C,WAAO;AAAA,EACT;AACA,MAAI,SAAS,KAAK;AAClB,MAAI,SAAS,MAAM,YAAY;AAC/B,MAAI,SAAS,MAAM;AACnB,SAAO;AACT;AAMO,SAAS,iBACd,UACA,QAAQ,eACR,cAAc,IACA;AACd,QAAM,MAAM,mBAAmB,UAAU,OAAO,WAAW;AAC3D,SAAO,gBAAgB,KAAK,KAAK;AACnC;AAYO,SAAS,mBAAmB,WAAsC;AACvE,QAAM,gBAAgB,KAAK,UAAU,CAAC,GAAG,SAAS,CAAC;AACnD,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAiBa,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBnC;","names":[]}

package/dist/flashcards.cjs CHANGED Viewed

@@ -121,8 +121,8 @@ ${bodyHtml}
 </body>
 </html>`;
 }
-function openPrintWindow(htmlDocument, filename = "print") {
-  const win = window.open("", "_blank", "width=920,height=720,scrollbars=yes");
+function openPrintWindow(htmlDocument, filename = "print", windowFeatures = "width=920,height=720,scrollbars=yes") {
+  const win = window.open("", "_blank", windowFeatures);
   if (!win) {
     const blob = new Blob([htmlDocument], { type: "text/html;charset=utf-8" });
     const url = URL.createObjectURL(blob);
@@ -132,12 +132,13 @@ function openPrintWindow(htmlDocument, filename = "print") {
     document.body.appendChild(a);
     a.click();
     document.body.removeChild(a);
-    URL.revokeObjectURL(url);
-    return;
+    setTimeout(() => URL.revokeObjectURL(url), 0);
+    return "downloaded";
   }
   win.document.open();
   win.document.write(htmlDocument);
   win.document.close();
+  return "opened";
 }
 function buildFitTextScript(selectors) {
   const selectorsJson = JSON.stringify([...selectors]);
@@ -973,22 +974,7 @@ ${bodyHtml}
 ${FIT_TEXT_SCRIPT}
 </body>
 </html>`;
-  const win = window.open("", "_blank", "width=1100,height=720,scrollbars=yes");
-  if (!win) {
-    const blob = new Blob([html], { type: "text/html;charset=utf-8" });
-    const url = URL.createObjectURL(blob);
-    const a = document.createElement("a");
-    a.href = url;
-    a.download = `${title.replace(/\s+/g, "-").toLowerCase()}-flashcards.html`;
-    document.body.appendChild(a);
-    a.click();
-    document.body.removeChild(a);
-    URL.revokeObjectURL(url);
-    return;
-  }
-  win.document.open();
-  win.document.write(html);
-  win.document.close();
+  return openPrintWindow(html, `${title}-flashcards`, "width=1100,height=720,scrollbars=yes");
 }
 var AVERY_5388_STYLES = `
   @page { size: portrait; margin: 0; }
@@ -1170,22 +1156,7 @@ ${bodyHtml}
 ${FIT_TEXT_SCRIPT}
 </body>
 </html>`;
-  const win = window.open("", "_blank", "width=900,height=720,scrollbars=yes");
-  if (!win) {
-    const blob = new Blob([html], { type: "text/html;charset=utf-8" });
-    const url = URL.createObjectURL(blob);
-    const a = document.createElement("a");
-    a.href = url;
-    a.download = `${title.replace(/\s+/g, "-").toLowerCase()}-avery5388.html`;
-    document.body.appendChild(a);
-    a.click();
-    document.body.removeChild(a);
-    URL.revokeObjectURL(url);
-    return;
-  }
-  win.document.open();
-  win.document.write(html);
-  win.document.close();
+  return openPrintWindow(html, `${title}-avery5388`, "width=900,height=720,scrollbars=yes");
 }
 var PORTRAIT_6UP_STYLES = `
   @page { size: portrait; margin: 0; }
@@ -1435,22 +1406,7 @@ ${bodyHtml}
 ${FIT_TEXT_SCRIPT}
 </body>
 </html>`;
-  const win = window.open("", "_blank", "width=900,height=720,scrollbars=yes");
-  if (!win) {
-    const blob = new Blob([html], { type: "text/html;charset=utf-8" });
-    const url = URL.createObjectURL(blob);
-    const a = document.createElement("a");
-    a.href = url;
-    a.download = `${title.replace(/\s+/g, "-").toLowerCase()}-flashcards-6up.html`;
-    document.body.appendChild(a);
-    a.click();
-    document.body.removeChild(a);
-    URL.revokeObjectURL(url);
-    return;
-  }
-  win.document.open();
-  win.document.write(html);
-  win.document.close();
+  return openPrintWindow(html, `${title}-flashcards-6up`, "width=900,height=720,scrollbars=yes");
 }
 function deriveTitle(data) {
   if (data && typeof data === "object" && "title" in data) {
@@ -1629,7 +1585,7 @@ var flashcardsPrinter = {
     const title = deriveTitle(data);
     const s = resolveSettings(rawSettings);
     if (allCards.length === 0) {
-      openPrintWindow(
+      return openPrintWindow(
         buildPrintDocument(
           "<p>No flashcard data available to print.</p>",
           title,
@@ -1637,7 +1593,6 @@ var flashcardsPrinter = {
         ),
         "flashcards"
       );
-      return;
     }
     const rawFrom = typeof rawSettings?.fromCard === "number" ? rawSettings.fromCard : 0;
     const rawTo = typeof rawSettings?.toCard === "number" ? rawSettings.toCard : 0;
@@ -1647,36 +1602,31 @@ var flashcardsPrinter = {
     const startIndex = fromIdx - 1;
     const cards = allCards.slice(startIndex, toIdx);
     if (variantId === "landscape-duplex") {
-      openLandscapeWindow(
+      return openLandscapeWindow(
         renderLandscape(cards, title, "duplex", s, startIndex),
         title
       );
-      return;
     }
     if (variantId === "landscape-stacked") {
-      openLandscapeWindow(
+      return openLandscapeWindow(
         renderLandscape(cards, title, "stacked", s, startIndex),
         title
       );
-      return;
     }
     if (variantId === "portrait-6up-duplex") {
-      openPortrait6UpWindow(
+      return openPortrait6UpWindow(
         renderPortrait6Up(cards, title, "duplex", s, startIndex),
         title
       );
-      return;
     }
     if (variantId === "portrait-6up-stacked") {
-      openPortrait6UpWindow(
+      return openPortrait6UpWindow(
         renderPortrait6Up(cards, title, "stacked", s, startIndex),
         title
       );
-      return;
     }
     if (variantId === "avery-5388") {
-      openAveryWindow(renderAvery5388(cards, title, s, startIndex), title);
-      return;
+      return openAveryWindow(renderAvery5388(cards, title, s, startIndex), title);
     }
     let bodyHtml;
     let styles;
@@ -1703,7 +1653,10 @@ var flashcardsPrinter = {
         styles = BOTH_SIDES_STYLES;
         break;
     }
-    openPrintWindow(buildPrintDocument(bodyHtml, title, styles), "flashcards");
+    return openPrintWindow(
+      buildPrintDocument(bodyHtml, title, styles),
+      "flashcards"
+    );
   }
 };
 //# sourceMappingURL=flashcards.cjs.map