@happyvertical/smrt-planner 0.0.0-stage → 0.0.1

package/dist/upstream/VendorSelect.svelte

@@ -0,0 +1,60 @@
+<!--
+  STAND-IN for `VendorSelect` of `@happyvertical/smrt-commerce/svelte`
+  (happyvertical/smrt#3602). Presentation-only: data comes from the caller's
+  `search(query)` and `resolve(id)`, which return the commerce party DTO
+  (`VendorDisplayData`, whose `profile.name` is the label). Shows the
+  profile name plus status, with an optional "New vendor" action.
+  Registered in `selects.ts` as the selector for
+  `@happyvertical/smrt-commerce:Vendor`. When #3602 ships, import the
+  published component and delete this file.
+-->
+<script lang="ts">
+import { RelationInput } from '@happyvertical/smrt-svelte/forms';
+import { vendorOption } from './partySelect.js';
+import type { VendorDisplayData } from './partyTypes.js';
+
+interface VendorSelectProps {
+  value?: string;
+  name: string;
+  label?: string;
+  required?: boolean;
+  disabled?: boolean;
+  error?: string;
+  search: (query: string) => Promise<VendorDisplayData[]>;
+  resolve: (id: string) => Promise<VendorDisplayData | null>;
+  onCreate?: () => void;
+  createLabel?: string;
+  onchange?: (id: string) => void;
+}
+
+let {
+  value = $bindable(''),
+  name,
+  label = 'Vendor',
+  required = false,
+  disabled = false,
+  error,
+  search,
+  resolve,
+  onCreate,
+  createLabel = 'New vendor',
+  onchange,
+}: VendorSelectProps = $props();
+</script>
+
+<RelationInput
+  bind:value
+  {name}
+  {label}
+  {required}
+  {disabled}
+  {error}
+  {onCreate}
+  {createLabel}
+  {onchange}
+  search={async (query) => (await search(query)).map(vendorOption)}
+  resolve={async (id) => {
+    const found = await resolve(id);
+    return found ? { id: found.id, label: found.profile.name } : null;
+  }}
+/>

package/dist/upstream/VendorSelect.svelte.d.ts

@@ -0,0 +1,17 @@
+import type { VendorDisplayData } from './partyTypes.ts';
+interface VendorSelectProps {
+    value?: string;
+    name: string;
+    label?: string;
+    required?: boolean;
+    disabled?: boolean;
+    error?: string;
+    search: (query: string) => Promise<VendorDisplayData[]>;
+    resolve: (id: string) => Promise<VendorDisplayData | null>;
+    onCreate?: () => void;
+    createLabel?: string;
+    onchange?: (id: string) => void;
+}
+declare const VendorSelect: import("svelte").Component<VendorSelectProps, {}, "value">;
+type VendorSelect = ReturnType<typeof VendorSelect>;
+export default VendorSelect;

package/dist/upstream/overlay.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Applies the local stand-ins (`widgets.ts`, `relations.ts`) to the
+ * generated catalog when it loads, so every consumer reads
+ * `field.ui.widget` and `field.related` exactly where the manifest will put
+ * them. Nothing already in the catalog is overwritten: once a package's
+ * manifest carries a value, it wins.
+ */
+import type { Catalog } from '../catalog/types.ts';
+/** The catalog with the stand-ins applied; the input is not modified. */
+export declare function applyUpstreamOverlay(catalog: Catalog): Catalog;

package/dist/upstream/overlay.js

@@ -0,0 +1,49 @@
+import { UNDECLARED_RELATIONS } from "./relations.js";
+import { FIELD_WIDGETS } from "./widgets.js";
+/** A model and its ancestors, nearest first (STI children inherit hints). */
+function lineage(model, all) {
+    const chain = [];
+    let current = model;
+    while (current && !chain.includes(current.id)) {
+        chain.push(current.id);
+        current = current.extends ? all.get(current.extends) : undefined;
+    }
+    return chain;
+}
+function lookup(table, chain, field) {
+    for (const id of chain) {
+        const found = table[id]?.[field];
+        if (found !== undefined)
+            return found;
+    }
+    return undefined;
+}
+function overlayField(field, chain) {
+    let next = field;
+    const widget = field.ui?.widget
+        ? undefined
+        : lookup(FIELD_WIDGETS, chain, field.name);
+    if (widget)
+        next = { ...next, ui: { ...next.ui, widget } };
+    if (!field.related) {
+        const target = lookup(UNDECLARED_RELATIONS, chain, field.name);
+        if (target)
+            next = { ...next, type: 'foreignKey', related: target };
+    }
+    return next;
+}
+/** The catalog with the stand-ins applied; the input is not modified. */
+export function applyUpstreamOverlay(catalog) {
+    const all = new Map(catalog.packages.flatMap((pkg) => pkg.models.map((m) => [m.id, m])));
+    const packages = catalog.packages.map((pkg) => ({
+        ...pkg,
+        models: pkg.models.map((model) => {
+            const chain = lineage(model, all);
+            return {
+                ...model,
+                fields: model.fields.map((field) => overlayField(field, chain)),
+            };
+        }),
+    }));
+    return { ...catalog, packages };
+}

package/dist/upstream/partySelect.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared by the `CustomerSelect` / `VendorSelect` stand-ins (see those files):
+ * a party DTO as a picker option, "profile name plus status and type".
+ */
+import type { RelationOption } from '@happyvertical/smrt-svelte/forms';
+import type { CustomerDisplayData, VendorDisplayData } from './partyTypes.ts';
+export declare function customerOption(customer: CustomerDisplayData): RelationOption;
+export declare function vendorOption(vendor: VendorDisplayData): RelationOption;

package/dist/upstream/partySelect.js

@@ -0,0 +1,21 @@
+/**
+ * Shared by the `CustomerSelect` / `VendorSelect` stand-ins (see those files):
+ * a party DTO as a picker option, "profile name plus status and type".
+ */
+export function customerOption(customer) {
+    const detail = [customer.status, customer.customerType]
+        .filter(Boolean)
+        .join(' · ');
+    return {
+        id: customer.id,
+        label: customer.profile.name,
+        ...(detail ? { detail } : {}),
+    };
+}
+export function vendorOption(vendor) {
+    return {
+        id: vendor.id,
+        label: vendor.profile.name,
+        ...(vendor.status ? { detail: vendor.status } : {}),
+    };
+}

package/dist/upstream/partyTypes.d.ts

@@ -0,0 +1,64 @@
+/**
+ * STAND-IN for the party DTOs of `@happyvertical/smrt-commerce/svelte`
+ * (`packages/commerce/src/svelte/party-types.ts`, happyvertical/smrt#3602
+ * builds `CustomerSelect` / `VendorSelect` on them). Copied verbatim, minus the
+ * form and directory types the selectors do not use. When #3602 ships, import
+ * these from the published package and delete this file.
+ */
+export type PartyIdentityKind = 'business' | 'person';
+/** Public Profile-shaped identity data accepted by customer and vendor surfaces. */
+export interface PartyProfileData {
+    id?: string;
+    name: string;
+    email?: string;
+    description?: string;
+    identityKind?: PartyIdentityKind;
+}
+export interface PartyContactData {
+    id?: string;
+    name?: string;
+    label?: string;
+    email?: string;
+    phone?: string;
+    address?: string;
+}
+export interface PartyAddressData {
+    street1?: string;
+    street2?: string;
+    city?: string;
+    state?: string;
+    postalCode?: string;
+    country?: string;
+}
+/** Customer DTO for UI rendering. Money is always an integer count of currency minor units. */
+export interface CustomerDisplayData {
+    id: string;
+    profileId?: string;
+    profile: PartyProfileData;
+    status: string;
+    customerType?: string;
+    /** Credit limit in integer minor units, never decimal major units. */
+    creditLimitMinor?: number;
+    paymentTerms?: string;
+    taxExempt?: boolean;
+    defaultShippingAddress?: PartyAddressData;
+    defaultBillingAddress?: PartyAddressData;
+    notes?: string;
+    contacts?: PartyContactData[];
+}
+/** Vendor DTO for UI rendering. Money is always an integer count of currency minor units. */
+export interface VendorDisplayData {
+    id: string;
+    profileId?: string;
+    profile: PartyProfileData;
+    status: string;
+    leadTimeDays?: number;
+    /** Minimum order in integer minor units, never decimal major units. */
+    minimumOrderMinor?: number;
+    paymentTerms?: string;
+    currency?: string;
+    defaultContactEmail?: string;
+    defaultContactPhone?: string;
+    notes?: string;
+    contacts?: PartyContactData[];
+}

package/dist/upstream/partyTypes.js

@@ -0,0 +1,8 @@
+/**
+ * STAND-IN for the party DTOs of `@happyvertical/smrt-commerce/svelte`
+ * (`packages/commerce/src/svelte/party-types.ts`, happyvertical/smrt#3602
+ * builds `CustomerSelect` / `VendorSelect` on them). Copied verbatim, minus the
+ * form and directory types the selectors do not use. When #3602 ships, import
+ * these from the published package and delete this file.
+ */
+export {};

package/dist/upstream/relations.d.ts

@@ -0,0 +1,2 @@
+/** Target model by qualified model name, then field name. */
+export declare const UNDECLARED_RELATIONS: Readonly<Record<string, Readonly<Record<string, string>>>>;

package/dist/upstream/relations.js

@@ -0,0 +1,24 @@
+/**
+ * Relations the manifest does not declare yet. Some models name a related row
+ * in a plain `text` field (inventory's `StockLevel.skuId`, products' `Sku`
+ * `productId`) with no `@foreignKey`, so the catalog types them `text` and a
+ * form would show an id box. That is a gap in those packages, not a planner
+ * concern: the fix is `@foreignKey(Target)` on the field upstream. Until then
+ * `overlay.ts` types these as `foreignKey` so they get a selector.
+ */
+const INVENTORY = '@happyvertical/smrt-inventory';
+const PRODUCTS = '@happyvertical/smrt-products';
+/** Target model by qualified model name, then field name. */
+export const UNDECLARED_RELATIONS = {
+    [`${INVENTORY}:StockLevel`]: {
+        skuId: `${PRODUCTS}:Sku`,
+        locationId: `${INVENTORY}:InventoryLocation`,
+    },
+    [`${PRODUCTS}:Sku`]: {
+        productId: `${PRODUCTS}:Product`,
+        parentSkuId: `${PRODUCTS}:Sku`,
+    },
+    [`${PRODUCTS}:ProductVariant`]: {
+        productId: `${PRODUCTS}:Product`,
+    },
+};

package/dist/upstream/selects.d.ts

@@ -0,0 +1,26 @@
+/**
+ * STAND-IN for `ModuleUISlot.selects` / `uiSelectors` (happyvertical/smrt#3611; not in the published 0.55.3 manifests): a package UI
+ * component marked as THE selector for model X, and the host helper "selector
+ * for model X". Generic forms use it for any `foreignKey` / `crossPackageRef`
+ * field whose target is X.
+ *
+ * `SelectorSlot` has the slot's `selects` key as the issue names it
+ * (`QualifiedClassName`); `kind` and `component` are the host side (what the
+ * planner needs to render it, not manifest data). When #3599 and #3602 ship,
+ * read the slots from the packages' manifests (`COMMERCE_UI_SLOTS`) and keep
+ * only the `kind` to component table.
+ */
+import type { Component } from 'svelte';
+/** A slot, as in `COMMERCE_UI_SLOTS` of happyvertical/smrt#3602. */
+export interface SelectorSlot {
+    /** The slot's component name in the package's `./svelte` export. */
+    name: string;
+    /** `selects`: the model this component picks (`@scope/pkg:Class`). */
+    selects: string;
+    /** Which party DTO the component's `search` and `resolve` speak. */
+    kind: 'customer' | 'vendor';
+    component: Component<any>;
+}
+export declare const SELECTOR_SLOTS: readonly SelectorSlot[];
+/** The registered selector for a model, if there is one. */
+export declare function selectorFor(qualifiedModel: string, slots?: readonly SelectorSlot[]): SelectorSlot | undefined;

package/dist/upstream/selects.js

@@ -0,0 +1,20 @@
+import CustomerSelect from './CustomerSelect.svelte';
+import VendorSelect from './VendorSelect.svelte';
+export const SELECTOR_SLOTS = [
+    {
+        name: 'CustomerSelect',
+        selects: '@happyvertical/smrt-commerce:Customer',
+        kind: 'customer',
+        component: CustomerSelect,
+    },
+    {
+        name: 'VendorSelect',
+        selects: '@happyvertical/smrt-commerce:Vendor',
+        kind: 'vendor',
+        component: VendorSelect,
+    },
+];
+/** The registered selector for a model, if there is one. */
+export function selectorFor(qualifiedModel, slots = SELECTOR_SLOTS) {
+    return slots.find((slot) => slot.selects === qualifiedModel);
+}

package/dist/upstream/widgets.d.ts

@@ -0,0 +1,20 @@
+/**
+ * STAND-IN for `_meta.ui.widget` in the manifest (happyvertical/smrt#3611) and
+ * the field hints happyvertical/smrt#3602 puts on commerce.
+ *
+ * The published 0.55.3 manifests carry no `ui.widget`, so this lists the hints
+ * for the fields the recipes show; `overlay.ts` writes them onto the catalog's
+ * `field.ui.widget` when it loads (the generator already reads the manifest's
+ * value when present). When a package ships it: regenerate the catalog and
+ * delete that package's entries here.
+ */
+import type { CatalogFieldWidget } from '../catalog/types.ts';
+/** Widget by qualified model name, then field name (STI children inherit). */
+export declare const FIELD_WIDGETS: Readonly<Record<string, Readonly<Record<string, CatalogFieldWidget>>>>;
+/**
+ * NOT part of #3599, whose widget list has no address entry: JSON fields that
+ * hold an Address (`defaultShippingAddress` and the like), which the form
+ * shows with `AddressInput`. Upstream the field's type is only `json`, so the
+ * planner names them here; if the manifest ever types them, drop this.
+ */
+export declare const ADDRESS_FIELDS: Readonly<Record<string, readonly string[]>>;

package/dist/upstream/widgets.js

@@ -0,0 +1,30 @@
+const COMMERCE = '@happyvertical/smrt-commerce';
+/** Widget by qualified model name, then field name (STI children inherit). */
+export const FIELD_WIDGETS = {
+    [`${COMMERCE}:Contract`]: {
+        terms: 'textarea',
+        notes: 'textarea',
+        currency: 'currency',
+    },
+    [`${COMMERCE}:Customer`]: { notes: 'textarea' },
+    [`${COMMERCE}:Vendor`]: {
+        notes: 'textarea',
+        currency: 'currency',
+        defaultContactEmail: 'email',
+        defaultContactPhone: 'phone',
+    },
+    '@happyvertical/smrt-profiles:Profile': {
+        email: 'email',
+        description: 'textarea',
+    },
+    '@happyvertical/smrt-products:Product': { description: 'textarea' },
+};
+/**
+ * NOT part of #3599, whose widget list has no address entry: JSON fields that
+ * hold an Address (`defaultShippingAddress` and the like), which the form
+ * shows with `AddressInput`. Upstream the field's type is only `json`, so the
+ * planner names them here; if the manifest ever types them, drop this.
+ */
+export const ADDRESS_FIELDS = {
+    [`${COMMERCE}:Customer`]: ['defaultShippingAddress', 'defaultBillingAddress'],
+};

package/package.json

@@ -1,6 +1,83 @@
 {
   "name": "@happyvertical/smrt-planner",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.0.1",
+  "type": "module",
+  "license": "MIT",
+  "description": "The smrt planner as a mountable Svelte component with a typed command set and plan snapshot.",
+  "svelte": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "app"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "svelte": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core/index.d.ts",
+      "default": "./dist/core/index.js"
+    },
+    "./app": {
+      "types": "./dist/core/app.d.ts",
+      "default": "./dist/core/app.js"
+    },
+    "./app/*": "./app/*",
+    "./commands": {
+      "types": "./dist/planner/commands/index.d.ts",
+      "default": "./dist/planner/commands/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=26.0.0",
+    "pnpm": "11.25.0"
+  },
+  "dependencies": {
+    "@happyvertical/ai": "^0.103.1",
+    "@happyvertical/smrt-chat": "^0.55.12",
+    "@happyvertical/smrt-core": "^0.55.12",
+    "@happyvertical/smrt-svelte": "^0.55.12",
+    "@happyvertical/smrt-ui": "^0.55.12",
+    "@happyvertical/speech": "^0.103.1",
+    "@huggingface/transformers": "^4.3.0",
+    "@mlc-ai/web-llm": "^0.2.85"
+  },
+  "peerDependencies": {
+    "@sveltejs/kit": "^2.0.0",
+    "svelte": "^5.57.1"
+  },
+  "peerDependenciesMeta": {
+    "@sveltejs/kit": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.3",
+    "@sveltejs/adapter-static": "^3.0.10",
+    "@sveltejs/kit": "2.70.3",
+    "@sveltejs/package": "^3.0.0",
+    "@sveltejs/vite-plugin-svelte": "^7.3.0",
+    "@types/node": "^24.13.6",
+    "publint": "^0.3.25",
+    "svelte": "^5.57.1",
+    "svelte-check": "^4.7.6",
+    "typescript": "6.0.3",
+    "vite": "8.3.0",
+    "vitest": "4.1.10"
+  },
+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build",
+    "preview": "vite preview",
+    "catalog:generate": "node scripts/generate-catalog.ts",
+    "typecheck": "svelte-kit sync && tsc --noEmit -p tsconfig.json && svelte-check --tsconfig ./tsconfig.json",
+    "test": "vitest run",
+    "test:package": "node scripts/test-packed-package.mjs",
+    "test:release-workflow": "node scripts/test-release-workflow.mjs",
+    "lint": "biome ci .",
+    "package": "svelte-package -i src/lib -o dist --tsconfig tsconfig.package.json && node scripts/package-app.ts && publint"
+  }
 }