@happyvertical/smrt-commerce 0.53.3 → 0.53.5

package/dist/svelte/components/PricingVersionDecision.svelte

@@ -0,0 +1,88 @@
+<script lang="ts">
+import { Form, FormGroup, Input, Textarea } from '@happyvertical/smrt-ui/forms';
+import { useI18n } from '@happyvertical/smrt-ui/i18n';
+import { Button } from '@happyvertical/smrt-ui/ui';
+import type { Snippet } from 'svelte';
+import type { HTMLFormAttributes } from 'svelte/elements';
+import { PRICING_MESSAGES as M } from '../pricing-i18n.js';
+import type {
+  PricingDecisionAction,
+  PricingHiddenField,
+  PricingVersionData,
+} from '../pricing-types.js';
+import PricingVersionSummary from './PricingVersionSummary.svelte';
+
+export interface Props {
+  /** Authorized immutable version snapshot; displaying it records no decision. */
+  version: PricingVersionData;
+  /** Caller-owned native form destination. */
+  action: string;
+  /** Explicit available decisions; no acceptance/award action is inferred. */
+  actions: readonly PricingDecisionAction[];
+  /** Ordered exact hidden values, including caller-owned version/request/tenant tokens. */
+  hiddenFields?: readonly PricingHiddenField[];
+  /** Retained reason text, including text returned after a rejected action. */
+  reason?: string;
+  /** Native field name for the reason; omit to use reason. */
+  reasonName?: string;
+  /** Localized reason label override. */
+  reasonLabel?: string;
+  /** Whether the server requires a reason for these decisions. */
+  reasonRequired?: boolean;
+  /** Caller-returned form error; does not reset text or hidden identity. */
+  error?: string;
+  /** Hide mutation controls for a viewer; this is not server authorization. */
+  readOnly?: boolean;
+  /** Disable decisions while an application-controlled submission is in flight. */
+  busy?: boolean;
+  /** Optional progressive enhancement; native submission remains the default. */
+  onsubmit?: HTMLFormAttributes['onsubmit'];
+  /** Additional caller-owned native fields or decision context within the form. */
+  children?: Snippet;
+}
+const {
+  version,
+  action,
+  actions,
+  hiddenFields = [],
+  reason = '',
+  reasonName = 'reason',
+  reasonLabel,
+  reasonRequired = false,
+  error,
+  readOnly = false,
+  busy = false,
+  onsubmit,
+  children,
+}: Props = $props();
+const { t } = useI18n();
+const id = $props.id();
+</script>
+
+<section class="pricing-decision">
+  <PricingVersionSummary {version} />
+  {#if error}<p role="alert">{error}</p>{/if}
+  {#if readOnly}
+    <p>{t(M['commerce.pricing.read_only'])}</p>
+    {#if reason}<p>{reason}</p>{/if}
+  {:else if !actions.length}
+    <p>{t(M['commerce.pricing.no_actions'])}</p>
+  {:else}
+    <Form method="POST" {action} preventDefault={false} {onsubmit}>
+      {#each hiddenFields as field}<Input type="hidden" name={field.name} value={field.value} />{/each}
+      <FormGroup label={reasonLabel ?? t(M['commerce.pricing.reason'])} id={`${id}-reason`}>
+        <Textarea id={`${id}-reason`} name={reasonName} value={reason} required={reasonRequired} readonly={busy} />
+      </FormGroup>
+      {#if children}{@render children()}{/if}
+      <div class="decisions">{#each actions as decision}
+        <Button type="submit" name={decision.name} value={decision.value} formaction={decision.formAction} disabled={busy || decision.disabled}>{decision.label}</Button>
+      {/each}</div>
+    </Form>
+  {/if}
+</section>
+
+<style>
+.pricing-decision { min-width: 0; overflow-wrap: anywhere; }
+.decisions { display: flex; flex-wrap: wrap; gap: var(--smrt-spacing-3); margin-top: var(--smrt-spacing-3); }
+.decisions :global(button) { max-width: 100%; white-space: normal; }
+</style>

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

@@ -0,0 +1,35 @@
+import type { Snippet } from 'svelte';
+import type { HTMLFormAttributes } from 'svelte/elements';
+import type { PricingDecisionAction, PricingHiddenField, PricingVersionData } from '../pricing-types.js';
+export interface Props {
+    /** Authorized immutable version snapshot; displaying it records no decision. */
+    version: PricingVersionData;
+    /** Caller-owned native form destination. */
+    action: string;
+    /** Explicit available decisions; no acceptance/award action is inferred. */
+    actions: readonly PricingDecisionAction[];
+    /** Ordered exact hidden values, including caller-owned version/request/tenant tokens. */
+    hiddenFields?: readonly PricingHiddenField[];
+    /** Retained reason text, including text returned after a rejected action. */
+    reason?: string;
+    /** Native field name for the reason; omit to use reason. */
+    reasonName?: string;
+    /** Localized reason label override. */
+    reasonLabel?: string;
+    /** Whether the server requires a reason for these decisions. */
+    reasonRequired?: boolean;
+    /** Caller-returned form error; does not reset text or hidden identity. */
+    error?: string;
+    /** Hide mutation controls for a viewer; this is not server authorization. */
+    readOnly?: boolean;
+    /** Disable decisions while an application-controlled submission is in flight. */
+    busy?: boolean;
+    /** Optional progressive enhancement; native submission remains the default. */
+    onsubmit?: HTMLFormAttributes['onsubmit'];
+    /** Additional caller-owned native fields or decision context within the form. */
+    children?: Snippet;
+}
+declare const PricingVersionDecision: import("svelte").Component<Props, {}, "">;
+type PricingVersionDecision = ReturnType<typeof PricingVersionDecision>;
+export default PricingVersionDecision;
+//# sourceMappingURL=PricingVersionDecision.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PricingVersionDecision.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/PricingVersionDecision.svelte.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,KAAK,EACV,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAI7B,MAAM,WAAW,KAAK;IACpB,gFAAgF;IAChF,OAAO,EAAE,kBAAkB,CAAC;IAC5B,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC1C,yFAAyF;IACzF,YAAY,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC7C,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC1C,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAwDD,QAAA,MAAM,sBAAsB,2CAAwC,CAAC;AACrE,KAAK,sBAAsB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACxE,eAAe,sBAAsB,CAAC"}

package/dist/svelte/components/PricingVersionSummary.svelte

@@ -0,0 +1,46 @@
+<script lang="ts">
+import { useI18n } from '@happyvertical/smrt-ui/i18n';
+import { PRICING_MESSAGES as M } from '../pricing-i18n.js';
+import type { PricingVersionData } from '../pricing-types.js';
+import { quoteMinorText } from '../quote-types.js';
+
+export interface Props {
+  /** Immutable, authorized version data from the owning application. */
+  version: PricingVersionData;
+}
+const { version }: Props = $props();
+const { t } = useI18n();
+function amount(value: number | null): string {
+  try {
+    return (
+      quoteMinorText({ ...version.total, amountMinor: value }) ??
+      t(M['commerce.pricing.unknown'])
+    );
+  } catch (error) {
+    if (error instanceof RangeError) return t(M['commerce.pricing.unknown']);
+    throw error;
+  }
+}
+</script>
+
+<section class="pricing-summary" aria-label={version.label}>
+  <h3>{version.label}</h3>
+  <p>{version.counterparty} · {version.status}</p>
+  <p><strong>{t(M['commerce.pricing.total'])}: {amount(version.total.amountMinor)} {version.total.currency}</strong></p>
+  {#if version.reason}<p>{version.reason}</p>{/if}
+  <h4>{t(M['commerce.pricing.sources'])}</h4>
+  {#if version.sources?.length}
+    <ul>{#each version.sources as source (source.id)}
+      <li><span>{source.label}</span><strong>{amount(source.amountMinor)}</strong>
+        {#if source.description}<p>{source.description}</p>{/if}
+      </li>
+    {/each}</ul>
+  {:else}<p>{t(M['commerce.pricing.no_sources'])}</p>{/if}
+</section>
+
+<style>
+.pricing-summary { min-width: 0; overflow-wrap: anywhere; }
+.pricing-summary ul { display: grid; gap: var(--smrt-spacing-3); padding-inline-start: var(--smrt-spacing-5); }
+.pricing-summary li { min-width: 0; }
+.pricing-summary li strong { display: block; }
+</style>

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

@@ -0,0 +1,9 @@
+import type { PricingVersionData } from '../pricing-types.js';
+export interface Props {
+    /** Immutable, authorized version data from the owning application. */
+    version: PricingVersionData;
+}
+declare const PricingVersionSummary: import("svelte").Component<Props, {}, "">;
+type PricingVersionSummary = ReturnType<typeof PricingVersionSummary>;
+export default PricingVersionSummary;
+//# sourceMappingURL=PricingVersionSummary.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PricingVersionSummary.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/PricingVersionSummary.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAI9D,MAAM,WAAW,KAAK;IACpB,sEAAsE;IACtE,OAAO,EAAE,kBAAkB,CAAC;CAC7B;AAyCD,QAAA,MAAM,qBAAqB,2CAAwC,CAAC;AACpE,KAAK,qBAAqB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACtE,eAAe,qBAAqB,CAAC"}

package/dist/svelte/components/PurchaseOrderEditor.svelte

@@ -0,0 +1,210 @@
+<script lang="ts">
+import {
+  Checkbox,
+  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 type { Snippet } from 'svelte';
+import type { HTMLFormAttributes } from 'svelte/elements';
+import { P } from '../purchasing-i18n.js';
+import {
+  type PurchaseDraftValues,
+  type PurchaseFieldNames,
+  type PurchaseReviewSnapshot,
+  type PurchaseSourceOption,
+  purchaseFieldNames,
+} from '../purchasing-types.js';
+import { type QuoteMoneyMinor, quoteMinorText } from '../quote-types.js';
+import type { QuoteFormAttributes } from './QuoteEditor.svelte';
+
+/** Native purchase/award preparation, review and explicit confirmation; never writes a record. */
+export interface Props {
+  /** Caller-selected operation; reducing retains every predecessor allocation. */
+  operation?: 'create' | 'amend' | 'reduce';
+  /** Retained source. For reductions, the server must enforce predecessor/source identity. */
+  source: PurchaseSourceOption;
+  /** Currency and decimal places come from the owning financial contract. */
+  currency: string;
+  /** Explicit currency/asset scale (0–8); amounts entered in ordinary major units. */
+  minorUnitDigits: number;
+  /** Raw submitted values, including errors and explicit zero amounts. */
+  values: PurchaseDraftValues;
+  /** Caller-approved instrument choices, with no fixed construction policy. */
+  instruments: { value: string; label: string }[];
+  /** Native POST action URL. */
+  action: string;
+  /** Caller-owned tenant/request/source/predecessor IDs. */
+  hiddenFields?: { name: string; value: string }[];
+  /** Existing route field-name adaptation. */
+  names?: Partial<PurchaseFieldNames>;
+  /** Canonical field errors or allocation IDs. */
+  errors?: Record<string, string>;
+  /** Server validation or uncertain-outcome message. */
+  message?: string;
+  /** Server-produced review snapshot. Omit until explicit review succeeds. */
+  review?: PurchaseReviewSnapshot;
+  /** Previously reviewed fingerprint retained after an uncertain committed response. */
+  retryFingerprint?: string;
+  /** Presentation capability; caller must independently enforce authority. */
+  readonly?: boolean;
+  /** Disable writes while caller transport is in flight. */
+  busy?: boolean;
+  /** Native submitter names and values expected by the caller. */
+  intents?: { name: string; review: string; record: string; edit: string };
+  /** Optional row editing. Retained reduction rows cannot be removed. */
+  rowActions?: { add: string; removePrefix: string };
+  /** Caller confirmation value; a new review fingerprint requires fresh confirmation. */
+  confirmationValue?: string;
+  /** Application-specific labels, including the explicit approval statement. */
+  labels?: {
+    title?: string;
+    review?: string;
+    record?: string;
+    confirmation?: string;
+    allocations?: string;
+  };
+  /** Optional navigation URL. */
+  cancelHref?: string;
+  /** Native form enhancement; caller prevents default when handling transport. */
+  onsubmit?: HTMLFormAttributes['onsubmit'];
+  /** Native encoding/ID and caller-owned Svelte form-retry attachments. */
+  formAttributes?: QuoteFormAttributes;
+  /** Domain-specific allocation, policy or source evidence composition. */
+  extensions?: Snippet;
+  /** Authorized private attachment surface outside the editor form; never loaded by Commerce. */
+  attachments?: Snippet;
+}
+let {
+  operation = 'create',
+  source,
+  currency,
+  minorUnitDigits,
+  values,
+  instruments,
+  action,
+  hiddenFields = [],
+  names = {},
+  errors = {},
+  message,
+  review,
+  retryFingerprint,
+  readonly = false,
+  busy = false,
+  intents = {
+    name: 'intent',
+    review: 'review',
+    record: 'record',
+    edit: 'edit',
+  },
+  rowActions,
+  confirmationValue = 'yes',
+  labels = {},
+  cancelHref,
+  onsubmit,
+  formAttributes = {},
+  extensions,
+  attachments,
+}: Props = $props();
+const { t } = useI18n();
+const fields = $derived({ ...purchaseFieldNames, ...names });
+const title = $derived(
+  labels.title ??
+    t(
+      P[
+        operation === 'reduce'
+          ? 'commerce.purchase.reduce'
+          : operation === 'amend'
+            ? 'commerce.purchase.amend'
+            : 'commerce.purchase.create'
+      ],
+    ),
+);
+const fingerprint = $derived(review?.fingerprint ?? retryFingerprint);
+function displayMoney(value: QuoteMoneyMinor): string {
+  try {
+    return quoteMinorText(value) ?? t(P['commerce.purchase.unknown']);
+  } catch (error) {
+    if (error instanceof RangeError)
+      return t(P['commerce.purchase.unavailable']);
+    throw error;
+  }
+}
+const money = (amountMinor: number | null) =>
+  displayMoney({ currency, minorUnitDigits, amountMinor });
+</script>
+<section class="purchase-editor" aria-label={title}>
+ <h2>{title}</h2>
+ <p>{t(P['commerce.purchase.boundary'])}</p>
+ <p>{source.vendor} — {source.label} · {currency}</p>
+ {#if source.notice}<p role="status">{source.notice}</p>{/if}
+ {#if operation==='reduce'}<p>{t(P['commerce.purchase.reduction_hint'])}</p>{/if}
+ {#if readonly}<p>{t(P['commerce.purchase.readonly'])}</p>{/if}
+ {#if message}<p role="alert">{message}</p>{/if}
+ <Form {...formAttributes} {action} method="post" {onsubmit} preventDefault={false}>
+  {#each hiddenFields as field}<Input type="hidden" name={field.name} value={field.value} />{/each}
+  <fieldset disabled={readonly || busy || source.disabled}>
+   <legend>{title}</legend>
+   <!-- The first submitter is the safe default for native Enter-in-input submission. -->
+   {#if !readonly}<Button type="submit" name={intents.name} value={fingerprint ? intents.record : intents.review} density="touch">{fingerprint ? labels.record??t(P['commerce.purchase.record']) : labels.review??t(P['commerce.purchase.review_button'])}</Button>{/if}
+   <FormGroup label={t(P['commerce.purchase.instrument'])} error={errors.instrument} required>
+    <Select name={fields.instrument} value={values.instrument} required density="touch">
+     <option value="">{t(P['commerce.purchase.choose_instrument'])}</option>
+     {#if values.instrument && !instruments.some(item=>item.value===values.instrument)}<option value={values.instrument}>{values.instrument}</option>{/if}
+     {#each instruments as item}<option value={item.value}>{item.label}</option>{/each}
+    </Select>
+   </FormGroup>
+   <fieldset>
+    <legend>{labels.allocations??t(P['commerce.purchase.allocations'])} ({currency})</legend>
+    {#each values.allocations as allocation (allocation.id)}
+     <div class="allocation">
+      <Input type="hidden" name={fields.allocationId} value={allocation.id} />
+      <FormGroup label={allocation.label} error={errors[allocation.id]} required={operation==='reduce' && allocation.retained || allocation.required}>
+       <Input name={fields.allocationAmount} value={allocation.amount} inputmode="decimal" required={operation==='reduce' && allocation.retained || allocation.required} density="touch" />
+      </FormGroup>
+      {#if allocation.sourceMinor !== undefined}<p>{t(P['commerce.purchase.source_amount'])}: {money(allocation.sourceMinor)} {currency}</p>{/if}
+      {#if allocation.minimumMinor !== undefined}<p>{t(P['commerce.purchase.minimum'])}: {money(allocation.minimumMinor)} {currency}</p>{/if}
+      {#if allocation.maximumMinor !== undefined}<p>{t(P['commerce.purchase.maximum'])}: {money(allocation.maximumMinor)} {currency}</p>{/if}
+      {#if rowActions && !readonly && !(operation==='reduce' && allocation.retained)}<Button type="submit" name={intents.name} value={`${rowActions.removePrefix}${allocation.id}`} formnovalidate variant="secondary" density="touch">{t(P['commerce.purchase.remove'],{label:allocation.label})}</Button>{/if}
+     </div>
+    {:else}<p>{t(P['commerce.purchase.empty_allocations'])}</p>{/each}
+    {#if rowActions && !readonly}<Button type="submit" name={intents.name} value={rowActions.add} formnovalidate variant="secondary" density="touch">{t(P['commerce.purchase.add'])}</Button>{/if}
+   </fieldset>
+   <FormGroup label={`${t(P['commerce.purchase.tax'])} (${currency})`} error={errors.tax} required><Input name={fields.tax} value={values.tax} inputmode="decimal" required density="touch" /></FormGroup>
+   {#each [{key:'scope',label:'commerce.purchase.scope'}, {key:'inclusions',label:'commerce.purchase.inclusions'}, {key:'exclusions',label:'commerce.purchase.exclusions'}, {key:'reason',label:'commerce.purchase.reason'}] as field}
+    <FormGroup label={t(P[field.label as keyof typeof P])} error={errors[field.key]} required={field.key==='scope' || field.key==='reason'}><Textarea name={fields[field.key as keyof PurchaseFieldNames]} value={values[field.key as 'scope']} required={field.key==='scope' || field.key==='reason'} /></FormGroup>
+   {/each}
+   {@render extensions?.()}
+   {#if fingerprint}
+    <h3>{t(P['commerce.purchase.review'])}</h3>
+    {#if review}
+     <p>{review.sourceLabel}</p><p>{t(P['commerce.purchase.total'])}: {displayMoney(review.total)} {review.total.currency}</p>
+     <p>{t(P['commerce.purchase.tax'])}: {displayMoney({...review.total,amountMinor:review.taxMinor})} {review.total.currency}</p>
+     <p>{review.scope}</p>{#each review.notices??[] as notice}<p role="status">{notice}</p>{/each}
+    {:else}<p>{t(P['commerce.purchase.uncertain'])}</p>{/if}
+    <Input type="hidden" name={fields.fingerprint} value={fingerprint} />
+    {#if !readonly}
+     {#key fingerprint}<Checkbox name={fields.confirmation} value={confirmationValue} label={labels.confirmation??t(P['commerce.purchase.confirm'])} required density="touch" />{/key}
+     <div class="actions"><Button type="submit" name={intents.name} value={intents.record} density="touch">{labels.record??t(P['commerce.purchase.record'])}</Button><Button type="submit" name={intents.name} value={intents.edit} formnovalidate variant="secondary" density="touch">{t(P['commerce.purchase.edit'])}</Button></div>
+    {/if}
+   {:else if !readonly}<Button type="submit" name={intents.name} value={intents.review} density="touch">{labels.review??t(P['commerce.purchase.review_button'])}</Button>{/if}
+  </fieldset>
+  {#if cancelHref}<Button href={cancelHref} variant="secondary" density="touch">{t(P['commerce.purchase.cancel'])}</Button>{/if}
+ </Form>
+  {#if attachments}
+    <fieldset class="editor-attachments" disabled={readonly || busy}>
+      {@render attachments()}
+    </fieldset>
+  {/if}
+</section>
+<style>
+.editor-attachments { min-width: 0; margin: 0; padding: 0; border: 0; }
+.purchase-editor{max-width:48rem;min-width:0;overflow-wrap:anywhere;color:var(--smrt-color-on-surface)}
+fieldset{min-width:0;margin-block:var(--smrt-spacing-4,1rem);padding:var(--smrt-spacing-4,1rem);border:1px solid var(--smrt-color-outline-variant);border-radius:var(--smrt-radius-md,0.5rem)}
+.allocation{margin-block:var(--smrt-spacing-4,1rem)}
+.actions{display:flex;flex-wrap:wrap;gap:var(--smrt-spacing-3,0.75rem);margin-block:var(--smrt-spacing-4,1rem)}
+</style>

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

@@ -0,0 +1,79 @@
+import type { Snippet } from 'svelte';
+import type { HTMLFormAttributes } from 'svelte/elements';
+import { type PurchaseDraftValues, type PurchaseFieldNames, type PurchaseReviewSnapshot, type PurchaseSourceOption } from '../purchasing-types.js';
+import type { QuoteFormAttributes } from './QuoteEditor.svelte';
+/** Native purchase/award preparation, review and explicit confirmation; never writes a record. */
+export interface Props {
+    /** Caller-selected operation; reducing retains every predecessor allocation. */
+    operation?: 'create' | 'amend' | 'reduce';
+    /** Retained source. For reductions, the server must enforce predecessor/source identity. */
+    source: PurchaseSourceOption;
+    /** Currency and decimal places come from the owning financial contract. */
+    currency: string;
+    /** Explicit currency/asset scale (0–8); amounts entered in ordinary major units. */
+    minorUnitDigits: number;
+    /** Raw submitted values, including errors and explicit zero amounts. */
+    values: PurchaseDraftValues;
+    /** Caller-approved instrument choices, with no fixed construction policy. */
+    instruments: {
+        value: string;
+        label: string;
+    }[];
+    /** Native POST action URL. */
+    action: string;
+    /** Caller-owned tenant/request/source/predecessor IDs. */
+    hiddenFields?: {
+        name: string;
+        value: string;
+    }[];
+    /** Existing route field-name adaptation. */
+    names?: Partial<PurchaseFieldNames>;
+    /** Canonical field errors or allocation IDs. */
+    errors?: Record<string, string>;
+    /** Server validation or uncertain-outcome message. */
+    message?: string;
+    /** Server-produced review snapshot. Omit until explicit review succeeds. */
+    review?: PurchaseReviewSnapshot;
+    /** Previously reviewed fingerprint retained after an uncertain committed response. */
+    retryFingerprint?: string;
+    /** Presentation capability; caller must independently enforce authority. */
+    readonly?: boolean;
+    /** Disable writes while caller transport is in flight. */
+    busy?: boolean;
+    /** Native submitter names and values expected by the caller. */
+    intents?: {
+        name: string;
+        review: string;
+        record: string;
+        edit: string;
+    };
+    /** Optional row editing. Retained reduction rows cannot be removed. */
+    rowActions?: {
+        add: string;
+        removePrefix: string;
+    };
+    /** Caller confirmation value; a new review fingerprint requires fresh confirmation. */
+    confirmationValue?: string;
+    /** Application-specific labels, including the explicit approval statement. */
+    labels?: {
+        title?: string;
+        review?: string;
+        record?: string;
+        confirmation?: string;
+        allocations?: string;
+    };
+    /** Optional navigation URL. */
+    cancelHref?: string;
+    /** Native form enhancement; caller prevents default when handling transport. */
+    onsubmit?: HTMLFormAttributes['onsubmit'];
+    /** Native encoding/ID and caller-owned Svelte form-retry attachments. */
+    formAttributes?: QuoteFormAttributes;
+    /** Domain-specific allocation, policy or source evidence composition. */
+    extensions?: Snippet;
+    /** Authorized private attachment surface outside the editor form; never loaded by Commerce. */
+    attachments?: Snippet;
+}
+declare const PurchaseOrderEditor: import("svelte").Component<Props, {}, "">;
+type PurchaseOrderEditor = ReturnType<typeof PurchaseOrderEditor>;
+export default PurchaseOrderEditor;
+//# sourceMappingURL=PurchaseOrderEditor.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PurchaseOrderEditor.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/PurchaseOrderEditor.svelte.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EAE1B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGhE,kGAAkG;AAClG,MAAM,WAAW,KAAK;IACpB,gFAAgF;IAChF,SAAS,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC1C,4FAA4F;IAC5F,MAAM,EAAE,oBAAoB,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,eAAe,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,MAAM,EAAE,mBAAmB,CAAC;IAC5B,6EAA6E;IAC7E,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChD,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,4CAA4C;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACpC,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,sFAAsF;IACtF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gEAAgE;IAChE,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,uEAAuE;IACvE,UAAU,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,uFAAuF;IACvF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8EAA8E;IAC9E,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC1C,yEAAyE;IACzE,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,yEAAyE;IACzE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,+FAA+F;IAC/F,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA0ID,QAAA,MAAM,mBAAmB,2CAAwC,CAAC;AAClE,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAClE,eAAe,mBAAmB,CAAC"}

package/dist/svelte/components/PurchaseSourceSelector.svelte

@@ -0,0 +1,56 @@
+<script lang="ts">
+import { Form, FormGroup, Input, Select } from '@happyvertical/smrt-ui/forms';
+import { useI18n } from '@happyvertical/smrt-ui/i18n';
+import { Button } from '@happyvertical/smrt-ui/ui';
+import type { HTMLFormAttributes } from 'svelte/elements';
+import { P } from '../purchasing-i18n.js';
+import type { PurchaseSourceOption } from '../purchasing-types.js';
+/** Native source discovery; choosing a source never records a purchase or award. */
+export interface Props {
+  /** Authorized source options with caller-owned availability and labels. */
+  sources: PurchaseSourceOption[];
+  /** Selected source ID retained after a failed action. */
+  value?: string;
+  /** Native source-selection endpoint. */
+  action: string;
+  /** Field name expected by the caller's route. */
+  name?: string;
+  /** Caller-owned search/context fields. */
+  hiddenFields?: { name: string; value: string }[];
+  /** Presentation-only disabled capability. */
+  disabled?: boolean;
+  /** Optional field validation error. */
+  error?: string;
+  /** Optional localized field label. */
+  label?: string;
+  /** Optional caller enhancement; native GET remains enabled by default. */
+  onsubmit?: HTMLFormAttributes['onsubmit'];
+}
+let {
+  sources,
+  value = '',
+  action,
+  name = 'source',
+  hiddenFields = [],
+  disabled = false,
+  error,
+  label,
+  onsubmit,
+}: Props = $props();
+const { t } = useI18n();
+</script>
+<div class="purchase-source">
+ <Form {action} {onsubmit} method="get" preventDefault={false}>
+  {#each hiddenFields as field}<Input type="hidden" name={field.name} value={field.value} />{/each}
+  <FormGroup label={label ?? t(P['commerce.purchase.source'])} {error} required>
+   <Select {name} {value} disabled={disabled || sources.every(source=>source.disabled)} required density="touch">
+    <option value="">{t(P['commerce.purchase.choose'])}</option>
+    {#if value && !sources.some(source=>source.id===value)}<option value={value} disabled>{value}</option>{/if}
+    {#each sources as source}<option value={source.id} disabled={source.disabled}>{source.vendor} — {source.label}{source.notice ? ` (${source.notice})` : ''}</option>{/each}
+   </Select>
+  </FormGroup>
+  {#if sources.length===0}<p>{t(P['commerce.purchase.empty_sources'])}</p>{/if}
+  <Button type="submit" disabled={disabled || sources.every(source=>source.disabled)} density="touch">{t(P['commerce.purchase.use'])}</Button>
+ </Form>
+</div>
+<style>.purchase-source{max-width:48rem;min-width:0;overflow-wrap:anywhere;color:var(--smrt-color-on-surface)}</style>

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

@@ -0,0 +1,30 @@
+import type { HTMLFormAttributes } from 'svelte/elements';
+import type { PurchaseSourceOption } from '../purchasing-types.js';
+/** Native source discovery; choosing a source never records a purchase or award. */
+export interface Props {
+    /** Authorized source options with caller-owned availability and labels. */
+    sources: PurchaseSourceOption[];
+    /** Selected source ID retained after a failed action. */
+    value?: string;
+    /** Native source-selection endpoint. */
+    action: string;
+    /** Field name expected by the caller's route. */
+    name?: string;
+    /** Caller-owned search/context fields. */
+    hiddenFields?: {
+        name: string;
+        value: string;
+    }[];
+    /** Presentation-only disabled capability. */
+    disabled?: boolean;
+    /** Optional field validation error. */
+    error?: string;
+    /** Optional localized field label. */
+    label?: string;
+    /** Optional caller enhancement; native GET remains enabled by default. */
+    onsubmit?: HTMLFormAttributes['onsubmit'];
+}
+declare const PurchaseSourceSelector: import("svelte").Component<Props, {}, "">;
+type PurchaseSourceSelector = ReturnType<typeof PurchaseSourceSelector>;
+export default PurchaseSourceSelector;
+//# sourceMappingURL=PurchaseSourceSelector.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PurchaseSourceSelector.svelte.d.ts","sourceRoot":"","sources":["../../../src/svelte/components/PurchaseSourceSelector.svelte.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,oFAAoF;AACpF,MAAM,WAAW,KAAK;IACpB,2EAA2E;IAC3E,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjD,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;CAC3C;AAwCD,QAAA,MAAM,sBAAsB,2CAAwC,CAAC;AACrE,KAAK,sBAAsB,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACxE,eAAe,sBAAsB,CAAC"}