@happyvertical/smrt-expenses 0.53.3 → 0.53.5

package/AGENTS.md

@@ -125,3 +125,11 @@ pnpm --filter @happyvertical/smrt-expenses test:postgres
 SQLite file and the PostgreSQL lane (`*.optional.test.ts`, schema from
 `migrateSmrtSchemas` plus live parity) both run it. Use UUID tenant and
 profile ids in tests: PostgreSQL stores them as `uuid`.
+
+## UI
+
+`src/svelte/` owns native expense entry and review presentation. See
+[the UI contract](agents/expense-ui.md) for DTOs, native payloads and recovery.
+Draft amounts are lossless currency-unit text; model/review amounts remain integer
+minor units. Receipt upload is composed from Assets, never reimplemented here.
+`test` includes backend and UI SSR; `test:e2e` proves native browser submissions.

package/README.md

@@ -169,8 +169,9 @@ Imported rows start `unreviewed`; replay each donor review through
 ## Testing
 
 ```bash
-pnpm --filter @happyvertical/smrt-expenses test           # SQLite
+pnpm --filter @happyvertical/smrt-expenses test           # SQLite + UI SSR
 pnpm --filter @happyvertical/smrt-expenses test:postgres  # PostgreSQL lane
+pnpm --filter @happyvertical/smrt-expenses test:e2e       # Native browser forms
 ```
 
 ## See also
@@ -179,3 +180,12 @@ pnpm --filter @happyvertical/smrt-expenses test:postgres  # PostgreSQL lane
 - [smrt-commerce](../commerce/README.md) — vendors and purchase orders
 - [smrt-assets](../assets/README.md) — receipt files
 - [smrt-tenancy](../tenancy/README.md) — tenant context and required mode
+
+## Expense and receipt UI
+
+`ExpenseForm` and `ExpenseReviewPanel` from `@happyvertical/smrt-expenses/svelte`
+provide native purchase entry, caller-driven duplicate/correction review and
+Assets receipt composition. `ExpenseForm` uses the shared localized currency
+selector while preserving native field names and rejected raw drafts. See
+[the UI contract](agents/expense-ui.md) for public props, selector restrictions,
+native payloads, retained errors and server responsibilities.

package/agents/expense-ui.md

@@ -0,0 +1,92 @@
+# Expense entry and receipt review
+
+Import `ExpenseForm`, `ExpenseReviewPanel` and their named Props types from
+`@happyvertical/smrt-expenses/svelte`. Registry slots are `expense-form` and
+`expense-review`. `@happyvertical/smrt-expenses/ui` exposes metadata without
+Svelte; `./playground` exposes an interactive retained-draft/review example.
+
+`ExpenseDraftValues` is a complete set of native strings: `amount`, `currency`,
+`incurredOn`, `description`, `category`, `vendorId`, `commitmentId`, `paidBy`,
+`paidByProfileId`, and `correctionReason`. Initialize unused fields to `''`.
+Amount is ordinary currency text (`'125.00'` CAD), distinct from the public
+Expense model's integer minor-unit `amount` (`12500`). Server adapters parse
+currency precision, safe integer range and business rules. Calendar dates stay
+lossless text, normally `YYYY-MM-DD`; invalid amounts/dates never disappear due
+to browser number/date coercion. Every validation failure returns original
+strings, not reconstructed saved-model values.
+
+```svelte
+<script lang="ts">
+  import { ExpenseForm, ExpenseReviewPanel } from '@happyvertical/smrt-expenses/svelte';
+  let { data, form } = $props();
+</script>
+<ExpenseForm
+  action="?/save"
+  title="Record purchase"
+  values={form?.values ?? data.values}
+  errors={form?.errors}
+  message={form?.message}
+  canEdit={data.mayEdit}
+  correcting={data.correcting}
+  vendors={data.authorizedVendors}
+  commitments={data.authorizedCommitments}
+  hiddenFields={[
+    { name: 'requestId', value: form?.requestId ?? data.requestId },
+    { name: 'costObjectId', value: data.costObjectId },
+    { name: 'expectedTenantId', value: data.tenantId },
+  ]}
+/>
+<ExpenseReviewPanel
+  expense={data.expenseSummary}
+  duplicates={data.authorizedDuplicateCandidates}
+  history={data.history}
+  receipts={data.receiptPanel}
+/>
+```
+
+Vendor and commitment options are authorized Commerce `{id, label}` projections.
+Resolve Profile names and application-specific award lineage in the consumer.
+Unknown retained references remain selectable/postable; selecting a reference
+never establishes tenant ownership or commitment eligibility. `fields` maps
+logical keys to native names; `errors` always uses logical keys. Submitter
+`intentField`/`intent` default to `intent=save`. `hiddenFields` preserves exact
+values and repeated names. Avoid field-name collisions. `children` adds
+application-owned package allocation, quantity, reimbursement and correction
+policy fields. `correcting` shows a retained reason, but does not implement a
+new Expense correction model. The caller applies its own correction/history
+policy and invokes existing guarded methods where appropriate.
+
+The base form performs native POST by default, with or without JavaScript.
+`onsubmit` allows optional enhancement. `pending` or a supplied
+`smrt-ui/form-retry` `retryStatus` controls progress presentation without clearing
+values or creating/rotating request keys. `canEdit=false` disables fields and
+hides save; server-side authorization and replay enforcement remain mandatory.
+
+Currency uses the shared `CurrencySelect`, localized by the active smrt-ui i18n
+context. It preserves the exact retained draft string and the field name from
+`fields.currency`, including native no-JavaScript correction flows. Pass
+`currencyOptions` only when the caller must restrict the shared currency catalog.
+
+`ExpenseReviewSummary` projects public Expense description, integer minor-unit
+amount, currency and incurredOn, with caller-localized `statusLabel` and `note`.
+`duplicates` and `history` are explicit authorized presentation DTOs, not a
+parallel ledger. The server supplies findings from ExpenseReceipt duplicate
+queries and application history. Unknown labels render verbatim. No state or
+action is inferred: `canReview`, `action`, `actions` and hidden fingerprints
+explicitly provide a native review form. `action=""` posts to the current page;
+omitting `action` hides the review form; `children` can supply retained reason
+or duplicate-selection inputs. A server must reauthorize, reload the model and
+invoke `review()`, `reject()`, `markDuplicate()` or `reopen()` under its policy.
+Never assign review fields through UI payload binding. Reviewed money remains
+frozen by the existing model; UI props cannot bypass it.
+
+`receipts` is exactly the public Assets `AttachmentPanelProps`, supporting
+private view/download URLs, version notes, native upload and recovery. It is
+rendered outside the review form so upload and review remain separate native
+actions. Use authorized receipt projections; attaching a file does not review
+an expense, mark a duplicate, or change invoice approval. Assets owns file
+selection and reselect-file help; Expenses does not duplicate uploads/storage.
+
+Validation: `pnpm --filter @happyvertical/smrt-expenses test`, `test:ui`,
+`test:e2e`, `typecheck`, `build`, and `verify:pack`. PostgreSQL model validation
+remains in the existing opt-in `test:postgres` lane; this UI does not alter it.

package/dist/index.js

