@endora-commerce/email-components 0.100.0

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+export * from './schema/component-types.js';
+export * from './schema/envelope.js';
+export * from './render/escape-html.js';
+export * from './render/render-email-html.js';
+export * from './render/render-email-text.js';
+export * from './render/sanitize-email-html.js';
+export * from './render/sample-variables.js';
+export * from './render/order-labels.js';
+export * from './directives/directive-engine.js';
+export * from './tree/walk-embeds.js';
+export * from './defaults/default-header.js';
+export * from './defaults/default-footer.js';
+export * from './defaults/simple-email-body.js';
+export * from './components/email-embeds-context.js';
+export * from './components/email-branding-preview-context.js';
+export * from './editor/email-row-layout-presets.js';
+export * from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,sCAAsC,CAAC;AACrD,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+// @endora-commerce/email-components — shared transactional-email building blocks (feature 047).
+//
+// Root entry (admin/editor surface): re-exports the React Puck config plus the
+// pure schema/render/directive/tree/defaults modules. The BACKEND must import
+// the pure subpaths directly (e.g. `@endora-commerce/email-components/render/render-email-html`)
+// to avoid pulling React into the send path.
+export * from './schema/component-types.js';
+export * from './schema/envelope.js';
+export * from './render/escape-html.js';
+export * from './render/render-email-html.js';
+export * from './render/render-email-text.js';
+export * from './render/sanitize-email-html.js';
+export * from './render/sample-variables.js';
+export * from './render/order-labels.js';
+export * from './directives/directive-engine.js';
+export * from './tree/walk-embeds.js';
+export * from './defaults/default-header.js';
+export * from './defaults/default-footer.js';
+export * from './defaults/simple-email-body.js';
+export * from './components/email-embeds-context.js';
+export * from './components/email-branding-preview-context.js';
+export * from './editor/email-row-layout-presets.js';
+export * from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,iGAAiG;AACjG,6CAA6C;AAE7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,sCAAsC,CAAC;AACrD,cAAc,aAAa,CAAC"}

package/dist/render/escape-html.d.ts

@@ -0,0 +1,4 @@
+export declare function escapeHtml(input: string): string;
+/** Escape a value for use inside a double-quoted HTML attribute. */
+export declare function escapeAttr(input: string): string;
+//# sourceMappingURL=escape-html.d.ts.map

package/dist/render/escape-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-html.d.ts","sourceRoot":"","sources":["../../src/render/escape-html.ts"],"names":[],"mappings":"AAeA,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,oEAAoE;AACpE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/render/escape-html.js

