@happyvertical/smrt-svelte 0.57.3 → 0.57.4

package/agents/import-export.md

@@ -60,3 +60,32 @@ component.
 Native `.xlsx` read/write (save as CSV first), server-side dry-run endpoints,
 upsert-by-key, and recipe/nav wiring (offering the panel on list screens waits
 on the recipe surface contract, #3708).
+
+## Server CSV entry (#4080)
+
+Plain Node ingestion workers import the existing pure CSV API from
+`@happyvertical/smrt-svelte/import-export/csv`. This subpath exposes `parseTable`,
+`parseDelimited`, `formatDelimited`, delimiter/BOM helpers, formula helpers,
+`CsvParseError`, and their option/result types without loading Svelte or DOM code.
+The `./import-export` barrel remains the component-facing entry.
+
+```ts
+import { parseTable } from '@happyvertical/smrt-svelte/import-export/csv';
+
+const table = parseTable(csvText, { delimiter: ',', maxRecords: 10_001 });
+```
+
+The parser does not authorize, map, or persist business records. Hosts enforce
+input size and domain validation and retain source evidence independently.
+
+### Export validation
+
+| Behavior | Evidence |
+| --- | --- |
+| Existing parsing, escaping, bounds and spreadsheet helpers | Focused `src/components/import-export/__tests__/csv.test.ts` |
+| Node consumers can resolve public entry without a Svelte loader | Build and pack package, extract into an isolated `node_modules/@happyvertical/smrt-svelte`, and import `./import-export/csv` in plain Node; assert BOM/quoted-newline parse and row-limit error |
+| TypeScript consumers resolve declarations | Packed `exports` target and generated `csv.d.ts` exist; normal package export/type verifier |
+| Component entry remains compatible | Existing component export untouched; no parser or component behavior changed |
+
+No schema, authorization, transaction, or tenant mutation is introduced by
+this additive export; those behavioral test dimensions are not applicable.

package/dist/components/cookbook/build.d.ts

@@ -1,7 +1,10 @@
 import type { BuildCookbookShellOptions, CookbookShell } from './types.js';
 /** `PurchaseOrder` -> `Purchase Order`. */
 export declare function humanize(name: string): string;
-/** `Customer` -> `Customers`, `Category` -> `Categories`. */
+/**
+ * `Customer` -> `Customers`, `Category` -> `Categories`. A noun that is its
+ * own plural stays as it is: `Event Series` -> `Event Series`.
+ */
 export declare function pluralize(noun: string): string;
 /** Derive the shell configuration from a cookbook (see {@link CookbookShell}). */
 export declare function buildCookbookShell(options: BuildCookbookShellOptions): CookbookShell;

package/dist/components/cookbook/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/components/cookbook/build.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EACV,yBAAyB,EAQzB,aAAa,EAEd,MAAM,YAAY,CAAC;AAEpB,2CAA2C;AAC3C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI9C;AA0ED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,aAAa,CAyOf"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/components/cookbook/build.ts"],"names":[],"mappings":"AAqCA,OAAO,KAAK,EACV,yBAAyB,EAQzB,aAAa,EAEd,MAAM,YAAY,CAAC;AAEpB,2CAA2C;AAC3C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9C;AA0ED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,yBAAyB,GACjC,aAAa,CAyOf"}

package/dist/components/cookbook/build.js

@@ -6,8 +6,13 @@ import { resolveCookbookTheme } from './theme.js';
 export function humanize(name) {
     return name.replace(/([a-z0-9])([A-Z])/g, '$1 $2');
 }