@@ -17,7 +17,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region src/__smrt-register__.ts
-ObjectRegistry.registerPackageManifest(JSON.parse("{\"version\":\"1.0.0\",\"timestamp\":0,\"packageName\":\"@happyvertical/smrt-expenses\",\"packageVersion\":\"0.53.3\",\"objects\":{\"@happyvertical/smrt-expenses:ExpenseCollection\":{\"name\":\"expensecollection\",\"className\":\"ExpenseCollection\",\"qualifiedName\":\"@happyvertical/smrt-expenses:ExpenseCollection\",\"collection\":\"expenses\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/expenses/src/collections/ExpenseCollection.ts\",\"packageName\":\"@happyvertical/smrt-expenses\",\"fields\":{},\"methods\":{\"forCostObject\":{\"name\":\"forCostObject\",\"async\":true,\"parameters\":[{\"name\":\"costObjectType\",\"type\":\"string\",\"optional\":false},{\"name\":\"costObjectId\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<Expense[]>\",\"isStatic\":false,\"isPublic\":true},\"totalsByCurrency\":{\"name\":\"totalsByCurrency\",\"async\":true,\"parameters\":[{\"name\":\"options\",\"type\":\"ExpenseTotalsOptions\",\"optional\":true}],\"returnType\":\"Promise<CurrencyTotals>\",\"isStatic\":false,\"isPublic\":true},\"commitmentPosition\":{\"name\":\"commitmentPosition\",\"async\":true,\"parameters\":[{\"name\":\"commitmentId\",\"type\":\"string\",\"optional\":false},{\"name\":\"options\",\"type\":\"object\",\"optional\":true,\"memberTypes\":[\"string\"]}],\"returnType\":\"Promise<CommitmentPosition>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"api\":{\"include\":[]},\"mcp\":{\"include\":[]},\"cli\":false,\"tableName\":\"expenses\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"Expense\",\"exportName\":\"ExpenseCollection\",\"collectionExportName\":\"ExpenseCollectionCollection\",\"schema\":{\"tableName\":\"expenses\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"expenses\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID,\\n  \\\"cost_object_type\\\" TEXT,\\n  \\\"cost_object_id\\\" TEXT,\\n  \\\"category\\\" TEXT,\\n  \\\"description\\\" TEXT,\\n  \\\"amount\\\" INTEGER,\\n  \\\"currency\\\" TEXT,\\n  \\\"incurred_on\\\" TEXT,\\n  \\\"recorded_at\\\" TIMESTAMP,\\n  \\\"recorded_by_profile_id\\\" UUID,\\n  \\\"paid_by\\\" TEXT,\\n  \\\"paid_by_profile_id\\\" UUID,\\n  \\\"vendor_id\\\" UUID,\\n  \\\"commitment_id\\\" UUID,\\n  \\\"commitment_line_id\\\" UUID,\\n  \\\"review_status\\\" TEXT,\\n  \\\"reviewed_by_profile_id\\\" UUID,\\n  \\\"reviewed_at\\\" TIMESTAMP,\\n  \\\"review_note\\\" TEXT,\\n  \\\"duplicate_of_id\\\" UUID,\\n  \\\"reimbursable\\\" BOOLEAN,\\n  \\\"reimbursed_at\\\" TIMESTAMP,\\n  \\\"reimbursement_reference\\\" TEXT\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":false,\"unique\":false},\"cost_object_type\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"cost_object_id\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"category\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"description\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"amount\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false},\"currency\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"incurred_on\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"recorded_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"recorded_by_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"paid_by\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"paid_by_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"vendor_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"commitment_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"commitment_line_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"review_status\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"reviewed_by_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"reviewed_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"review_note\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"duplicate_of_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"unique\":false,\"foreignKey\":{\"table\":\"expenses\",\"column\":\"id\",\"onDelete\":\"SET NULL\",\"onUpdate\":\"CASCADE\"}},\"reimbursable\":{\"type\":\"BOOLEAN\",\"notNull\":false,\"unique\":false},\"reimbursed_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"reimbursement_reference\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false}},\"indexes\":[{\"name\":\"expenses_slug_context_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\"],\"unique\":true,\"nullsNotDistinct\":true},{\"name\":\"expenses_cost_object_idx\",\"columns\":[\"tenant_id\",\"cost_object_type\",\"cost_object_id\",\"incurred_on\"]},{\"name\":\"expenses_commitment_review_idx\",\"columns\":[\"tenant_id\",\"commitment_id\",\"review_status\"]},{\"name\":\"expenses_review_status_idx\",\"columns\":[\"tenant_id\",\"review_status\",\"incurred_on\"]},{\"name\":\"expenses_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"expenses_recorded_by_profile_id_idx\",\"columns\":[\"recorded_by_profile_id\"]},{\"name\":\"expenses_paid_by_profile_id_idx\",\"columns\":[\"paid_by_profile_id\"]},{\"name\":\"expenses_vendor_id_idx\",\"columns\":[\"vendor_id\"]},{\"name\":\"expenses_commitment_id_idx\",\"columns\":[\"commitment_id\"]},{\"name\":\"expenses_commitment_line_id_idx\",\"columns\":[\"commitment_line_id\"]},{\"name\":\"expenses_reviewed_by_profile_id_idx\",\"columns\":[\"reviewed_by_profile_id\"]},{\"name\":\"expenses_duplicate_of_id_idx\",\"columns\":[\"duplicate_of_id\"]}],\"version\":\"af101807\"},\"importPath\":\"@happyvertical/smrt-expenses\"},\"@happyvertical/smrt-expenses:ExpenseReceiptCollection\":{\"name\":\"expensereceiptcollection\",\"className\":\"ExpenseReceiptCollection\",\"qualifiedName\":\"@happyvertical/smrt-expenses:ExpenseReceiptCollection\",\"collection\":\"expensereceipts\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/expenses/src/collections/ExpenseReceiptCollection.ts\",\"packageName\":\"@happyvertical/smrt-expenses\",\"fields\":{},\"methods\":{\"byLeft\":{\"name\":\"byLeft\",\"async\":true,\"parameters\":[{\"name\":\"leftId\",\"type\":\"string\",\"optional\":false},{\"name\":\"opts\",\"type\":\"JunctionFilterOptions\",\"optional\":true}],\"returnType\":\"Promise<TItem[]>\",\"isStatic\":false,\"isPublic\":true},\"byRight\":{\"name\":\"byRight\",\"async\":true,\"parameters\":[{\"name\":\"rightId\",\"type\":\"string\",\"optional\":false},{\"name\":\"opts\",\"type\":\"JunctionFilterOptions\",\"optional\":true}],\"returnType\":\"Promise<TItem[]>\",\"isStatic\":false,\"isPublic\":true},\"attach\":{\"name\":\"attach\",\"async\":true,\"parameters\":[{\"name\":\"_expenseId\",\"type\":\"string\",\"optional\":false},{\"name\":\"_assetId\",\"type\":\"string\",\"optional\":false},{\"name\":\"_opts\",\"type\":\"JunctionAttachOptions\",\"optional\":true}],\"returnType\":\"Promise<ExpenseReceipt>\",\"isStatic\":false,\"isPublic\":true},\"detach\":{\"name\":\"detach\",\"async\":true,\"parameters\":[{\"name\":\"leftId\",\"type\":\"string\",\"optional\":false},{\"name\":\"rightId\",\"type\":\"string\",\"optional\":false},{\"name\":\"opts\",\"type\":\"JunctionFilterOptions\",\"optional\":true}],\"returnType\":\"Promise<void>\",\"isStatic\":false,\"isPublic\":true},\"setLinks\":{\"name\":\"setLinks\",\"async\":true,\"parameters\":[{\"name\":\"_expenseId\",\"type\":\"string\",\"optional\":false},{\"name\":\"_assetIds\",\"type\":\"string[]\",\"optional\":false},{\"name\":\"_opts\",\"type\":\"JunctionAttachOptions\",\"optional\":true}],\"returnType\":\"Promise<void>\",\"isStatic\":false,\"isPublic\":true},\"attachReceipt\":{\"name\":\"attachReceipt\",\"async\":true,\"parameters\":[{\"name\":\"input\",\"type\":\"AttachReceiptInput\",\"optional\":false}],\"returnType\":\"Promise<ExpenseReceipt>\",\"isStatic\":false,\"isPublic\":true},\"receiptsFor\":{\"name\":\"receiptsFor\",\"async\":true,\"parameters\":[{\"name\":\"expenseId\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<ExpenseReceipt[]>\",\"isStatic\":false,\"isPublic\":true},\"findDuplicateReceipts\":{\"name\":\"findDuplicateReceipts\",\"async\":true,\"parameters\":[{\"name\":\"options\",\"type\":\"FindDuplicateReceiptsOptions\",\"optional\":true}],\"returnType\":\"Promise<DuplicateReceiptGroup[]>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"api\":{\"include\":[]},\"mcp\":{\"include\":[]},\"cli\":false,\"tableName\":\"expense_receipts\"},\"extends\":\"SmrtJunction\",\"extendsTypeArg\":\"ExpenseReceipt\",\"exportName\":\"ExpenseReceiptCollection\",\"collectionExportName\":\"ExpenseReceiptCollectionCollection\",\"schema\":{\"tableName\":\"expense_receipts\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"expense_receipts\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID,\\n  \\\"expense_id\\\" UUID NOT NULL,\\n  \\\"asset_id\\\" UUID NOT NULL,\\n  \\\"uploaded_by_profile_id\\\" UUID,\\n  \\\"filename\\\" TEXT,\\n  \\\"mime_type\\\" TEXT,\\n  \\\"byte_count\\\" INTEGER,\\n  \\\"content_sha256\\\" TEXT NOT NULL\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":false,\"unique\":false},\"expense_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":true,\"unique\":false,\"foreignKey\":{\"table\":\"expenses\",\"column\":\"id\",\"onDelete\":\"CASCADE\",\"onUpdate\":\"CASCADE\"}},\"asset_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":true,\"unique\":false},\"uploaded_by_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"filename\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"mime_type\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"byte_count\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false},\"content_sha256\":{\"type\":\"TEXT\",\"notNull\":true,\"unique\":false}},\"indexes\":[{\"name\":\"expense_receipts_slug_context_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\"],\"unique\":true,\"nullsNotDistinct\":true},{\"name\":\"expense_receipts_expense_sha256_key\",\"columns\":[\"expense_id\",\"content_sha256\"],\"unique\":true},{\"name\":\"expense_receipts_tenant_sha256_idx\",\"columns\":[\"tenant_id\",\"content_sha256\"]},{\"name\":\"expense_receipts_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"expense_receipts_asset_id_idx\",\"columns\":[\"asset_id\"]},{\"name\":\"expense_receipts_uploaded_by_profile_id_idx\",\"columns\":[\"uploaded_by_profile_id\"]}],\"version\":\"5aa77571\"},\"importPath\":\"@happyvertical/smrt-expenses\"},\"@happyvertical/smrt-expenses:Expense\":{\"name\":\"expense\",\"className\":\"Expense\",\"qualifiedName\":\"@happyvertical/smrt-expenses:Expense\",\"collection\":\"expenses\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/expenses/src/models/Expense.ts\",\"packageName\":\"@happyvertical/smrt-expenses\",\"fields\":{\"tenantId\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"sqlType\":\"UUID\",\"nullable\":true,\"__tenancy\":{\"isTenantIdField\":true,\"autoFilter\":true,\"required\":false,\"autoPopulate\":true,\"nullable\":true,\"mode\":\"optional\",\"field\":\"tenantId\",\"allowSuperAdminBypass\":false}}},\"costObjectType\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"costObjectId\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"category\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"description\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"amount\":{\"type\":\"integer\",\"required\":false,\"_meta\":{}},\"currency\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"incurredOn\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"recordedAt\":{\"type\":\"datetime\",\"required\":false},\"recordedByProfileId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"PROFILE\"},\"paidBy\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"paidByProfileId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"PROFILE\"},\"vendorId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-commerce:Vendor\"},\"commitmentId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-commerce:Contract\"},\"commitmentLineId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-commerce:ContractLineItem\"},\"reviewStatus\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"readonly\":true},\"readonly\":true},\"reviewedByProfileId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"PROFILE\"},\"reviewedAt\":{\"type\":\"datetime\",\"required\":false,\"_meta\":{\"readonly\":true},\"readonly\":true},\"reviewNote\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"readonly\":true},\"readonly\":true},\"duplicateOfId\":{\"type\":\"foreignKey\",\"required\":false,\"related\":\"Expense\",\"_meta\":{\"onDelete\":\"SET NULL\"}},\"reimbursable\":{\"type\":\"boolean\",\"required\":false,\"_meta\":{}},\"reimbursedAt\":{\"type\":\"datetime\",\"required\":false},\"reimbursementReference\":{\"type\":\"text\",\"required\":false,\"_meta\":{}}},\"methods\":{\"isReimbursed\":{\"name\":\"isReimbursed\",\"async\":false,\"parameters\":[],\"returnType\":\"boolean\",\"isStatic\":false,\"isPublic\":true},\"isCountable\":{\"name\":\"isCountable\",\"async\":false,\"parameters\":[],\"returnType\":\"boolean\",\"isStatic\":false,\"isPublic\":true},\"review\":{\"name\":\"review\",\"async\":true,\"parameters\":[{\"name\":\"input\",\"type\":\"ReviewExpenseInput\",\"optional\":false}],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true},\"reject\":{\"name\":\"reject\",\"async\":true,\"parameters\":[{\"name\":\"input\",\"type\":\"RejectExpenseInput\",\"optional\":false}],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true},\"markDuplicate\":{\"name\":\"markDuplicate\",\"async\":true,\"parameters\":[{\"name\":\"input\",\"type\":\"MarkDuplicateExpenseInput\",\"optional\":false}],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true},\"reopen\":{\"name\":\"reopen\",\"async\":true,\"parameters\":[{\"name\":\"input\",\"type\":\"ReopenExpenseInput\",\"optional\":false}],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true},\"markReimbursed\":{\"name\":\"markReimbursed\",\"async\":true,\"parameters\":[{\"name\":\"input\",\"type\":\"MarkReimbursedInput\",\"optional\":true}],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true},\"getCostObject\":{\"name\":\"getCostObject\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<T | null>\",\"isStatic\":false,\"isPublic\":true},\"save\":{\"name\":\"save\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"expenses\",\"api\":{\"include\":[]},\"mcp\":{\"include\":[]},\"cli\":false,\"indexes\":[{\"name\":\"expenses_cost_object_idx\",\"columns\":[\"tenantId\",\"costObjectType\",\"costObjectId\",\"incurredOn\"]},{\"name\":\"expenses_commitment_review_idx\",\"columns\":[\"tenantId\",\"commitmentId\",\"reviewStatus\"]},{\"name\":\"expenses_review_status_idx\",\"columns\":[\"tenantId\",\"reviewStatus\",\"incurredOn\"]}],\"tenantScoped\":{\"mode\":\"optional\"},\"conflictColumns\":[\"tenant_id\",\"slug\",\"context\"]},\"extends\":\"SmrtObject\",\"exportName\":\"Expense\",\"collectionExportName\":\"ExpenseCollection\",\"schema\":{\"tableName\":\"expenses\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"expenses\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID,\\n  \\\"cost_object_type\\\" TEXT,\\n  \\\"cost_object_id\\\" TEXT,\\n  \\\"category\\\" TEXT,\\n  \\\"description\\\" TEXT,\\n  \\\"amount\\\" INTEGER,\\n  \\\"currency\\\" TEXT,\\n  \\\"incurred_on\\\" TEXT,\\n  \\\"recorded_at\\\" TIMESTAMP,\\n  \\\"recorded_by_profile_id\\\" UUID,\\n  \\\"paid_by\\\" TEXT,\\n  \\\"paid_by_profile_id\\\" UUID,\\n  \\\"vendor_id\\\" UUID,\\n  \\\"commitment_id\\\" UUID,\\n  \\\"commitment_line_id\\\" UUID,\\n  \\\"review_status\\\" TEXT,\\n  \\\"reviewed_by_profile_id\\\" UUID,\\n  \\\"reviewed_at\\\" TIMESTAMP,\\n  \\\"review_note\\\" TEXT,\\n  \\\"duplicate_of_id\\\" UUID,\\n  \\\"reimbursable\\\" BOOLEAN,\\n  \\\"reimbursed_at\\\" TIMESTAMP,\\n  \\\"reimbursement_reference\\\" TEXT\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":false,\"unique\":false},\"cost_object_type\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"cost_object_id\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"category\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"description\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"amount\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false},\"currency\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"incurred_on\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"recorded_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"recorded_by_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"paid_by\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"paid_by_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"vendor_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"commitment_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"commitment_line_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"review_status\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"reviewed_by_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"reviewed_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"review_note\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"duplicate_of_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"unique\":false,\"foreignKey\":{\"table\":\"expenses\",\"column\":\"id\",\"onDelete\":\"SET NULL\",\"onUpdate\":\"CASCADE\"}},\"reimbursable\":{\"type\":\"BOOLEAN\",\"notNull\":false,\"unique\":false},\"reimbursed_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"reimbursement_reference\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false}},\"indexes\":[{\"name\":\"expenses_slug_context_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\"],\"unique\":true,\"nullsNotDistinct\":true},{\"name\":\"expenses_cost_object_idx\",\"columns\":[\"tenant_id\",\"cost_object_type\",\"cost_object_id\",\"incurred_on\"]},{\"name\":\"expenses_commitment_review_idx\",\"columns\":[\"tenant_id\",\"commitment_id\",\"review_status\"]},{\"name\":\"expenses_review_status_idx\",\"columns\":[\"tenant_id\",\"review_status\",\"incurred_on\"]},{\"name\":\"expenses_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"expenses_recorded_by_profile_id_idx\",\"columns\":[\"recorded_by_profile_id\"]},{\"name\":\"expenses_paid_by_profile_id_idx\",\"columns\":[\"paid_by_profile_id\"]},{\"name\":\"expenses_vendor_id_idx\",\"columns\":[\"vendor_id\"]},{\"name\":\"expenses_commitment_id_idx\",\"columns\":[\"commitment_id\"]},{\"name\":\"expenses_commitment_line_id_idx\",\"columns\":[\"commitment_line_id\"]},{\"name\":\"expenses_reviewed_by_profile_id_idx\",\"columns\":[\"reviewed_by_profile_id\"]},{\"name\":\"expenses_duplicate_of_id_idx\",\"columns\":[\"duplicate_of_id\"]}],\"version\":\"af101807\"},\"importPath\":\"@happyvertical/smrt-expenses\"},\"@happyvertical/smrt-expenses:ExpenseReceipt\":{\"name\":\"expensereceipt\",\"className\":\"ExpenseReceipt\",\"qualifiedName\":\"@happyvertical/smrt-expenses:ExpenseReceipt\",\"collection\":\"expensereceipts\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/expenses/src/models/ExpenseReceipt.ts\",\"packageName\":\"@happyvertical/smrt-expenses\",\"fields\":{\"tenantId\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"sqlType\":\"UUID\",\"nullable\":true,\"__tenancy\":{\"isTenantIdField\":true,\"autoFilter\":true,\"required\":false,\"autoPopulate\":true,\"nullable\":true,\"mode\":\"optional\",\"field\":\"tenantId\",\"allowSuperAdminBypass\":false}}},\"expenseId\":{\"type\":\"foreignKey\",\"required\":true,\"related\":\"Expense\",\"_meta\":{\"required\":true,\"onDelete\":\"CASCADE\"}},\"assetId\":{\"type\":\"crossPackageRef\",\"required\":true,\"related\":\"@happyvertical/smrt-assets:Asset\"},\"uploadedByProfileId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-profiles:Profile\"},\"filename\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"mimeType\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"byteCount\":{\"type\":\"integer\",\"required\":false,\"_meta\":{}},\"contentSha256\":{\"type\":\"text\",\"required\":true,\"_meta\":{\"required\":true}}},\"methods\":{\"save\":{\"name\":\"save\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"expense_receipts\",\"api\":{\"include\":[]},\"mcp\":{\"include\":[]},\"cli\":false,\"indexes\":[{\"name\":\"expense_receipts_expense_sha256_key\",\"columns\":[\"expenseId\",\"contentSha256\"],\"unique\":true},{\"name\":\"expense_receipts_tenant_sha256_idx\",\"columns\":[\"tenantId\",\"contentSha256\"]}],\"tenantScoped\":{\"mode\":\"optional\"},\"conflictColumns\":[\"tenant_id\",\"slug\",\"context\"]},\"extends\":\"SmrtObject\",\"exportName\":\"ExpenseReceipt\",\"collectionExportName\":\"ExpenseReceiptCollection\",\"validationRules\":[{\"field\":\"expenseId\",\"rule\":\"required\",\"fieldType\":\"foreignKey\"},{\"field\":\"assetId\",\"rule\":\"required\",\"fieldType\":\"crossPackageRef\"},{\"field\":\"contentSha256\",\"rule\":\"required\",\"fieldType\":\"text\"}],\"schema\":{\"tableName\":\"expense_receipts\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"expense_receipts\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID,\\n  \\\"expense_id\\\" UUID NOT NULL,\\n  \\\"asset_id\\\" UUID NOT NULL,\\n  \\\"uploaded_by_profile_id\\\" UUID,\\n  \\\"filename\\\" TEXT,\\n  \\\"mime_type\\\" TEXT,\\n  \\\"byte_count\\\" INTEGER,\\n  \\\"content_sha256\\\" TEXT NOT NULL\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":false,\"unique\":false},\"expense_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":true,\"unique\":false,\"foreignKey\":{\"table\":\"expenses\",\"column\":\"id\",\"onDelete\":\"CASCADE\",\"onUpdate\":\"CASCADE\"}},\"asset_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":true,\"unique\":false},\"uploaded_by_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"filename\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"mime_type\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"byte_count\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false},\"content_sha256\":{\"type\":\"TEXT\",\"notNull\":true,\"unique\":false}},\"indexes\":[{\"name\":\"expense_receipts_slug_context_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\"],\"unique\":true,\"nullsNotDistinct\":true},{\"name\":\"expense_receipts_expense_sha256_key\",\"columns\":[\"expense_id\",\"content_sha256\"],\"unique\":true},{\"name\":\"expense_receipts_tenant_sha256_idx\",\"columns\":[\"tenant_id\",\"content_sha256\"]},{\"name\":\"expense_receipts_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"expense_receipts_asset_id_idx\",\"columns\":[\"asset_id\"]},{\"name\":\"expense_receipts_uploaded_by_profile_id_idx\",\"columns\":[\"uploaded_by_profile_id\"]}],\"version\":\"5aa77571\"},\"importPath\":\"@happyvertical/smrt-expenses\"}},\"moduleType\":\"smrt\",\"smrtDependencies\":[\"@happyvertical/smrt-assets\",\"@happyvertical/smrt-commerce\",\"@happyvertical/smrt-core\",\"@happyvertical/smrt-tenancy\"]}"));
+ObjectRegistry.registerPackageManifest(JSON.parse("{\"version\":\"1.0.0\",\"timestamp\":0,\"packageName\":\"@happyvertical/smrt-expenses\",\"packageVersion\":\"0.53.5\",\"objects\":{\"@happyvertical/smrt-expenses:ExpenseCollection\":{\"name\":\"expensecollection\",\"className\":\"ExpenseCollection\",\"qualifiedName\":\"@happyvertical/smrt-expenses:ExpenseCollection\",\"collection\":\"expenses\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/expenses/src/collections/ExpenseCollection.ts\",\"packageName\":\"@happyvertical/smrt-expenses\",\"fields\":{},\"methods\":{\"forCostObject\":{\"name\":\"forCostObject\",\"async\":true,\"parameters\":[{\"name\":\"costObjectType\",\"type\":\"string\",\"optional\":false},{\"name\":\"costObjectId\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<Expense[]>\",\"isStatic\":false,\"isPublic\":true},\"totalsByCurrency\":{\"name\":\"totalsByCurrency\",\"async\":true,\"parameters\":[{\"name\":\"options\",\"type\":\"ExpenseTotalsOptions\",\"optional\":true}],\"returnType\":\"Promise<CurrencyTotals>\",\"isStatic\":false,\"isPublic\":true},\"commitmentPosition\":{\"name\":\"commitmentPosition\",\"async\":true,\"parameters\":[{\"name\":\"commitmentId\",\"type\":\"string\",\"optional\":false},{\"name\":\"options\",\"type\":\"object\",\"optional\":true,\"memberTypes\":[\"string\"]}],\"returnType\":\"Promise<CommitmentPosition>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"api\":{\"include\":[]},\"mcp\":{\"include\":[]},\"cli\":false,\"tableName\":\"expenses\"},\"extends\":\"SmrtCollection\",\"extendsTypeArg\":\"Expense\",\"exportName\":\"ExpenseCollection\",\"collectionExportName\":\"ExpenseCollectionCollection\",\"schema\":{\"tableName\":\"expenses\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"expenses\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID,\\n  \\\"cost_object_type\\\" TEXT,\\n  \\\"cost_object_id\\\" TEXT,\\n  \\\"category\\\" TEXT,\\n  \\\"description\\\" TEXT,\\n  \\\"amount\\\" INTEGER,\\n  \\\"currency\\\" TEXT,\\n  \\\"incurred_on\\\" TEXT,\\n  \\\"recorded_at\\\" TIMESTAMP,\\n  \\\"recorded_by_profile_id\\\" UUID,\\n  \\\"paid_by\\\" TEXT,\\n  \\\"paid_by_profile_id\\\" UUID,\\n  \\\"vendor_id\\\" UUID,\\n  \\\"commitment_id\\\" UUID,\\n  \\\"commitment_line_id\\\" UUID,\\n  \\\"review_status\\\" TEXT,\\n  \\\"reviewed_by_profile_id\\\" UUID,\\n  \\\"reviewed_at\\\" TIMESTAMP,\\n  \\\"review_note\\\" TEXT,\\n  \\\"duplicate_of_id\\\" UUID,\\n  \\\"reimbursable\\\" BOOLEAN,\\n  \\\"reimbursed_at\\\" TIMESTAMP,\\n  \\\"reimbursement_reference\\\" TEXT\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":false,\"unique\":false},\"cost_object_type\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"cost_object_id\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"category\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"description\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"amount\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false},\"currency\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"incurred_on\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"recorded_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"recorded_by_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"paid_by\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"paid_by_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"vendor_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"commitment_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"commitment_line_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"review_status\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"reviewed_by_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"reviewed_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"review_note\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"duplicate_of_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"unique\":false,\"foreignKey\":{\"table\":\"expenses\",\"column\":\"id\",\"onDelete\":\"SET NULL\",\"onUpdate\":\"CASCADE\"}},\"reimbursable\":{\"type\":\"BOOLEAN\",\"notNull\":false,\"unique\":false},\"reimbursed_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"reimbursement_reference\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false}},\"indexes\":[{\"name\":\"expenses_slug_context_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\"],\"unique\":true,\"nullsNotDistinct\":true},{\"name\":\"expenses_cost_object_idx\",\"columns\":[\"tenant_id\",\"cost_object_type\",\"cost_object_id\",\"incurred_on\"]},{\"name\":\"expenses_commitment_review_idx\",\"columns\":[\"tenant_id\",\"commitment_id\",\"review_status\"]},{\"name\":\"expenses_review_status_idx\",\"columns\":[\"tenant_id\",\"review_status\",\"incurred_on\"]},{\"name\":\"expenses_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"expenses_recorded_by_profile_id_idx\",\"columns\":[\"recorded_by_profile_id\"]},{\"name\":\"expenses_paid_by_profile_id_idx\",\"columns\":[\"paid_by_profile_id\"]},{\"name\":\"expenses_vendor_id_idx\",\"columns\":[\"vendor_id\"]},{\"name\":\"expenses_commitment_id_idx\",\"columns\":[\"commitment_id\"]},{\"name\":\"expenses_commitment_line_id_idx\",\"columns\":[\"commitment_line_id\"]},{\"name\":\"expenses_reviewed_by_profile_id_idx\",\"columns\":[\"reviewed_by_profile_id\"]},{\"name\":\"expenses_duplicate_of_id_idx\",\"columns\":[\"duplicate_of_id\"]}],\"version\":\"af101807\"},\"importPath\":\"@happyvertical/smrt-expenses\"},\"@happyvertical/smrt-expenses:ExpenseReceiptCollection\":{\"name\":\"expensereceiptcollection\",\"className\":\"ExpenseReceiptCollection\",\"qualifiedName\":\"@happyvertical/smrt-expenses:ExpenseReceiptCollection\",\"collection\":\"expensereceipts\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/expenses/src/collections/ExpenseReceiptCollection.ts\",\"packageName\":\"@happyvertical/smrt-expenses\",\"fields\":{},\"methods\":{\"byLeft\":{\"name\":\"byLeft\",\"async\":true,\"parameters\":[{\"name\":\"leftId\",\"type\":\"string\",\"optional\":false},{\"name\":\"opts\",\"type\":\"JunctionFilterOptions\",\"optional\":true}],\"returnType\":\"Promise<TItem[]>\",\"isStatic\":false,\"isPublic\":true},\"byRight\":{\"name\":\"byRight\",\"async\":true,\"parameters\":[{\"name\":\"rightId\",\"type\":\"string\",\"optional\":false},{\"name\":\"opts\",\"type\":\"JunctionFilterOptions\",\"optional\":true}],\"returnType\":\"Promise<TItem[]>\",\"isStatic\":false,\"isPublic\":true},\"attach\":{\"name\":\"attach\",\"async\":true,\"parameters\":[{\"name\":\"_expenseId\",\"type\":\"string\",\"optional\":false},{\"name\":\"_assetId\",\"type\":\"string\",\"optional\":false},{\"name\":\"_opts\",\"type\":\"JunctionAttachOptions\",\"optional\":true}],\"returnType\":\"Promise<ExpenseReceipt>\",\"isStatic\":false,\"isPublic\":true},\"detach\":{\"name\":\"detach\",\"async\":true,\"parameters\":[{\"name\":\"leftId\",\"type\":\"string\",\"optional\":false},{\"name\":\"rightId\",\"type\":\"string\",\"optional\":false},{\"name\":\"opts\",\"type\":\"JunctionFilterOptions\",\"optional\":true}],\"returnType\":\"Promise<void>\",\"isStatic\":false,\"isPublic\":true},\"setLinks\":{\"name\":\"setLinks\",\"async\":true,\"parameters\":[{\"name\":\"_expenseId\",\"type\":\"string\",\"optional\":false},{\"name\":\"_assetIds\",\"type\":\"string[]\",\"optional\":false},{\"name\":\"_opts\",\"type\":\"JunctionAttachOptions\",\"optional\":true}],\"returnType\":\"Promise<void>\",\"isStatic\":false,\"isPublic\":true},\"attachReceipt\":{\"name\":\"attachReceipt\",\"async\":true,\"parameters\":[{\"name\":\"input\",\"type\":\"AttachReceiptInput\",\"optional\":false}],\"returnType\":\"Promise<ExpenseReceipt>\",\"isStatic\":false,\"isPublic\":true},\"receiptsFor\":{\"name\":\"receiptsFor\",\"async\":true,\"parameters\":[{\"name\":\"expenseId\",\"type\":\"string\",\"optional\":false}],\"returnType\":\"Promise<ExpenseReceipt[]>\",\"isStatic\":false,\"isPublic\":true},\"findDuplicateReceipts\":{\"name\":\"findDuplicateReceipts\",\"async\":true,\"parameters\":[{\"name\":\"options\",\"type\":\"FindDuplicateReceiptsOptions\",\"optional\":true}],\"returnType\":\"Promise<DuplicateReceiptGroup[]>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"api\":{\"include\":[]},\"mcp\":{\"include\":[]},\"cli\":false,\"tableName\":\"expense_receipts\"},\"extends\":\"SmrtJunction\",\"extendsTypeArg\":\"ExpenseReceipt\",\"exportName\":\"ExpenseReceiptCollection\",\"collectionExportName\":\"ExpenseReceiptCollectionCollection\",\"schema\":{\"tableName\":\"expense_receipts\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"expense_receipts\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID,\\n  \\\"expense_id\\\" UUID NOT NULL,\\n  \\\"asset_id\\\" UUID NOT NULL,\\n  \\\"uploaded_by_profile_id\\\" UUID,\\n  \\\"filename\\\" TEXT,\\n  \\\"mime_type\\\" TEXT,\\n  \\\"byte_count\\\" INTEGER,\\n  \\\"content_sha256\\\" TEXT NOT NULL\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":false,\"unique\":false},\"expense_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":true,\"unique\":false,\"foreignKey\":{\"table\":\"expenses\",\"column\":\"id\",\"onDelete\":\"CASCADE\",\"onUpdate\":\"CASCADE\"}},\"asset_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":true,\"unique\":false},\"uploaded_by_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"filename\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"mime_type\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"byte_count\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false},\"content_sha256\":{\"type\":\"TEXT\",\"notNull\":true,\"unique\":false}},\"indexes\":[{\"name\":\"expense_receipts_slug_context_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\"],\"unique\":true,\"nullsNotDistinct\":true},{\"name\":\"expense_receipts_expense_sha256_key\",\"columns\":[\"expense_id\",\"content_sha256\"],\"unique\":true},{\"name\":\"expense_receipts_tenant_sha256_idx\",\"columns\":[\"tenant_id\",\"content_sha256\"]},{\"name\":\"expense_receipts_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"expense_receipts_asset_id_idx\",\"columns\":[\"asset_id\"]},{\"name\":\"expense_receipts_uploaded_by_profile_id_idx\",\"columns\":[\"uploaded_by_profile_id\"]}],\"version\":\"5aa77571\"},\"importPath\":\"@happyvertical/smrt-expenses\"},\"@happyvertical/smrt-expenses:Expense\":{\"name\":\"expense\",\"className\":\"Expense\",\"qualifiedName\":\"@happyvertical/smrt-expenses:Expense\",\"collection\":\"expenses\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/expenses/src/models/Expense.ts\",\"packageName\":\"@happyvertical/smrt-expenses\",\"fields\":{\"tenantId\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"sqlType\":\"UUID\",\"nullable\":true,\"__tenancy\":{\"isTenantIdField\":true,\"autoFilter\":true,\"required\":false,\"autoPopulate\":true,\"nullable\":true,\"mode\":\"optional\",\"field\":\"tenantId\",\"allowSuperAdminBypass\":false}}},\"costObjectType\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"costObjectId\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"category\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"description\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"amount\":{\"type\":\"integer\",\"required\":false,\"_meta\":{}},\"currency\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"incurredOn\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"recordedAt\":{\"type\":\"datetime\",\"required\":false},\"recordedByProfileId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"PROFILE\"},\"paidBy\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"paidByProfileId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"PROFILE\"},\"vendorId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-commerce:Vendor\"},\"commitmentId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-commerce:Contract\"},\"commitmentLineId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-commerce:ContractLineItem\"},\"reviewStatus\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"readonly\":true},\"readonly\":true},\"reviewedByProfileId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"PROFILE\"},\"reviewedAt\":{\"type\":\"datetime\",\"required\":false,\"_meta\":{\"readonly\":true},\"readonly\":true},\"reviewNote\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"readonly\":true},\"readonly\":true},\"duplicateOfId\":{\"type\":\"foreignKey\",\"required\":false,\"related\":\"Expense\",\"_meta\":{\"onDelete\":\"SET NULL\"}},\"reimbursable\":{\"type\":\"boolean\",\"required\":false,\"_meta\":{}},\"reimbursedAt\":{\"type\":\"datetime\",\"required\":false},\"reimbursementReference\":{\"type\":\"text\",\"required\":false,\"_meta\":{}}},\"methods\":{\"isReimbursed\":{\"name\":\"isReimbursed\",\"async\":false,\"parameters\":[],\"returnType\":\"boolean\",\"isStatic\":false,\"isPublic\":true},\"isCountable\":{\"name\":\"isCountable\",\"async\":false,\"parameters\":[],\"returnType\":\"boolean\",\"isStatic\":false,\"isPublic\":true},\"review\":{\"name\":\"review\",\"async\":true,\"parameters\":[{\"name\":\"input\",\"type\":\"ReviewExpenseInput\",\"optional\":false}],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true},\"reject\":{\"name\":\"reject\",\"async\":true,\"parameters\":[{\"name\":\"input\",\"type\":\"RejectExpenseInput\",\"optional\":false}],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true},\"markDuplicate\":{\"name\":\"markDuplicate\",\"async\":true,\"parameters\":[{\"name\":\"input\",\"type\":\"MarkDuplicateExpenseInput\",\"optional\":false}],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true},\"reopen\":{\"name\":\"reopen\",\"async\":true,\"parameters\":[{\"name\":\"input\",\"type\":\"ReopenExpenseInput\",\"optional\":false}],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true},\"markReimbursed\":{\"name\":\"markReimbursed\",\"async\":true,\"parameters\":[{\"name\":\"input\",\"type\":\"MarkReimbursedInput\",\"optional\":true}],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true},\"getCostObject\":{\"name\":\"getCostObject\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<T | null>\",\"isStatic\":false,\"isPublic\":true},\"save\":{\"name\":\"save\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"expenses\",\"api\":{\"include\":[]},\"mcp\":{\"include\":[]},\"cli\":false,\"indexes\":[{\"name\":\"expenses_cost_object_idx\",\"columns\":[\"tenantId\",\"costObjectType\",\"costObjectId\",\"incurredOn\"]},{\"name\":\"expenses_commitment_review_idx\",\"columns\":[\"tenantId\",\"commitmentId\",\"reviewStatus\"]},{\"name\":\"expenses_review_status_idx\",\"columns\":[\"tenantId\",\"reviewStatus\",\"incurredOn\"]}],\"tenantScoped\":{\"mode\":\"optional\"},\"conflictColumns\":[\"tenant_id\",\"slug\",\"context\"]},\"extends\":\"SmrtObject\",\"exportName\":\"Expense\",\"collectionExportName\":\"ExpenseCollection\",\"schema\":{\"tableName\":\"expenses\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"expenses\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID,\\n  \\\"cost_object_type\\\" TEXT,\\n  \\\"cost_object_id\\\" TEXT,\\n  \\\"category\\\" TEXT,\\n  \\\"description\\\" TEXT,\\n  \\\"amount\\\" INTEGER,\\n  \\\"currency\\\" TEXT,\\n  \\\"incurred_on\\\" TEXT,\\n  \\\"recorded_at\\\" TIMESTAMP,\\n  \\\"recorded_by_profile_id\\\" UUID,\\n  \\\"paid_by\\\" TEXT,\\n  \\\"paid_by_profile_id\\\" UUID,\\n  \\\"vendor_id\\\" UUID,\\n  \\\"commitment_id\\\" UUID,\\n  \\\"commitment_line_id\\\" UUID,\\n  \\\"review_status\\\" TEXT,\\n  \\\"reviewed_by_profile_id\\\" UUID,\\n  \\\"reviewed_at\\\" TIMESTAMP,\\n  \\\"review_note\\\" TEXT,\\n  \\\"duplicate_of_id\\\" UUID,\\n  \\\"reimbursable\\\" BOOLEAN,\\n  \\\"reimbursed_at\\\" TIMESTAMP,\\n  \\\"reimbursement_reference\\\" TEXT\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":false,\"unique\":false},\"cost_object_type\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"cost_object_id\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"category\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"description\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"amount\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false},\"currency\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"incurred_on\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"recorded_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"recorded_by_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"paid_by\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"paid_by_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"vendor_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"commitment_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"commitment_line_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"review_status\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"reviewed_by_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"reviewed_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"review_note\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"duplicate_of_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":false,\"unique\":false,\"foreignKey\":{\"table\":\"expenses\",\"column\":\"id\",\"onDelete\":\"SET NULL\",\"onUpdate\":\"CASCADE\"}},\"reimbursable\":{\"type\":\"BOOLEAN\",\"notNull\":false,\"unique\":false},\"reimbursed_at\":{\"type\":\"TIMESTAMP\",\"notNull\":false,\"unique\":false},\"reimbursement_reference\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false}},\"indexes\":[{\"name\":\"expenses_slug_context_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\"],\"unique\":true,\"nullsNotDistinct\":true},{\"name\":\"expenses_cost_object_idx\",\"columns\":[\"tenant_id\",\"cost_object_type\",\"cost_object_id\",\"incurred_on\"]},{\"name\":\"expenses_commitment_review_idx\",\"columns\":[\"tenant_id\",\"commitment_id\",\"review_status\"]},{\"name\":\"expenses_review_status_idx\",\"columns\":[\"tenant_id\",\"review_status\",\"incurred_on\"]},{\"name\":\"expenses_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"expenses_recorded_by_profile_id_idx\",\"columns\":[\"recorded_by_profile_id\"]},{\"name\":\"expenses_paid_by_profile_id_idx\",\"columns\":[\"paid_by_profile_id\"]},{\"name\":\"expenses_vendor_id_idx\",\"columns\":[\"vendor_id\"]},{\"name\":\"expenses_commitment_id_idx\",\"columns\":[\"commitment_id\"]},{\"name\":\"expenses_commitment_line_id_idx\",\"columns\":[\"commitment_line_id\"]},{\"name\":\"expenses_reviewed_by_profile_id_idx\",\"columns\":[\"reviewed_by_profile_id\"]},{\"name\":\"expenses_duplicate_of_id_idx\",\"columns\":[\"duplicate_of_id\"]}],\"version\":\"af101807\"},\"importPath\":\"@happyvertical/smrt-expenses\"},\"@happyvertical/smrt-expenses:ExpenseReceipt\":{\"name\":\"expensereceipt\",\"className\":\"ExpenseReceipt\",\"qualifiedName\":\"@happyvertical/smrt-expenses:ExpenseReceipt\",\"collection\":\"expensereceipts\",\"filePath\":\"/home/runner/work/smrt/smrt/packages/expenses/src/models/ExpenseReceipt.ts\",\"packageName\":\"@happyvertical/smrt-expenses\",\"fields\":{\"tenantId\":{\"type\":\"text\",\"required\":false,\"_meta\":{\"sqlType\":\"UUID\",\"nullable\":true,\"__tenancy\":{\"isTenantIdField\":true,\"autoFilter\":true,\"required\":false,\"autoPopulate\":true,\"nullable\":true,\"mode\":\"optional\",\"field\":\"tenantId\",\"allowSuperAdminBypass\":false}}},\"expenseId\":{\"type\":\"foreignKey\",\"required\":true,\"related\":\"Expense\",\"_meta\":{\"required\":true,\"onDelete\":\"CASCADE\"}},\"assetId\":{\"type\":\"crossPackageRef\",\"required\":true,\"related\":\"@happyvertical/smrt-assets:Asset\"},\"uploadedByProfileId\":{\"type\":\"crossPackageRef\",\"required\":false,\"related\":\"@happyvertical/smrt-profiles:Profile\"},\"filename\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"mimeType\":{\"type\":\"text\",\"required\":false,\"_meta\":{}},\"byteCount\":{\"type\":\"integer\",\"required\":false,\"_meta\":{}},\"contentSha256\":{\"type\":\"text\",\"required\":true,\"_meta\":{\"required\":true}}},\"methods\":{\"save\":{\"name\":\"save\",\"async\":true,\"parameters\":[],\"returnType\":\"Promise<this>\",\"isStatic\":false,\"isPublic\":true}},\"decoratorConfig\":{\"tableName\":\"expense_receipts\",\"api\":{\"include\":[]},\"mcp\":{\"include\":[]},\"cli\":false,\"indexes\":[{\"name\":\"expense_receipts_expense_sha256_key\",\"columns\":[\"expenseId\",\"contentSha256\"],\"unique\":true},{\"name\":\"expense_receipts_tenant_sha256_idx\",\"columns\":[\"tenantId\",\"contentSha256\"]}],\"tenantScoped\":{\"mode\":\"optional\"},\"conflictColumns\":[\"tenant_id\",\"slug\",\"context\"]},\"extends\":\"SmrtObject\",\"exportName\":\"ExpenseReceipt\",\"collectionExportName\":\"ExpenseReceiptCollection\",\"validationRules\":[{\"field\":\"expenseId\",\"rule\":\"required\",\"fieldType\":\"foreignKey\"},{\"field\":\"assetId\",\"rule\":\"required\",\"fieldType\":\"crossPackageRef\"},{\"field\":\"contentSha256\",\"rule\":\"required\",\"fieldType\":\"text\"}],\"schema\":{\"tableName\":\"expense_receipts\",\"ddl\":\"CREATE TABLE IF NOT EXISTS \\\"expense_receipts\\\" (\\n  \\\"id\\\" UUID PRIMARY KEY NOT NULL,\\n  \\\"slug\\\" TEXT NOT NULL,\\n  \\\"context\\\" TEXT NOT NULL DEFAULT '',\\n  \\\"created_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"updated_at\\\" TIMESTAMP NOT NULL DEFAULT current_timestamp,\\n  \\\"tenant_id\\\" UUID,\\n  \\\"expense_id\\\" UUID NOT NULL,\\n  \\\"asset_id\\\" UUID NOT NULL,\\n  \\\"uploaded_by_profile_id\\\" UUID,\\n  \\\"filename\\\" TEXT,\\n  \\\"mime_type\\\" TEXT,\\n  \\\"byte_count\\\" INTEGER,\\n  \\\"content_sha256\\\" TEXT NOT NULL\\n);\",\"columns\":{\"id\":{\"type\":\"UUID\",\"primaryKey\":true,\"referenceKind\":\"id\",\"notNull\":true},\"slug\":{\"type\":\"TEXT\",\"notNull\":true},\"context\":{\"type\":\"TEXT\",\"notNull\":true,\"default\":\"\"},\"created_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"updated_at\":{\"type\":\"TIMESTAMP\",\"notNull\":true,\"default\":\"current_timestamp\"},\"tenant_id\":{\"type\":\"UUID\",\"referenceKind\":\"tenantId\",\"notNull\":false,\"unique\":false},\"expense_id\":{\"type\":\"UUID\",\"referenceKind\":\"foreignKey\",\"notNull\":true,\"unique\":false,\"foreignKey\":{\"table\":\"expenses\",\"column\":\"id\",\"onDelete\":\"CASCADE\",\"onUpdate\":\"CASCADE\"}},\"asset_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":true,\"unique\":false},\"uploaded_by_profile_id\":{\"type\":\"UUID\",\"referenceKind\":\"crossPackageRef\",\"notNull\":false,\"unique\":false},\"filename\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"mime_type\":{\"type\":\"TEXT\",\"notNull\":false,\"unique\":false},\"byte_count\":{\"type\":\"INTEGER\",\"notNull\":false,\"unique\":false},\"content_sha256\":{\"type\":\"TEXT\",\"notNull\":true,\"unique\":false}},\"indexes\":[{\"name\":\"expense_receipts_slug_context_idx\",\"columns\":[\"tenant_id\",\"slug\",\"context\"],\"unique\":true,\"nullsNotDistinct\":true},{\"name\":\"expense_receipts_expense_sha256_key\",\"columns\":[\"expense_id\",\"content_sha256\"],\"unique\":true},{\"name\":\"expense_receipts_tenant_sha256_idx\",\"columns\":[\"tenant_id\",\"content_sha256\"]},{\"name\":\"expense_receipts_tenant_id_created_at_idx\",\"columns\":[\"tenant_id\",\"created_at\"]},{\"name\":\"expense_receipts_asset_id_idx\",\"columns\":[\"asset_id\"]},{\"name\":\"expense_receipts_uploaded_by_profile_id_idx\",\"columns\":[\"uploaded_by_profile_id\"]}],\"version\":\"5aa77571\"},\"importPath\":\"@happyvertical/smrt-expenses\"}},\"moduleType\":\"smrt\",\"smrtDependencies\":[\"@happyvertical/smrt-assets\",\"@happyvertical/smrt-commerce\",\"@happyvertical/smrt-core\",\"@happyvertical/smrt-tenancy\"]}"));
 //#endregion
 //#region src/collections/ExpenseCollection.ts
 var ExpenseCollection_exports = /* @__PURE__ */ __exportAll({ ExpenseCollection: () => ExpenseCollection });

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-expenses",
-  "packageVersion": "0.53.3",
+  "packageVersion": "0.53.5",
   "objects": {
     "@happyvertical/smrt-expenses:ExpenseCollection": {
       "name": "expensecollection",

package/dist/playground.d.ts

@@ -0,0 +1,2 @@
+export { default } from './svelte/playground.js';
+//# sourceMappingURL=playground.d.ts.map

package/dist/playground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../src/playground.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/playground.js

@@ -0,0 +1,21 @@
+import { EXPENSES_MODULE_META } from "./ui.js";
+//#region src/svelte/playground.ts
+var playground_default = {
+	packageName: "@happyvertical/smrt-expenses",
+	displayName: "Expenses",
+	description: "Purchase entry, receipts and duplicate review",
+	moduleMeta: EXPENSES_MODULE_META,
+	entries: [{
+		id: "expense-workflow",
+		title: "Expense Workflow",
+		description: "Native purchase entry with rejected-value retention and receipt review.",
+		loadComponent: () => import("./svelte/playground/ExpenseWorkflowPreview.svelte"),
+		order: 1,
+		props: {},
+		modes: { mock: { label: "Mock" } }
+	}]
+};
+//#endregion
+export { playground_default as default };
+
+//# sourceMappingURL=playground.js.map

package/dist/playground.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playground.js","names":[],"sources":["../src/svelte/playground.ts"],"sourcesContent":["import { EXPENSES_MODULE_META } from '../ui.js';\nexport default {\n  packageName: '@happyvertical/smrt-expenses',\n  displayName: 'Expenses',\n  description: 'Purchase entry, receipts and duplicate review',\n  moduleMeta: EXPENSES_MODULE_META,\n  entries: [\n    {\n      id: 'expense-workflow',\n      title: 'Expense Workflow',\n      description:\n        'Native purchase entry with rejected-value retention and receipt review.',\n      loadComponent: () => import('./playground/ExpenseWorkflowPreview.svelte'),\n      order: 1,\n      props: {},\n      modes: { mock: { label: 'Mock' } },\n    },\n  ],\n};\n"],"mappings":";;AACA,IAAA,qBAAe;CACb,aAAa;CACb,aAAa;CACb,aAAa;CACb,YAAY;CACZ,SAAS,CACP;EACE,IAAI;EACJ,OAAO;EACP,aACE;EACF,qBAAqB,OAAO;EAC5B,OAAO;EACP,OAAO,CAAC;EACR,OAAO,EAAE,MAAM,EAAE,OAAO,OAAO,EAAE;CACnC,CACF;AACF"}

package/dist/smrt-knowledge.json

@@ -3,35 +3,47 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-expenses",
-  "packageVersion": "0.53.3",
+  "packageVersion": "0.53.5",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "463b0646cf69017d7d75cb6b0bdb84a10c3a061e2a3666283b63faa62ab5970c",
-    "packageJson": "55395bdc07e8b8d4b8dc9c5c2a12b8432035ecd2457355ec35374c2e4f2b1b3d",
-    "agents": "3af9d39ed7cbb390749e3828cb667dab39a6fd9104ad6c37abcf1db023f8dfcb"
+    "manifest": "af0cf74b9fb3072e42770f8c29965f923f05a305e7636163d752f68cb5c7b8ad",
+    "packageJson": "a3f7d29a4d20a163d53504c938f36ad4e879c688242a228aa1f227c39951126b",
+    "agents": "874f50fb4947edfa4547fa4355767f94693481c548f6b087174b7ed4286c47f6",
+    "moduleDoc:agents/expense-ui.md": "b2a0e24c48243eb2de351c299a9153b2e1020658760d68a032c21592aedf83f1"
   },
   "exports": [
     ".",
     "./manifest",
-    "./manifest.json"
+    "./manifest.json",
+    "./playground",
+    "./svelte",
+    "./ui"
   ],
   "dependencies": {
     "@happyvertical/smrt-assets": "workspace:*",
     "@happyvertical/smrt-commerce": "workspace:*",
     "@happyvertical/smrt-core": "workspace:*",
     "@happyvertical/smrt-tenancy": "workspace:*",
+    "@happyvertical/smrt-types": "workspace:*",
+    "@happyvertical/smrt-ui": "workspace:*",
     "@happyvertical/smrt-vitest": "workspace:*",
     "@types/node": "24.13.6",
     "typescript": "6.0.3",
     "vite": "8.1.4",
-    "vitest": "4.1.10"
+    "vitest": "4.1.10",
+    "@sveltejs/package": "^2.5.8",
+    "@sveltejs/vite-plugin-svelte": "^7.3.0",
+    "svelte": "^5.57.0",
+    "svelte-check": "^4.7.6"
   },
   "smrtDependencies": [
     "@happyvertical/smrt-assets",
     "@happyvertical/smrt-commerce",
     "@happyvertical/smrt-core",
     "@happyvertical/smrt-tenancy",
+    "@happyvertical/smrt-types",
+    "@happyvertical/smrt-ui",
     "@happyvertical/smrt-vitest"
   ],
   "sdkDependencies": [],
@@ -774,5 +786,12 @@
     "polymorphicAssociations": 0,
     "uuidColumns": 28
   },