@@ -0,0 +1,21 @@
+// HTML escaping for email rendering (feature 047).
+//
+// Note: `{` and `}` are intentionally NOT escaped — the directive engine runs
+// over the rendered HTML string AFTER component rendering, so `{{var ...}}`
+// markers authored inside text must survive escaping. Variable *values* are
+// escaped by the directive engine when injected into HTML output.
+const HTML_ESCAPE = {
+    '&': '&',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#39;',
+};
+export function escapeHtml(input) {
+    return input.replace(/[&<>"']/g, (ch) => HTML_ESCAPE[ch] ?? ch);
+}
+/** Escape a value for use inside a double-quoted HTML attribute. */
+export function escapeAttr(input) {
+    return escapeHtml(input);
+}
+//# sourceMappingURL=escape-html.js.map

package/dist/render/escape-html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-html.js","sourceRoot":"","sources":["../../src/render/escape-html.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,4EAA4E;AAC5E,kEAAkE;AAElE,MAAM,WAAW,GAA2B;IAC1C,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,OAAO;CACb,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/render/order-labels.d.ts

@@ -0,0 +1,23 @@
+/** Built-in order email UI strings (table headers + totals lines). */
+export declare function isPolishLocale(language: string | null | undefined): boolean;
+export interface OrderSummaryColumnLabels {
+    sku: string;
+    item: string;
+    qty: string;
+    price: string;
+}
+export declare function orderSummaryColumnLabels(language: string | null | undefined): OrderSummaryColumnLabels;
+export interface OrderTotalsLabels {
+    subtotal: string;
+    tax: string;
+    delivery: string;
+    discount: string;
+    total: string;
+    none: string;
+    taxId: string;
+}
+export declare function orderTotalsLabels(language: string | null | undefined): OrderTotalsLabels;
+/** Sample `order.summaryText` for admin HTML preview. */
+export declare function sampleOrderSummaryText(language: string | null | undefined): string;
+export declare function sampleOrderDiscountsText(language: string | null | undefined): string;
+//# sourceMappingURL=order-labels.d.ts.map

package/dist/render/order-labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-labels.d.ts","sourceRoot":"","sources":["../../src/render/order-labels.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE3E;AAED,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,wBAAwB,CAK1B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,iBAAiB,CAqBxF;AAED,yDAAyD;AACzD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAQlF;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAEpF"}

package/dist/render/order-labels.js

@@ -0,0 +1,46 @@
+/** Built-in order email UI strings (table headers + totals lines). */
+export function isPolishLocale(language) {
+    return (language ?? '').toLowerCase().startsWith('pl');
+}
+export function orderSummaryColumnLabels(language) {
+    if (isPolishLocale(language)) {
+        return { sku: 'SKU', item: 'Produkt', qty: 'Ilość', price: 'Cena' };
+    }
+    return { sku: 'SKU', item: 'Item', qty: 'Qty', price: 'Price' };
+}
+export function orderTotalsLabels(language) {
+    if (isPolishLocale(language)) {
+        return {
+            subtotal: 'Suma częściowa',
+            tax: 'VAT',
+            delivery: 'Dostawa',
+            discount: 'Rabat',
+            total: 'Razem',
+            none: 'brak',
+            taxId: 'NIP',
+        };
+    }
+    return {
+        subtotal: 'Subtotal',
+        tax: 'Tax',
+        delivery: 'Delivery',
+        discount: 'Discount',
+        total: 'Total',
+        none: 'none',
+        taxId: 'Tax ID',
+    };
+}
+/** Sample `order.summaryText` for admin HTML preview. */
+export function sampleOrderSummaryText(language) {
+    const L = orderTotalsLabels(language);
+    return [
+        `  ${L.subtotal}: 99.99 PLN`,
+        `  ${L.tax}: 23.00 PLN`,
+        `  ${L.delivery}: 15.00 PLN`,
+        `  ${L.total}: 137.99 PLN`,
+    ].join('\n');
+}
+export function sampleOrderDiscountsText(language) {
+    return `  ${orderTotalsLabels(language).none}`;
+}
+//# sourceMappingURL=order-labels.js.map

package/dist/render/order-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-labels.js","sourceRoot":"","sources":["../../src/render/order-labels.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,MAAM,UAAU,cAAc,CAAC,QAAmC;IAChE,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC;AASD,MAAM,UAAU,wBAAwB,CACtC,QAAmC;IAEnC,IAAI,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACtE,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAClE,CAAC;AAYD,MAAM,UAAU,iBAAiB,CAAC,QAAmC;IACnE,IAAI,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,QAAQ,EAAE,gBAAgB;YAC1B,GAAG,EAAE,KAAK;YACV,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,OAAO;YACd,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,KAAK;SACb,CAAC;IACJ,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,UAAU;QACpB,GAAG,EAAE,KAAK;QACV,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,QAAQ;KAChB,CAAC;AACJ,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,sBAAsB,CAAC,QAAmC;IACxE,MAAM,CAAC,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACtC,OAAO;QACL,KAAK,CAAC,CAAC,QAAQ,aAAa;QAC5B,KAAK,CAAC,CAAC,GAAG,aAAa;QACvB,KAAK,CAAC,CAAC,QAAQ,aAAa;QAC5B,KAAK,CAAC,CAAC,KAAK,cAAc;KAC3B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAmC;IAC1E,OAAO,KAAK,iBAAiB,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;AACjD,CAAC"}

package/dist/render/render-email-html.d.ts

@@ -0,0 +1,18 @@
+import type { PuckDataTree } from '../schema/envelope.js';
+import { emailHtmlToPlainText, sanitizeEmailHtml } from './sanitize-email-html.js';
+export interface EmailRenderEmbeds {
+    blocks: Record<string, PuckDataTree>;
+    templates: Record<string, PuckDataTree>;
+}
+export interface RenderEmailHtmlOptions {
+    embeds?: EmailRenderEmbeds;
+    accentColor?: string;
+    maxDepth?: number;
+    /** Wrap the body in a full HTML document shell. Default true. */
+    document?: boolean;
+    /** Locale for built-in strings (e.g. order table column headers). */
+    language?: string;
+}
+export declare function renderEmailHtml(tree: PuckDataTree | null | undefined, opts?: RenderEmailHtmlOptions): string;
+export { emailHtmlToPlainText, sanitizeEmailHtml };
+//# sourceMappingURL=render-email-html.d.ts.map

package/dist/render/render-email-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-email-html.d.ts","sourceRoot":"","sources":["../../src/render/render-email-html.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AA+B1D,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAOnF,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAqxBD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,EACrC,IAAI,GAAE,sBAA2B,GAChC,MAAM,CAYR;AAED,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,CAAC"}