-/** `Customer` -> `Customers`, `Category` -> `Categories`. */
+/**
+ * `Customer` -> `Customers`, `Category` -> `Categories`. A noun that is its
+ * own plural stays as it is: `Event Series` -> `Event Series`.
+ */
 export function pluralize(noun) {
+    if (/(series|species)$/i.test(noun))
+        return noun;
     if (/[^aeiou]y$/i.test(noun))
         return `${noun.slice(0, -1)}ies`;
     if (/(s|x|z|ch|sh)$/i.test(noun))

package/dist/components/overview/widgets/LineItemsWidget.svelte

@@ -17,6 +17,7 @@ import {
   isStoredLineItemsTotals,
   lineItemTotals,
   sumLineAmounts,
+  taxComponentLabel,
 } from './line-totals.js';
 import RecordTable from './RecordTable.svelte';
 import {
@@ -129,7 +130,7 @@ const LABELS = {
       {/if}
       {#each storedTaxes as tax (`${tax.taxComponentId}-${tax.name}-${tax.percent}`)}
         <div class="smrt-line-items__total smrt-line-items__total--muted">
-          <dt>{t(M[storedTotals.lineAmountType === 'inclusive' ? 'ui.overview.line_items.tax_included' : 'ui.overview.line_items.tax_on'], { name: tax.name, percent: tax.percent })} {money(storedTotals.lineAmountType === 'inclusive' ? tax.tax : tax.taxable)}</dt>
+          <dt>{t(M[storedTotals.lineAmountType === 'inclusive' ? 'ui.overview.line_items.tax_included' : 'ui.overview.line_items.tax_on'], { label: taxComponentLabel(tax.name, tax.percent) })} {money(storedTotals.lineAmountType === 'inclusive' ? tax.tax : tax.taxable)}</dt>
           {#if storedTotals.lineAmountType !== 'inclusive'}<dd>{money(tax.tax)}</dd>{/if}
         </div>
       {/each}

package/dist/components/overview/widgets/LineItemsWidget.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LineItemsWidget.svelte.d.ts","sourceRoot":"","sources":["../../../../src/components/overview/widgets/LineItemsWidget.svelte.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAY,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAoK/D,QAAA,MAAM,eAAe,+EAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}
+{"version":3,"file":"LineItemsWidget.svelte.d.ts","sourceRoot":"","sources":["../../../../src/components/overview/widgets/LineItemsWidget.svelte.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAY,KAAK,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAqK/D,QAAA,MAAM,eAAe,+EAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}

package/dist/components/overview/widgets/line-totals.d.ts

@@ -64,6 +64,13 @@ export declare function isStoredLineItemsTotals(value: unknown): value is Stored
  * separate; this does not calculate or reallocate tax.
  */
 export declare function groupStoredTaxComponents(taxes: readonly StoredTaxComponent[]): StoredTaxComponentGroup[];
+/**
+ * A tax component's name with its rate, for a totals line: "GST 5%". A name
+ * that already states the rate ("Canada GST 5%", as smrt-commerce's example
+ * pack and cookbook activation name theirs) is used as it is, so the rate is
+ * not repeated.
+ */
+export declare function taxComponentLabel(name: string, percent: string): string;
 export type LineTotalKey = 'subtotal' | 'discount' | 'tax' | 'total';
 export interface LineTotalLine {
     key: LineTotalKey;

package/dist/components/overview/widgets/line-totals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"line-totals.d.ts","sourceRoot":"","sources":["../../../../src/components/overview/widgets/line-totals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,gFAAgF;AAChF,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;AAEhE,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACxC;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,UAAU,CAAC;IACnC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACtC;AAED,sEAAsE;AACtE,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;CAAG;AAEtE,4EAA4E;AAC5E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,qBAAqB,CAYhC;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,SAAS,kBAAkB,EAAE,GACnC,uBAAuB,EAAE,CA0B3B;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,KAAK,GAAG,OAAO,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,YAAY,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,QAAQ,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC;IAC5B,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,oEAAoE;IACpE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACrC;AAQD,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,GAAG,IAAI,CAUzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,eAAe,GAAG,SAAS,EACnC,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,gBAAgB,CAwElB"}
+{"version":3,"file":"line-totals.d.ts","sourceRoot":"","sources":["../../../../src/components/overview/widgets/line-totals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,gFAAgF;AAChF,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;AAEhE,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CACxC;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE;AAED,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,cAAc,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,UAAU,CAAC;IACnC,0EAA0E;IAC1E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACtC;AAED,sEAAsE;AACtE,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;CAAG;AAEtE,4EAA4E;AAC5E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,qBAAqB,CAYhC;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,SAAS,kBAAkB,EAAE,GACnC,uBAAuB,EAAE,CA0B3B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKvE;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,KAAK,GAAG,OAAO,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,YAAY,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,QAAQ,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC;IAC5B,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,oEAAoE;IACpE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACrC;AAQD,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,GAAG,IAAI,CAUzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,eAAe,GAAG,SAAS,EACnC,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,gBAAgB,CAwElB"}

package/dist/components/overview/widgets/line-totals.js

@@ -63,6 +63,18 @@ export function groupStoredTaxComponents(taxes) {
     }
     return [...groups.values()];
 }
+/**
+ * A tax component's name with its rate, for a totals line: "GST 5%". A name
+ * that already states the rate ("Canada GST 5%", as smrt-commerce's example
+ * pack and cookbook activation name theirs) is used as it is, so the rate is
+ * not repeated.
+ */
+export function taxComponentLabel(name, percent) {
+    const rate = percent.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(`(^|[^\\d.])${rate}\\s?%`).test(name)
+        ? name
+        : `${name} ${percent}%`;
+}
 function money(value) {
     return typeof value === 'number' && Number.isSafeInteger(value)
         ? value

package/dist/i18n/strings.overview.js

@@ -136,8 +136,8 @@ export const M = defineMessages({
     'ui.overview.line_items.total': 'Total',
     'ui.overview.line_items.subtotal_excluding_tax': 'Subtotal (excl. tax)',
     'ui.overview.line_items.discount_included': 'Includes discounts of',
-    'ui.overview.line_items.tax_on': '{name} {percent}% on',
-    'ui.overview.line_items.tax_included': 'Includes {name} {percent}% of',
+    'ui.overview.line_items.tax_on': '{label} on',
+    'ui.overview.line_items.tax_included': 'Includes {label} of',
     'ui.overview.line_items.rounded_document': 'Rounded per document',
     'ui.overview.line_items.computed': '(from the lines)',
     'ui.overview.line_items.mismatch': 'Lines add up to {amount}.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-svelte",
-  "version": "0.57.3",
+  "version": "0.57.4",
   "smrtJsdoc": "strict",
   "description": "Svelte 5 components for SMRT user management - auth, users, tenants, roles, permissions, groups",
   "type": "module",
@@ -51,6 +51,11 @@
       "import": "./dist/components/import-export/index.js",
       "default": "./dist/components/import-export/index.js"
     },
+    "./import-export/csv": {
+      "types": "./dist/components/import-export/csv.d.ts",
+      "import": "./dist/components/import-export/csv.js",
+      "default": "./dist/components/import-export/csv.js"
+    },
     "./command-palette": {
       "types": "./dist/components/command-palette/index.d.ts",
       "svelte": "./dist/components/command-palette/index.js",
@@ -204,12 +209,12 @@
     "access": "public"
   },
   "dependencies": {
-    "@happyvertical/logger": "^0.103.7",
-    "@happyvertical/smrt-languages": "0.57.3",
-    "@happyvertical/smrt-mcp-apps": "0.57.3",
-    "@happyvertical/smrt-types": "0.57.3",
-    "@happyvertical/smrt-ui": "0.57.3",
-    "@happyvertical/smrt-web": "0.57.3",
+    "@happyvertical/logger": "^0.105.1",
+    "@happyvertical/smrt-languages": "0.57.4",
+    "@happyvertical/smrt-mcp-apps": "0.57.4",
+    "@happyvertical/smrt-types": "0.57.4",
+    "@happyvertical/smrt-ui": "0.57.4",
+    "@happyvertical/smrt-web": "0.57.4",
     "@tanstack/db": "^0.6.14",
     "@tanstack/svelte-db": "^0.1.91",
     "esm-env": "^1.2.2"
@@ -244,15 +249,15 @@
     }
   },
   "devDependencies": {
-    "@happyvertical/smrt-agents": "0.57.3",
-    "@happyvertical/smrt-chat": "0.57.3",
-    "@happyvertical/smrt-content": "0.57.3",
-    "@happyvertical/smrt-core": "0.57.3",
-    "@happyvertical/smrt-reports": "0.57.3",
-    "@happyvertical/smrt-scanner": "0.57.3",
-    "@happyvertical/smrt-tenancy": "0.57.3",
-    "@happyvertical/smrt-users": "0.57.3",
-    "@happyvertical/speech": "^0.103.7",
+    "@happyvertical/smrt-agents": "0.57.4",
+    "@happyvertical/smrt-chat": "0.57.4",
+    "@happyvertical/smrt-content": "0.57.4",
+    "@happyvertical/smrt-core": "0.57.4",
+    "@happyvertical/smrt-reports": "0.57.4",
+    "@happyvertical/smrt-scanner": "0.57.4",
+    "@happyvertical/smrt-tenancy": "0.57.4",
+    "@happyvertical/smrt-users": "0.57.4",
+    "@happyvertical/speech": "^0.105.1",
     "@sveltejs/package": "^2.5.8",
     "@sveltejs/vite-plugin-svelte": "^7.3.0",
     "@testing-library/jest-dom": "^7.0.1",