-  "agentDoc": "# @happyvertical/smrt-expenses\n\nIncurred costs against a cost object, with deduplicated receipts, an explicit\nreview, reimbursement recording, and smrt-commerce commitment drawdown (#3289).\n\n## Models\n\n- **Expense** (`expenses`): `costObjectType` (qualified class name) +\n  `costObjectId` (bare string), `category` (lowercase kebab-case; suggestions\n  in `SUGGESTED_EXPENSE_CATEGORIES`), `amount` integer minor units + ISO 4217\n  `currency`, `incurredOn` (`YYYY-MM-DD` text: a calendar date, not an\n  instant), `recordedAt`, `recordedByProfileId`, `paidBy` (`company` |\n  `person`) + `paidByProfileId`, `vendorId`, `commitmentId` /\n  `commitmentLineId`, review fields, `reimbursable` / `reimbursedAt` /\n  `reimbursementReference`.\n- **ExpenseReceipt** (`expense_receipts`): noun-specific asset join\n  (`expenseId` → Expense, `assetId` → smrt-assets Asset) with uploader,\n  `filename`, `mimeType`, `byteCount`, `contentSha256`. Collection extends\n  `SmrtJunction` (left expense, right asset, ordered by `created_at`).\n\n## Invariants\n\n- **Review is method-only.** `review()`, `reject()`, `markDuplicate()`,\n  `reopen()` read the persisted status, check the move, and authorize exactly\n  one save through a module `WeakMap`. Every transition assigns every review\n  field, and the token carries that complete resulting state, so a field set\n  directly beside `review()`/`reject()` (e.g. an injected `duplicateOfId`)\n  is refused. A `reviewed` expense never carries `duplicateOfId`. `save()` compares every review field\n  (status, reviewer, time, note, `duplicateOfId`) with the stored row and\n  refuses an unauthorized change (`EXPENSE_REVIEW_FIELDS_LOCKED`), including\n  on a brand-new row. Review fields are also `readonly` for generated writes.\n- **Writes are pinned to the guarded row.** The guards read the row stored\n  under `id`, but core's natural-key save adopts any same-owner row on\n  `(tenant_id, slug, context)` and upserts it with no revision predicate;\n  these models' slugs come from the id. So `pinNaturalKey()` lets a fresh\n  (not `isPersisted`) instance only INSERT (`requireInsertOnSave()`): naming\n  an existing row's id is `EXPENSE_IDENTITY_CONFLICT`, and a row appearing\n  mid-save fails the INSERT instead of being adopted. An existing row changes\n  only through a loaded instance (revision compare-and-swap) that keeps its\n  slug/context. Never `create({ id: <existing> })` or `getOrUpsert()` these\n  models; load and save instead.\n- **Reviewed money is frozen.** While the stored status is `reviewed`,\n  `LOCKED_WHEN_REVIEWED` fields (money, currency, both dates, cost object,\n  vendor, commitment, payer) cannot change; `reopen()` first. `recordedAt` is\n  compared as an instant, since drivers return it as a `Date` or a string.\n- **Drawdown counts once.** `ExpenseCollection.commitmentPosition()` sums only\n  `reviewed` rows with no `duplicateOfId`, in the commitment's currency, deduped\n  by id. Committed is the contract's `totalAmount` (or the line's `amount`).\n- **Currencies never mix.** A commitment match must share the currency and\n  tenant (`EXPENSE_COMMITMENT_MISMATCH`), checked when the match, line or\n  currency is set or changed — not on every save, so a later commitment edit\n  never blocks e.g. `markReimbursed()`. `totalsByCurrency()` keys by currency.\n  Rows left in another currency by a later commitment change land in\n  `otherCurrencies`, never in `drawn`.\n- **Duplicate receipts.** Same `(expense, sha256)` is refused by a pre-insert\n  read plus the unique index `expense_receipts_expense_sha256_key`\n  `(expense_id, content_sha256)`; a unique violation is rethrown as\n  `DuplicateReceiptError`, classified from the error itself (violated key\n  name, or `details.fieldName` columns on core's typed error) because on\n  PostgreSQL the violation aborts a caller's transaction and nothing can be\n  re-read; only an error naming no key falls back to a re-read. The index omits `tenant_id` deliberately: the\n  expense already fixes the tenant, and a nullable leading `tenant_id` would\n  leave NULL-tenant (global) receipts unenforced. Same hash on different\n  expenses is allowed; `findDuplicateReceipts()` reports it (facet on\n  `contentSha256`, count > 1). Receipt `tenantId` (derived from the\n  expense on insert), `expenseId`, `assetId` and `contentSha256` are\n  immutable. The inherited `SmrtJunction.attach()` and\n  `setLinks()` are overridden to throw (`setLinks()` would delete every\n  receipt, then fail to re-attach without hashes); `attachReceipt()` adds and\n  `detach()` removes a link, keeping the asset. Because `ExpenseReceipt`\n  overrides `save()`, `hasBaseJunctionLifecycle()` is false and no batch\n  junction path can write a hashless row around it.\n- **Vendor ownership.** `vendorId` is a `crossPackageRef` (no FK, no\n  validation), so `assertVendor()` checks the vendor is visible in and owned\n  by the expense's tenant whenever it is set or changed\n  (`EXPENSE_VENDOR_MISMATCH`).\n- **Tenant never moves.** Expense and receipt tenants are fixed once\n  stored, compared as `effectiveTenant()` (the field, or the active context\n  the `beforeSave` interceptor would fill an unset one from; unset is falsy,\n  so `''` counts). `normalizeTenantId()` stores `''` as NULL (global), never\n  as a pseudo-tenant, matching core/tenancy's falsy \"unset\". Otherwise a\n  global (NULL-tenant) row saved inside `withTenant()` would be silently\n  populated and split from its global expense or receipts.\n- **Tenancy.** Optional (`@TenantScoped({ mode: 'optional' })`, nullable\n  `tenantId`), like smrt-commerce. A receipt takes its expense's tenant; its\n  expense and asset must be visible in that tenant. A commitment must belong\n  to the expense's tenant; before `super.save()` that is\n  `tenantId ?? getTenantId()`, because the interceptor has not populated it.\n  Consumers make it required with a qualified\n  `registerTenantScopedClass(…, { mode: 'required' })`.\n- **Closed generated surface.** Models AND collections declare\n  `api: { include: [] }`, `mcp: { include: [] }`, `cli: false`. Collection\n  classes are registered too: an undecorated collection publishes its CRUD and\n  public methods as MCP tools. Core has no consumer-side switch to reopen a\n  package model's surface; consumers write their own routes.\n- **Cost object is not dereferenced on save.** `getCostObject()` resolves it\n  through the registry and returns `null` for a foreign-tenant row. One cost\n  object per expense (columns, not a `SmrtPolymorphicAssociation` join) so a\n  cost can never roll up into two jobs.\n\n## Cross-package references\n\n- `vendorId` → `@crossPackageRef('@happyvertical/smrt-commerce:Vendor')`\n- `commitmentId` → `…smrt-commerce:Contract` (usually a `PurchaseOrder`)\n- `commitmentLineId` → `…smrt-commerce:ContractLineItem`\n- `assetId` → `…smrt-assets:Asset`\n- profile ids → `…smrt-profiles:Profile` (no dependency; references only)\n- `expenseId`, `duplicateOfId` → `@foreignKey` within the package\n\n## Scope\n\nAllowance (a planned amount) is not an expense kind; it belongs with\nbudget/commitment records. Labour belongs to `@happyvertical/smrt-timesheets`\n(#3288). No OCR, no accounting-provider posting.\n\n## Validation\n\n```bash\npnpm --filter @happyvertical/smrt-expenses test\npnpm --filter @happyvertical/smrt-expenses typecheck\npnpm --filter @happyvertical/smrt-expenses test:postgres\n```\n\n`src/__tests__/helpers/expense-suite.ts` is the shared behaviour suite: the\nSQLite file and the PostgreSQL lane (`*.optional.test.ts`, schema from\n`migrateSmrtSchemas` plus live parity) both run it. Use UUID tenant and\nprofile ids in tests: PostgreSQL stores them as `uuid`.\n"
+  "agentDoc": "# @happyvertical/smrt-expenses\n\nIncurred costs against a cost object, with deduplicated receipts, an explicit\nreview, reimbursement recording, and smrt-commerce commitment drawdown (#3289).\n\n## Models\n\n- **Expense** (`expenses`): `costObjectType` (qualified class name) +\n  `costObjectId` (bare string), `category` (lowercase kebab-case; suggestions\n  in `SUGGESTED_EXPENSE_CATEGORIES`), `amount` integer minor units + ISO 4217\n  `currency`, `incurredOn` (`YYYY-MM-DD` text: a calendar date, not an\n  instant), `recordedAt`, `recordedByProfileId`, `paidBy` (`company` |\n  `person`) + `paidByProfileId`, `vendorId`, `commitmentId` /\n  `commitmentLineId`, review fields, `reimbursable` / `reimbursedAt` /\n  `reimbursementReference`.\n- **ExpenseReceipt** (`expense_receipts`): noun-specific asset join\n  (`expenseId` → Expense, `assetId` → smrt-assets Asset) with uploader,\n  `filename`, `mimeType`, `byteCount`, `contentSha256`. Collection extends\n  `SmrtJunction` (left expense, right asset, ordered by `created_at`).\n\n## Invariants\n\n- **Review is method-only.** `review()`, `reject()`, `markDuplicate()`,\n  `reopen()` read the persisted status, check the move, and authorize exactly\n  one save through a module `WeakMap`. Every transition assigns every review\n  field, and the token carries that complete resulting state, so a field set\n  directly beside `review()`/`reject()` (e.g. an injected `duplicateOfId`)\n  is refused. A `reviewed` expense never carries `duplicateOfId`. `save()` compares every review field\n  (status, reviewer, time, note, `duplicateOfId`) with the stored row and\n  refuses an unauthorized change (`EXPENSE_REVIEW_FIELDS_LOCKED`), including\n  on a brand-new row. Review fields are also `readonly` for generated writes.\n- **Writes are pinned to the guarded row.** The guards read the row stored\n  under `id`, but core's natural-key save adopts any same-owner row on\n  `(tenant_id, slug, context)` and upserts it with no revision predicate;\n  these models' slugs come from the id. So `pinNaturalKey()` lets a fresh\n  (not `isPersisted`) instance only INSERT (`requireInsertOnSave()`): naming\n  an existing row's id is `EXPENSE_IDENTITY_CONFLICT`, and a row appearing\n  mid-save fails the INSERT instead of being adopted. An existing row changes\n  only through a loaded instance (revision compare-and-swap) that keeps its\n  slug/context. Never `create({ id: <existing> })` or `getOrUpsert()` these\n  models; load and save instead.\n- **Reviewed money is frozen.** While the stored status is `reviewed`,\n  `LOCKED_WHEN_REVIEWED` fields (money, currency, both dates, cost object,\n  vendor, commitment, payer) cannot change; `reopen()` first. `recordedAt` is\n  compared as an instant, since drivers return it as a `Date` or a string.\n- **Drawdown counts once.** `ExpenseCollection.commitmentPosition()` sums only\n  `reviewed` rows with no `duplicateOfId`, in the commitment's currency, deduped\n  by id. Committed is the contract's `totalAmount` (or the line's `amount`).\n- **Currencies never mix.** A commitment match must share the currency and\n  tenant (`EXPENSE_COMMITMENT_MISMATCH`), checked when the match, line or\n  currency is set or changed — not on every save, so a later commitment edit\n  never blocks e.g. `markReimbursed()`. `totalsByCurrency()` keys by currency.\n  Rows left in another currency by a later commitment change land in\n  `otherCurrencies`, never in `drawn`.\n- **Duplicate receipts.** Same `(expense, sha256)` is refused by a pre-insert\n  read plus the unique index `expense_receipts_expense_sha256_key`\n  `(expense_id, content_sha256)`; a unique violation is rethrown as\n  `DuplicateReceiptError`, classified from the error itself (violated key\n  name, or `details.fieldName` columns on core's typed error) because on\n  PostgreSQL the violation aborts a caller's transaction and nothing can be\n  re-read; only an error naming no key falls back to a re-read. The index omits `tenant_id` deliberately: the\n  expense already fixes the tenant, and a nullable leading `tenant_id` would\n  leave NULL-tenant (global) receipts unenforced. Same hash on different\n  expenses is allowed; `findDuplicateReceipts()` reports it (facet on\n  `contentSha256`, count > 1). Receipt `tenantId` (derived from the\n  expense on insert), `expenseId`, `assetId` and `contentSha256` are\n  immutable. The inherited `SmrtJunction.attach()` and\n  `setLinks()` are overridden to throw (`setLinks()` would delete every\n  receipt, then fail to re-attach without hashes); `attachReceipt()` adds and\n  `detach()` removes a link, keeping the asset. Because `ExpenseReceipt`\n  overrides `save()`, `hasBaseJunctionLifecycle()` is false and no batch\n  junction path can write a hashless row around it.\n- **Vendor ownership.** `vendorId` is a `crossPackageRef` (no FK, no\n  validation), so `assertVendor()` checks the vendor is visible in and owned\n  by the expense's tenant whenever it is set or changed\n  (`EXPENSE_VENDOR_MISMATCH`).\n- **Tenant never moves.** Expense and receipt tenants are fixed once\n  stored, compared as `effectiveTenant()` (the field, or the active context\n  the `beforeSave` interceptor would fill an unset one from; unset is falsy,\n  so `''` counts). `normalizeTenantId()` stores `''` as NULL (global), never\n  as a pseudo-tenant, matching core/tenancy's falsy \"unset\". Otherwise a\n  global (NULL-tenant) row saved inside `withTenant()` would be silently\n  populated and split from its global expense or receipts.\n- **Tenancy.** Optional (`@TenantScoped({ mode: 'optional' })`, nullable\n  `tenantId`), like smrt-commerce. A receipt takes its expense's tenant; its\n  expense and asset must be visible in that tenant. A commitment must belong\n  to the expense's tenant; before `super.save()` that is\n  `tenantId ?? getTenantId()`, because the interceptor has not populated it.\n  Consumers make it required with a qualified\n  `registerTenantScopedClass(…, { mode: 'required' })`.\n- **Closed generated surface.** Models AND collections declare\n  `api: { include: [] }`, `mcp: { include: [] }`, `cli: false`. Collection\n  classes are registered too: an undecorated collection publishes its CRUD and\n  public methods as MCP tools. Core has no consumer-side switch to reopen a\n  package model's surface; consumers write their own routes.\n- **Cost object is not dereferenced on save.** `getCostObject()` resolves it\n  through the registry and returns `null` for a foreign-tenant row. One cost\n  object per expense (columns, not a `SmrtPolymorphicAssociation` join) so a\n  cost can never roll up into two jobs.\n\n## Cross-package references\n\n- `vendorId` → `@crossPackageRef('@happyvertical/smrt-commerce:Vendor')`\n- `commitmentId` → `…smrt-commerce:Contract` (usually a `PurchaseOrder`)\n- `commitmentLineId` → `…smrt-commerce:ContractLineItem`\n- `assetId` → `…smrt-assets:Asset`\n- profile ids → `…smrt-profiles:Profile` (no dependency; references only)\n- `expenseId`, `duplicateOfId` → `@foreignKey` within the package\n\n## Scope\n\nAllowance (a planned amount) is not an expense kind; it belongs with\nbudget/commitment records. Labour belongs to `@happyvertical/smrt-timesheets`\n(#3288). No OCR, no accounting-provider posting.\n\n## Validation\n\n```bash\npnpm --filter @happyvertical/smrt-expenses test\npnpm --filter @happyvertical/smrt-expenses typecheck\npnpm --filter @happyvertical/smrt-expenses test:postgres\n```\n\n`src/__tests__/helpers/expense-suite.ts` is the shared behaviour suite: the\nSQLite file and the PostgreSQL lane (`*.optional.test.ts`, schema from\n`migrateSmrtSchemas` plus live parity) both run it. Use UUID tenant and\nprofile ids in tests: PostgreSQL stores them as `uuid`.\n\n## UI\n\n`src/svelte/` owns native expense entry and review presentation. See\n[the UI contract](agents/expense-ui.md) for DTOs, native payloads and recovery.\nDraft amounts are lossless currency-unit text; model/review amounts remain integer\nminor units. Receipt upload is composed from Assets, never reimplemented here.\n`test` includes backend and UI SSR; `test:e2e` proves native browser submissions.\n",
+  "moduleDocs": [
+    {
+      "path": "agents/expense-ui.md",
+      "module": "expense-ui",
+      "content": "# Expense entry and receipt review\n\nImport `ExpenseForm`, `ExpenseReviewPanel` and their named Props types from\n`@happyvertical/smrt-expenses/svelte`. Registry slots are `expense-form` and\n`expense-review`. `@happyvertical/smrt-expenses/ui` exposes metadata without\nSvelte; `./playground` exposes an interactive retained-draft/review example.\n\n`ExpenseDraftValues` is a complete set of native strings: `amount`, `currency`,\n`incurredOn`, `description`, `category`, `vendorId`, `commitmentId`, `paidBy`,\n`paidByProfileId`, and `correctionReason`. Initialize unused fields to `''`.\nAmount is ordinary currency text (`'125.00'` CAD), distinct from the public\nExpense model's integer minor-unit `amount` (`12500`). Server adapters parse\ncurrency precision, safe integer range and business rules. Calendar dates stay\nlossless text, normally `YYYY-MM-DD`; invalid amounts/dates never disappear due\nto browser number/date coercion. Every validation failure returns original\nstrings, not reconstructed saved-model values.\n\n```svelte\n<script lang=\"ts\">\n  import { ExpenseForm, ExpenseReviewPanel } from '@happyvertical/smrt-expenses/svelte';\n  let { data, form } = $props();\n</script>\n<ExpenseForm\n  action=\"?/save\"\n  title=\"Record purchase\"\n  values={form?.values ?? data.values}\n  errors={form?.errors}\n  message={form?.message}\n  canEdit={data.mayEdit}\n  correcting={data.correcting}\n  vendors={data.authorizedVendors}\n  commitments={data.authorizedCommitments}\n  hiddenFields={[\n    { name: 'requestId', value: form?.requestId ?? data.requestId },\n    { name: 'costObjectId', value: data.costObjectId },\n    { name: 'expectedTenantId', value: data.tenantId },\n  ]}\n/>\n<ExpenseReviewPanel\n  expense={data.expenseSummary}\n  duplicates={data.authorizedDuplicateCandidates}\n  history={data.history}\n  receipts={data.receiptPanel}\n/>\n```\n\nVendor and commitment options are authorized Commerce `{id, label}` projections.\nResolve Profile names and application-specific award lineage in the consumer.\nUnknown retained references remain selectable/postable; selecting a reference\nnever establishes tenant ownership or commitment eligibility. `fields` maps\nlogical keys to native names; `errors` always uses logical keys. Submitter\n`intentField`/`intent` default to `intent=save`. `hiddenFields` preserves exact\nvalues and repeated names. Avoid field-name collisions. `children` adds\napplication-owned package allocation, quantity, reimbursement and correction\npolicy fields. `correcting` shows a retained reason, but does not implement a\nnew Expense correction model. The caller applies its own correction/history\npolicy and invokes existing guarded methods where appropriate.\n\nThe base form performs native POST by default, with or without JavaScript.\n`onsubmit` allows optional enhancement. `pending` or a supplied\n`smrt-ui/form-retry` `retryStatus` controls progress presentation without clearing\nvalues or creating/rotating request keys. `canEdit=false` disables fields and\nhides save; server-side authorization and replay enforcement remain mandatory.\n\nCurrency uses the shared `CurrencySelect`, localized by the active smrt-ui i18n\ncontext. It preserves the exact retained draft string and the field name from\n`fields.currency`, including native no-JavaScript correction flows. Pass\n`currencyOptions` only when the caller must restrict the shared currency catalog.\n\n`ExpenseReviewSummary` projects public Expense description, integer minor-unit\namount, currency and incurredOn, with caller-localized `statusLabel` and `note`.\n`duplicates` and `history` are explicit authorized presentation DTOs, not a\nparallel ledger. The server supplies findings from ExpenseReceipt duplicate\nqueries and application history. Unknown labels render verbatim. No state or\naction is inferred: `canReview`, `action`, `actions` and hidden fingerprints\nexplicitly provide a native review form. `action=\"\"` posts to the current page;\nomitting `action` hides the review form; `children` can supply retained reason\nor duplicate-selection inputs. A server must reauthorize, reload the model and\ninvoke `review()`, `reject()`, `markDuplicate()` or `reopen()` under its policy.\nNever assign review fields through UI payload binding. Reviewed money remains\nfrozen by the existing model; UI props cannot bypass it.\n\n`receipts` is exactly the public Assets `AttachmentPanelProps`, supporting\nprivate view/download URLs, version notes, native upload and recovery. It is\nrendered outside the review form so upload and review remain separate native\nactions. Use authorized receipt projections; attaching a file does not review\nan expense, mark a duplicate, or change invoice approval. Assets owns file\nselection and reselect-file help; Expenses does not duplicate uploads/storage.\n\nValidation: `pnpm --filter @happyvertical/smrt-expenses test`, `test:ui`,\n`test:e2e`, `typecheck`, `build`, and `verify:pack`. PostgreSQL model validation\nremains in the existing opt-in `test:postgres` lane; this UI does not alter it.\n"
+    }
+  ]
 }

package/dist/svelte/components/ExpenseForm.svelte

@@ -0,0 +1,111 @@
+<script lang="ts">
+import {
+  CurrencySelect,
+  Form,
+  FormGroup,
+  Input,
+  Select,
+  Textarea,
+} from '@happyvertical/smrt-ui/forms';
+import { useI18n } from '@happyvertical/smrt-ui/i18n';
+import { Button } from '@happyvertical/smrt-ui/ui';
+import { expenseMessages as M } from '../messages.js';
+import type { ExpenseDraftValues, ExpenseFormProps } from '../types.js';
+/** Native expense entry preserving every caller-owned submitted value. */
+export interface Props extends ExpenseFormProps {}
+let {
+  action,
+  values,
+  id,
+  title,
+  canEdit = true,
+  correcting = false,
+  vendors = [],
+  commitments = [],
+  currencyOptions,
+  fields = {},
+  errors = {},
+  message,
+  hiddenFields = [],
+  intentField = 'intent',
+  intent = 'save',
+  submitLabel,
+  pending = false,
+  retryStatus = 'idle',
+  children,
+  onsubmit,
+}: Props = $props();
+const i18n = useI18n();
+const { t } = i18n;
+const instanceId = $props.id();
+const formId = $derived(id ?? `expense-form-${instanceId}`);
+const busy = $derived(
+  pending || retryStatus === 'submitting' || retryStatus === 'busy',
+);
+const textFields: (keyof ExpenseDraftValues)[] = [
+  'amount',
+  'currency',
+  'incurredOn',
+  'category',
+  'paidByProfileId',
+];
+function name(field: keyof ExpenseDraftValues) {
+  return fields[field] ?? field;
+}
+</script>
+<section class="expense-form" aria-labelledby={`${formId}-title`}>
+  <h2 id={`${formId}-title`}>{title ?? t(M['expenses.form.title'])}</h2>
+  {#if !canEdit}<p>{t(M['expenses.form.readonly'])}</p>{/if}
+  <Form id={formId} {action} method="post" preventDefault={false} {onsubmit} aria-busy={busy}>
+    <div class="fields">
+      {#each hiddenFields as field}<Input type="hidden" name={field.name} value={field.value} interaction={false} />{/each}
+      {#if message}<p role="alert">{message}</p>{/if}
+      {#if retryStatus === 'transport-error'}<p role="status">{t(M['expenses.form.uncertain'])}</p>{/if}
+      <fieldset disabled={!canEdit}>
+        {#each textFields as field}
+          <FormGroup id={`${formId}-${field}`} label={t(M[`expenses.form.${field}`])} error={errors[field]} hint={field === 'amount' ? t(M['expenses.form.amount_help']) : field === 'incurredOn' ? t(M['expenses.form.date_help']) : undefined}>
+            {#if field === 'currency'}
+              <CurrencySelect name={name(field)} value={values[field]} options={currencyOptions} locale={i18n.locale} readOnly={!canEdit} />
+            {:else}
+              <Input name={name(field)} value={values[field]} inputmode={field === 'amount' ? 'decimal' : undefined} />
+            {/if}
+          </FormGroup>
+        {/each}
+        <FormGroup id={`${formId}-description`} label={t(M['expenses.form.description'])} error={errors.description}>
+          <Textarea name={name('description')} value={values.description} />
+        </FormGroup>
+        {#each ['vendorId', 'commitmentId'] as reference}
+          {@const field = reference as 'vendorId' | 'commitmentId'}
+          {@const options = field === 'vendorId' ? vendors : commitments}
+          <FormGroup id={`${formId}-${field}`} label={t(M[`expenses.form.${field}`])} error={errors[field]}>
+            <Select name={name(field)} value={values[field]}>
+              <option value="">{t(M['expenses.form.choose'])}</option>
+              {#if values[field] && !options.some(option => option.id === values[field])}<option value={values[field]}>{t(M['expenses.form.retained'], { reference: values[field] })}</option>{/if}
+              {#each options as option}<option value={option.id}>{option.label}</option>{/each}
+            </Select>
+          </FormGroup>
+        {/each}
+        <FormGroup id={`${formId}-paidBy`} label={t(M['expenses.form.paidBy'])} error={errors.paidBy}>
+          <Select name={name('paidBy')} value={values.paidBy}>
+            {#if !['company', 'person'].includes(values.paidBy)}<option value={values.paidBy}>{values.paidBy}</option>{/if}
+            <option value="company">{t(M['expenses.form.company'])}</option>
+            <option value="person">{t(M['expenses.form.person'])}</option>
+          </Select>
+        </FormGroup>
+        {#if correcting}
+          <FormGroup id={`${formId}-correctionReason`} label={t(M['expenses.form.correctionReason'])} error={errors.correctionReason}>
+            <Textarea name={name('correctionReason')} value={values.correctionReason} />
+          </FormGroup>
+        {:else}<Input type="hidden" name={name('correctionReason')} value={values.correctionReason} interaction={false} />{/if}
+        {@render children?.()}
+      </fieldset>
+      {#if canEdit}<div><Button type="submit" name={intentField} value={intent} disabled={busy}>{submitLabel ?? t(M[correcting ? 'expenses.form.correct' : 'expenses.form.save'])}</Button></div>{/if}
+    </div>
+  </Form>
+</section>
+<style>
+  .expense-form, .fields { display: grid; gap: var(--smrt-spacing-4); min-width: 0; }
+  .expense-form { max-width: 48rem; overflow-wrap: anywhere; }
+  fieldset { min-width: 0; border: 0; padding: 0; margin: 0; }
+  h2, p { margin: 0; }
+</style>

package/dist/svelte/components/ExpenseForm.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { ExpenseFormProps } from '../types.js';
+/** Native expense entry preserving every caller-owned submitted value. */
+export interface Props extends ExpenseFormProps {
+}
+declare const ExpenseForm: import("svelte").Component<Props, {}, "">;
+type ExpenseForm = ReturnType<typeof ExpenseForm>;
+export default ExpenseForm;
+//# sourceMappingURL=ExpenseForm.svelte.d.ts.map

package/dist/svelte/components/ExpenseForm.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpenseForm.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/ExpenseForm.svelte.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAsB,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAExE,0EAA0E;AAC1E,MAAM,WAAW,KAAM,SAAQ,gBAAgB;CAAG;AAsGlD,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/svelte/components/ExpenseReviewPanel.svelte

@@ -0,0 +1,58 @@
+<script lang="ts">
+import { AttachmentPanel } from '@happyvertical/smrt-assets/svelte';
+import { CurrencyDisplay } from '@happyvertical/smrt-ui';
+import { Form, Input } from '@happyvertical/smrt-ui/forms';
+import { useI18n } from '@happyvertical/smrt-ui/i18n';
+import { Button } from '@happyvertical/smrt-ui/ui';
+import { expenseMessages as M } from '../messages.js';
+import type { ExpenseReviewPanelProps } from '../types.js';
+/** Server-authoritative expense review, duplicates/history and receipt composition. */
+export interface Props extends ExpenseReviewPanelProps {}
+let {
+  expense,
+  duplicates = [],
+  history = [],
+  receipts,
+  canReview = false,
+  action,
+  actions = [],
+  intentField = 'intent',
+  hiddenFields = [],
+  message,
+  pending = false,
+  children,
+  onsubmit,
+}: Props = $props();
+const { t } = useI18n();
+</script>
+<section class="expense-review" aria-label={t(M['expenses.review.title'])}>
+  <h3>{expense.description}</h3>
+  <p><CurrencyDisplay amount={expense.amount} currency={expense.currency} unit="cents" /> · {expense.incurredOn}</p>
+  <p aria-live="polite">{expense.statusLabel}</p>
+  {#if expense.note}<p>{expense.note}</p>{/if}
+  {#if message}<p role="alert">{message}</p>{/if}
+  <section aria-label={t(M['expenses.review.duplicates'])}>
+    <h4>{t(M['expenses.review.duplicates'])}</h4>
+    {#if duplicates.length === 0}<p>{t(M['expenses.review.no_duplicates'])}</p>{/if}
+    <ul>{#each duplicates as duplicate (duplicate.id)}<li><strong>{duplicate.label}</strong>{#if duplicate.reason}<p>{duplicate.reason}</p>{/if}</li>{/each}</ul>
+  </section>
+  <section aria-label={t(M['expenses.review.history'])}>
+    <h4>{t(M['expenses.review.history'])}</h4>
+    {#if history.length === 0}<p>{t(M['expenses.review.no_history'])}</p>{/if}
+    <ol>{#each history as entry (entry.id)}<li><strong>{entry.label}</strong>{#if entry.detail}<p>{entry.detail}</p>{/if}</li>{/each}</ol>
+  </section>
+  {#if canReview && action !== undefined && actions.length}
+    <Form {action} method="post" preventDefault={false} {onsubmit} aria-busy={pending}>
+      {#each hiddenFields as field}<Input type="hidden" name={field.name} value={field.value} interaction={false} />{/each}
+      {@render children?.()}
+      <div class="actions">{#each actions as choice}<Button type="submit" name={intentField} value={choice.intent} disabled={pending || choice.disabled}>{choice.label}</Button>{/each}</div>
+    </Form>
+  {/if}
+  {#if receipts}<AttachmentPanel {...receipts} />{/if}
+</section>
+<style>
+  .expense-review { display: grid; gap: var(--smrt-spacing-4); min-width: 0; overflow-wrap: anywhere; }
+  .actions { display: flex; flex-wrap: wrap; gap: var(--smrt-spacing-3); }
+  h3, h4, p { margin: 0; }
+  ul, ol { display: grid; gap: var(--smrt-spacing-2); padding-inline-start: var(--smrt-spacing-5); }
+</style>

package/dist/svelte/components/ExpenseReviewPanel.svelte.d.ts

@@ -0,0 +1,8 @@
+import type { ExpenseReviewPanelProps } from '../types.js';
+/** Server-authoritative expense review, duplicates/history and receipt composition. */
+export interface Props extends ExpenseReviewPanelProps {
+}
+declare const ExpenseReviewPanel: import("svelte").Component<Props, {}, "">;
+type ExpenseReviewPanel = ReturnType<typeof ExpenseReviewPanel>;
+export default ExpenseReviewPanel;
+//# sourceMappingURL=ExpenseReviewPanel.svelte.d.ts.map

package/dist/svelte/components/ExpenseReviewPanel.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpenseReviewPanel.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/ExpenseReviewPanel.svelte.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAE3D,uFAAuF;AACvF,MAAM,WAAW,KAAM,SAAQ,uBAAuB;CAAG;AAwDzD,QAAA,MAAM,kBAAkB,2CAAwC,CAAC;AACjE,KAAK,kBAAkB,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAChE,eAAe,kBAAkB,CAAC"}

package/dist/svelte/index.d.ts

@@ -0,0 +1,5 @@
+import ExpenseForm from './components/ExpenseForm.svelte';
+import ExpenseReviewPanel from './components/ExpenseReviewPanel.svelte';
+export type { ExpenseDraftValues, ExpenseDuplicateCandidate, ExpenseFormProps, ExpenseHistoryEntry, ExpenseReferenceOption, ExpenseRequestField, ExpenseReviewAction, ExpenseReviewPanelProps, ExpenseReviewSummary, } from './types.js';
+export { ExpenseForm, ExpenseReviewPanel };
+//# sourceMappingURL=index.d.ts.map

package/dist/svelte/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAGA,OAAO,WAAW,MAAM,iCAAiC,CAAC;AAC1D,OAAO,kBAAkB,MAAM,wCAAwC,CAAC;AAExE,YAAY,EACV,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/svelte/index.js

@@ -0,0 +1,9 @@
+/** Package-owned Expenses components and native presentation contracts. */
+import { ModuleUIRegistry } from '@happyvertical/smrt-ui/registry';
+import { EXPENSES_MODULE_META } from '../ui.js';
+import ExpenseForm from './components/ExpenseForm.svelte';
+import ExpenseReviewPanel from './components/ExpenseReviewPanel.svelte';
+export { ExpenseForm, ExpenseReviewPanel };
+ModuleUIRegistry.registerModule(EXPENSES_MODULE_META);
+ModuleUIRegistry.register('@happyvertical/smrt-expenses', 'expense-form', ExpenseForm);
+ModuleUIRegistry.register('@happyvertical/smrt-expenses', 'expense-review', ExpenseReviewPanel);

package/dist/svelte/messages.d.ts

@@ -0,0 +1,29 @@
+export declare const expenseMessages: {
+    readonly 'expenses.form.title': "expenses.form.title";
+    readonly 'expenses.form.amount': "expenses.form.amount";
+    readonly 'expenses.form.currency': "expenses.form.currency";
+    readonly 'expenses.form.incurredOn': "expenses.form.incurredOn";
+    readonly 'expenses.form.description': "expenses.form.description";
+    readonly 'expenses.form.category': "expenses.form.category";
+    readonly 'expenses.form.vendorId': "expenses.form.vendorId";
+    readonly 'expenses.form.commitmentId': "expenses.form.commitmentId";
+    readonly 'expenses.form.paidBy': "expenses.form.paidBy";
+    readonly 'expenses.form.paidByProfileId': "expenses.form.paidByProfileId";
+    readonly 'expenses.form.correctionReason': "expenses.form.correctionReason";
+    readonly 'expenses.form.company': "expenses.form.company";
+    readonly 'expenses.form.person': "expenses.form.person";
+    readonly 'expenses.form.choose': "expenses.form.choose";
+    readonly 'expenses.form.retained': "expenses.form.retained";
+    readonly 'expenses.form.date_help': "expenses.form.date_help";
+    readonly 'expenses.form.amount_help': "expenses.form.amount_help";
+    readonly 'expenses.form.save': "expenses.form.save";
+    readonly 'expenses.form.correct': "expenses.form.correct";
+    readonly 'expenses.form.readonly': "expenses.form.readonly";
+    readonly 'expenses.form.uncertain': "expenses.form.uncertain";
+    readonly 'expenses.review.title': "expenses.review.title";
+    readonly 'expenses.review.duplicates': "expenses.review.duplicates";
+    readonly 'expenses.review.no_duplicates': "expenses.review.no_duplicates";
+    readonly 'expenses.review.history': "expenses.review.history";
+    readonly 'expenses.review.no_history': "expenses.review.no_history";
+};
+//# sourceMappingURL=messages.d.ts.map

package/dist/svelte/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/svelte/messages.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6B1B,CAAC"}

package/dist/svelte/messages.js

@@ -0,0 +1,29 @@
+import { defineMessages } from '@happyvertical/smrt-ui/i18n';
+export const expenseMessages = defineMessages({
+    'expenses.form.title': 'Record expense',
+    'expenses.form.amount': 'Amount',
+    'expenses.form.currency': 'Currency',
+    'expenses.form.incurredOn': 'Incurred date',
+    'expenses.form.description': 'Description',
+    'expenses.form.category': 'Category',
+    'expenses.form.vendorId': 'Vendor',
+    'expenses.form.commitmentId': 'Commitment',
+    'expenses.form.paidBy': 'Paid by',
+    'expenses.form.paidByProfileId': 'Payer profile reference',
+    'expenses.form.correctionReason': 'Correction reason',
+    'expenses.form.company': 'Company',
+    'expenses.form.person': 'Person',
+    'expenses.form.choose': 'No reference selected',
+    'expenses.form.retained': 'Retained reference: {reference}',
+    'expenses.form.date_help': 'Calendar date (YYYY-MM-DD).',
+    'expenses.form.amount_help': 'Enter ordinary currency amounts, for example 125.00 CAD. The server validates currency precision.',
+    'expenses.form.save': 'Save expense',
+    'expenses.form.correct': 'Save correction',
+    'expenses.form.readonly': 'This expense is read-only.',
+    'expenses.form.uncertain': 'The outcome is uncertain. Your entries and request identity are retained; follow the application’s retry guidance.',
+    'expenses.review.title': 'Expense review',
+    'expenses.review.duplicates': 'Possible duplicates',
+    'expenses.review.no_duplicates': 'No possible duplicates supplied.',
+    'expenses.review.history': 'Correction and review history',
+    'expenses.review.no_history': 'No history supplied.',
+});

package/dist/svelte/playground/ExpenseWorkflowPreview.svelte

@@ -0,0 +1,38 @@
+<script lang="ts">
+import { Checkbox } from '@happyvertical/smrt-ui/forms';
+import ExpenseForm from '../components/ExpenseForm.svelte';
+import ExpenseReviewPanel from '../components/ExpenseReviewPanel.svelte';
+import type { ExpenseDraftValues } from '../types.js';
+
+let canEdit = $state(true);
+let correcting = $state(false);
+let message = $state('');
+let values = $state<ExpenseDraftValues>({
+  amount: '125.00',
+  currency: 'CAD',
+  incurredOn: '2026-10-03',
+  description: 'Supplier materials',
+  category: 'materials',
+  vendorId: 'vendor-a',
+  commitmentId: '',
+  paidBy: 'company',
+  paidByProfileId: '',
+  correctionReason: '',
+});
+function submit(event: SubmitEvent & { currentTarget: HTMLFormElement }) {
+  event.preventDefault();
+  const data = new FormData(event.currentTarget, event.submitter);
+  values = Object.fromEntries(
+    Object.keys(values).map((key) => [key, String(data.get(key) ?? '')]),
+  ) as unknown as ExpenseDraftValues;
+  message =
+    'Example server rejection: a receipt is required by this application. Your entries and request token are retained.';
+}
+</script>
+<div class="preview">
+  <Checkbox label="May edit expense" bind:checked={canEdit} />
+  <Checkbox label="Correction workflow" bind:checked={correcting} />
+  <ExpenseForm action="" {values} {canEdit} {correcting} {message} vendors={[{ id: 'vendor-a', label: 'Supplier A' }]} hiddenFields={[{ name: 'requestId', value: 'demo-expense-request' }]} onsubmit={submit} />
+  <ExpenseReviewPanel expense={{ description: 'Supplier materials', amount: 12500, currency: 'CAD', incurredOn: '2026-10-03', statusLabel: 'Unreviewed' }} duplicates={[{ id: 'expense-other', label: 'Possible matching expense', reason: 'The server found matching receipt evidence. A reviewer must decide.' }]} history={[{ id: 'correction', label: 'Description corrected', detail: 'Caller-provided correction history' }]} receipts={{ attachments: [{ id: 'receipt', name: 'Receipt.pdf', mimeType: 'application/pdf' }] }} />
+</div>
+<style>.preview { display: grid; gap: var(--smrt-spacing-4); }</style>

package/dist/svelte/playground/ExpenseWorkflowPreview.svelte.d.ts

@@ -0,0 +1,4 @@
+declare const ExpenseWorkflowPreview: import("svelte").Component<Record<string, never>, {}, "">;
+type ExpenseWorkflowPreview = ReturnType<typeof ExpenseWorkflowPreview>;
+export default ExpenseWorkflowPreview;
+//# sourceMappingURL=ExpenseWorkflowPreview.svelte.d.ts.map

package/dist/svelte/playground/ExpenseWorkflowPreview.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpenseWorkflowPreview.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/playground/ExpenseWorkflowPreview.svelte.ts"],"names":[],"mappings":"AAiDA,QAAA,MAAM,sBAAsB,2DAAwC,CAAC;AACrE,KAAK,sBAAsB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACxE,eAAe,sBAAsB,CAAC"}

package/dist/svelte/playground.d.ts

@@ -0,0 +1,21 @@
+declare const _default: {
+    packageName: string;
+    displayName: string;
+    description: string;
+    moduleMeta: import("@happyvertical/smrt-types").SmrtModuleMeta;
+    entries: {
+        id: string;
+        title: string;
+        description: string;
+        loadComponent: () => Promise<typeof import("./playground/ExpenseWorkflowPreview.svelte")>;
+        order: number;
+        props: {};
+        modes: {
+            mock: {
+                label: string;
+            };
+        };
+    }[];
+};
+export default _default;
+//# sourceMappingURL=playground.d.ts.map

package/dist/svelte/playground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../../src/svelte/playground.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AACA,wBAiBE"}

package/dist/svelte/playground.js

@@ -0,0 +1,18 @@
+import { EXPENSES_MODULE_META } from '../ui.js';
+export default {
+    packageName: '@happyvertical/smrt-expenses',
+    displayName: 'Expenses',
+    description: 'Purchase entry, receipts and duplicate review',
+    moduleMeta: EXPENSES_MODULE_META,
+    entries: [
+        {
+            id: 'expense-workflow',
+            title: 'Expense Workflow',
+            description: 'Native purchase entry with rejected-value retention and receipt review.',
+            loadComponent: () => import('./playground/ExpenseWorkflowPreview.svelte'),
+            order: 1,
+            props: {},
+            modes: { mock: { label: 'Mock' } },
+        },
+    ],
+};

package/dist/svelte/types.d.ts

@@ -0,0 +1,150 @@
+import type { AttachmentPanelProps } from '@happyvertical/smrt-assets/svelte';
+import type { FormRetryStatus } from '@happyvertical/smrt-ui/form-retry';
+import type { CodeSelectOption } from '@happyvertical/smrt-ui/forms';
+import type { Snippet } from 'svelte';
+import type { HTMLFormAttributes } from 'svelte/elements';
+import type { Expense } from '../models/Expense.js';
+/** Lossless native form strings, separate from Expense's integer model amount. */
+export interface ExpenseDraftValues {
+    /** Ordinary currency-unit text, e.g. '125.00' CAD; parsed server-side. */
+    amount: string;
+    /** Currency as submitted, even if invalid; server validates. */
+    currency: string;
+    /** Calendar-date text, normally YYYY-MM-DD; invalid strings remain visible. */
+    incurredOn: string;
+    /** Caller-entered cost description. */
+    description: string;
+    /** Caller-entered category; server validates its vocabulary. */
+    category: string;
+    /** Commerce Vendor reference, not an identity merge. */
+    vendorId: string;
+    /** Commerce Contract commitment reference. */
+    commitmentId: string;
+    /** Payer text, normally company or person; unknown submitted values retained. */
+    paidBy: string;
+    /** Profile reference for a person payer. */
+    paidByProfileId: string;
+    /** Caller-owned correction reason; not a new Expense persistence property. */
+    correctionReason: string;
+}
+/** Authorized Commerce choice projection. Labels remain caller-owned. */
+export interface ExpenseReferenceOption {
+    /** Opaque Vendor/Contract reference. */
+    id: string;
+    /** Caller-localized label. */
+    label: string;
+}
+/** Request identity/context forwarded as native hidden fields. */
+export interface ExpenseRequestField {
+    /** Native field name; repetitions are preserved. */
+    name: string;
+    /** Exact caller value; never generated or rotated here. */
+    value: string;
+}
+/** Native purchase/expense entry. Caller endpoints enforce financial policy. */
+export interface ExpenseFormProps {
+    /** Authorized native POST destination. */
+    action: string;
+    /** Retained draft strings from load or the failed action response. */
+    values: ExpenseDraftValues;
+    /** Optional stable form identity for enhancement. */
+    id?: string;
+    /** Caller-localized heading, including Purchase terminology. */
+    title?: string;
+    /** Capability controls presentation; server must authorize every mutation. */
+    canEdit?: boolean;
+    /** Whether caller correction workflow requires the reason field. */
+    correcting?: boolean;
+    /** Authorized Commerce Vendor options. */
+    vendors?: readonly ExpenseReferenceOption[];
+    /** Authorized Commerce Contract options. */
+    commitments?: readonly ExpenseReferenceOption[];
+    /** Caller-restricted currency choices; omitted uses the shared ISO defaults. */
+    currencyOptions?: readonly CodeSelectOption[];
+    /** Optional native field-name adapter; defaults to draft property names. */
+    fields?: Partial<Record<keyof ExpenseDraftValues, string>>;
+    /** Server errors keyed by logical draft property. */
+    errors?: Partial<Record<keyof ExpenseDraftValues, string>>;
+    /** Caller error/denial/uncertain-outcome message. */
+    message?: string;
+    /** Caller-owned request identity, cost object, predecessor and context. */
+    hiddenFields?: readonly ExpenseRequestField[];
+    /** Native submitter name, default intent. */
+    intentField?: string;
+    /** Native submitter value, default save. */
+    intent?: string;
+    /** Caller-localized submit label. */
+    submitLabel?: string;
+    /** Request in flight. Values stay editable, another submit is disabled. */
+    pending?: boolean;
+    /** Optional status from caller-owned smrt-ui/form-retry. */
+    retryStatus?: FormRetryStatus;
+    /** Domain-specific fields (allocation, quantity, reimbursement, etc.). */
+    children?: Snippet;
+    /** Optional enhancement; native POST remains the default. */
+    onsubmit?: HTMLFormAttributes['onsubmit'];
+}
+/** Display projection of the public Expense; amount remains integer minor units. */
+export interface ExpenseReviewSummary extends Pick<Expense, 'description' | 'amount' | 'currency' | 'incurredOn'> {
+    /** Caller-localized review status, including unknown future states. */
+    statusLabel: string;
+    /** Caller policy/review explanation. */
+    note?: string;
+}
+/** Possible duplicate supplied by an authorized server query. */
+export interface ExpenseDuplicateCandidate {
+    /** Opaque expense reference; no linking or merging happens automatically. */
+    id: string;
+    /** Caller-localized duplicate description. */
+    label: string;
+    /** Caller-localized reason, such as a matching receipt. */
+    reason?: string;
+}
+/** An authorized correction or review history entry supplied in display order. */
+export interface ExpenseHistoryEntry {
+    /** Unique history identity. */
+    id: string;
+    /** Caller-localized decision/correction label. */
+    label: string;
+    /** Caller-localized time/actor metadata. */
+    detail?: string;
+}
+/** Caller-defined review action; visibility never replaces server authorization. */
+export interface ExpenseReviewAction {
+    /** Native clicked submitter value. */
+    intent: string;
+    /** Caller-localized action label. */
+    label: string;
+    /** Presentation disable flag for this action. */
+    disabled?: boolean;
+}
+/** Reviewed-state and duplicate/correction presentation with Assets composition. */
+export interface ExpenseReviewPanelProps {
+    /** Authorized model projection; UI does not infer status or mutate it. */
+    expense: ExpenseReviewSummary;
+    /** Supplied duplicate candidates; no deduplication policy runs here. */
+    duplicates?: readonly ExpenseDuplicateCandidate[];
+    /** Supplied correction/review history. */
+    history?: readonly ExpenseHistoryEntry[];
+    /** Assets public attachment presentation/upload contract. */
+    receipts?: AttachmentPanelProps;
+    /** Explicitly enable caller-supplied review actions. */
+    canReview?: boolean;
+    /** Authorized review endpoint; empty posts to this page, undefined hides actions. */
+    action?: string;
+    /** Caller-defined review actions; no status-derived actions. */
+    actions?: readonly ExpenseReviewAction[];
+    /** Native submitter name, default intent. */
+    intentField?: string;
+    /** Caller request/tenant/fingerprint context. */
+    hiddenFields?: readonly ExpenseRequestField[];
+    /** Caller error or denied/uncertain outcome. */
+    message?: string;
+    /** Caller request pending state. */
+    pending?: boolean;
+    /** Retained review reason/duplicate selector and other caller-specific fields. */
+    children?: Snippet;
+    /** Optional review-form enhancement. */
+    onsubmit?: HTMLFormAttributes['onsubmit'];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/svelte/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/svelte/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,kFAAkF;AAClF,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,yEAAyE;AACzE,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,kEAAkE;AAClE,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,gFAAgF;AAChF,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,MAAM,EAAE,kBAAkB,CAAC;IAC3B,qDAAqD;IACrD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oEAAoE;IACpE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC5C,4CAA4C;IAC5C,WAAW,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAChD,gFAAgF;IAChF,eAAe,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3D,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC9C,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;CAC3C;AAED,oFAAoF;AACpF,MAAM,WAAW,oBACf,SAAQ,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;IAC3E,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,iEAAiE;AACjE,MAAM,WAAW,yBAAyB;IACxC,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kFAAkF;AAClF,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,oFAAoF;AACpF,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,oFAAoF;AACpF,MAAM,WAAW,uBAAuB;IACtC,0EAA0E;IAC1E,OAAO,EAAE,oBAAoB,CAAC;IAC9B,wEAAwE;IACxE,UAAU,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAClD,0CAA0C;IAC1C,OAAO,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACzC,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qFAAqF;IACrF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,OAAO,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACzC,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,YAAY,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC9C,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;CAC3C"}

package/dist/svelte/types.js

@@ -0,0 +1 @@
+export {};

package/dist/ui.d.ts

@@ -0,0 +1,6 @@
+import type { ModuleUISlot, SmrtModuleMeta } from '@happyvertical/smrt-types';
+/** Discoverable presentation slots owned by Expenses. */
+export declare const EXPENSES_UI_SLOTS: Record<string, ModuleUISlot>;
+/** Module metadata consumed without importing Svelte components. */
+export declare const EXPENSES_MODULE_META: SmrtModuleMeta;
+//# sourceMappingURL=ui.d.ts.map

package/dist/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE9E,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAmB1D,CAAC;AACF,oEAAoE;AACpE,eAAO,MAAM,oBAAoB,EAAE,cAOlC,CAAC"}

package/dist/ui.js

@@ -0,0 +1,33 @@
+//#region src/ui.ts
+var EXPENSES_UI_SLOTS = {
+	"expense-form": {
+		id: "expense-form",
+		label: "Expense Entry",
+		description: "Native retained-value purchase and expense entry",
+		icon: "file-text",
+		category: "form",
+		order: 1,
+		propsInterface: "ExpenseFormProps"
+	},
+	"expense-review": {
+		id: "expense-review",
+		label: "Expense Review",
+		description: "Duplicate/correction review and private receipt composition",
+		icon: "file-text",
+		category: "detail",
+		order: 2,
+		propsInterface: "ExpenseReviewPanelProps"
+	}
+};
+var EXPENSES_MODULE_META = {
+	name: "@happyvertical/smrt-expenses",
+	displayName: "Expenses",
+	description: "Expense entry, receipt and duplicate review",
+	uiSlots: EXPENSES_UI_SLOTS,
+	models: ["Expense", "ExpenseReceipt"],
+	collections: ["ExpenseCollection", "ExpenseReceiptCollection"]
+};
+//#endregion
+export { EXPENSES_MODULE_META, EXPENSES_UI_SLOTS };
+
+//# sourceMappingURL=ui.js.map

package/dist/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","names":[],"sources":["../src/ui.ts"],"sourcesContent":["import type { ModuleUISlot, SmrtModuleMeta } from '@happyvertical/smrt-types';\n\n/** Discoverable presentation slots owned by Expenses. */\nexport const EXPENSES_UI_SLOTS: Record<string, ModuleUISlot> = {\n  'expense-form': {\n    id: 'expense-form',\n    label: 'Expense Entry',\n    description: 'Native retained-value purchase and expense entry',\n    icon: 'file-text',\n    category: 'form',\n    order: 1,\n    propsInterface: 'ExpenseFormProps',\n  },\n  'expense-review': {\n    id: 'expense-review',\n    label: 'Expense Review',\n    description: 'Duplicate/correction review and private receipt composition',\n    icon: 'file-text',\n    category: 'detail',\n    order: 2,\n    propsInterface: 'ExpenseReviewPanelProps',\n  },\n};\n/** Module metadata consumed without importing Svelte components. */\nexport const EXPENSES_MODULE_META: SmrtModuleMeta = {\n  name: '@happyvertical/smrt-expenses',\n  displayName: 'Expenses',\n  description: 'Expense entry, receipt and duplicate review',\n  uiSlots: EXPENSES_UI_SLOTS,\n  models: ['Expense', 'ExpenseReceipt'],\n  collections: ['ExpenseCollection', 'ExpenseReceiptCollection'],\n};\n"],"mappings":";AAGO,IAAM,oBAAkD;CAC7D,gBAAgB;EACd,IAAI;EACJ,OAAO;EACP,aAAa;EACb,MAAM;EACN,UAAU;EACV,OAAO;EACP,gBAAgB;CAClB;CACA,kBAAkB;EAChB,IAAI;EACJ,OAAO;EACP,aAAa;EACb,MAAM;EACN,UAAU;EACV,OAAO;EACP,gBAAgB;CAClB;AACF;AAEO,IAAM,uBAAuC;CAClD,MAAM;CACN,aAAa;CACb,aAAa;CACb,SAAS;CACT,QAAQ,CAAC,WAAW,gBAAgB;CACpC,aAAa,CAAC,qBAAqB,0BAA0B;AAC/D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-expenses",
-  "version": "0.53.3",
+  "version": "0.53.5",
   "description": "Expense records for the SMRT framework - reviewed costs against a cost object, deduplicated receipts, and commitment drawdown",
   "type": "module",
   "main": "./dist/index.js",
@@ -8,7 +8,8 @@
   "files": [
     "dist",
     "CLAUDE.md",
-    "AGENTS.md"
+    "AGENTS.md",
+    "agents"
   ],
   "exports": {
     ".": {
@@ -16,20 +17,39 @@
       "import": "./dist/index.js"
     },
     "./manifest": "./dist/manifest.json",
-    "./manifest.json": "./dist/manifest.json"
+    "./manifest.json": "./dist/manifest.json",
+    "./ui": {
+      "types": "./dist/ui.d.ts",
+      "import": "./dist/ui.js"
+    },
+    "./svelte": {
+      "types": "./dist/svelte/index.d.ts",
+      "svelte": "./dist/svelte/index.js",
+      "import": "./dist/svelte/index.js"
+    },
+    "./playground": {
+      "types": "./dist/playground.d.ts",
+      "import": "./dist/playground.js"
+    }
   },
   "dependencies": {
-    "@happyvertical/smrt-assets": "0.53.3",
-    "@happyvertical/smrt-commerce": "0.53.3",
-    "@happyvertical/smrt-core": "0.53.3",
-    "@happyvertical/smrt-tenancy": "0.53.3"
+    "@happyvertical/smrt-assets": "0.53.5",
+    "@happyvertical/smrt-commerce": "0.53.5",
+    "@happyvertical/smrt-core": "0.53.5",
+    "@happyvertical/smrt-tenancy": "0.53.5",
+    "@happyvertical/smrt-types": "0.53.5",
+    "@happyvertical/smrt-ui": "0.53.5"
   },
   "devDependencies": {
-    "@happyvertical/smrt-vitest": "0.53.3",
+    "@happyvertical/smrt-vitest": "0.53.5",
     "@types/node": "24.13.6",
     "typescript": "6.0.3",
     "vite": "8.1.4",
-    "vitest": "4.1.10"
+    "vitest": "4.1.10",
+    "@sveltejs/package": "^2.5.8",
+    "@sveltejs/vite-plugin-svelte": "^7.3.0",
+    "svelte": "^5.57.1",
+    "svelte-check": "^4.7.6"
   },
   "keywords": [
     "smrt",
@@ -49,15 +69,27 @@
     "url": "https://github.com/happyvertical/smrt.git",
     "directory": "packages/expenses"
   },
+  "smrtJsdoc": "strict",
+  "smrtRawPrimitives": "strict",
+  "peerDependencies": {
+    "svelte": "^5.57.0"
+  },
+  "peerDependenciesMeta": {
+    "svelte": {
+      "optional": true
+    }
+  },
   "scripts": {
-    "build": "vite build --mode library",
+    "build": "vite build --mode library && svelte-package -i src/svelte -o dist/svelte --tsconfig tsconfig.svelte.json && node ../../scripts/prune-svelte-package-artifacts.js dist",
     "build:watch": "vite build --mode library --watch",
     "clean": "rm -rf dist",
     "dev": "vite build --mode library --watch",
-    "test": "vitest run",
+    "test": "vitest run && pnpm run test:ui",
     "test:postgres": "node ../../scripts/run-with-ci-postgres.mjs -- pnpm exec vitest run optional.test.ts",
     "test:watch": "vitest",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
-    "verify:pack": "node ../../scripts/verify-package-types-exports.js ."
+    "typecheck": "tsc --noEmit -p tsconfig.json && node ../../scripts/svelte-check-a11y.mjs --tsconfig ./tsconfig.svelte.json",
+    "verify:pack": "node ../../scripts/verify-package-types-exports.js .",
+    "test:ui": "vitest run --config vitest.ui.config.ts",
+    "test:e2e": "playwright test -c e2e/playwright.config.ts"
   }
 }