@withpotter/components 0.13.0-next.101

package/dist/intent/sections/shipping-info-section.js

@@ -0,0 +1,64 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Truck, ExternalLink } from "lucide-react";
+import { cityLine, hasAddress } from "@withpotter/lib/order-shipping";
+function ShippingInfoSection({ data }) {
+  const order = data;
+  if (!order) return null;
+  const bag = order.data ?? {};
+  const trackingNumber = typeof bag.trackingNumber === "string" ? bag.trackingNumber : void 0;
+  const trackingUrl = typeof bag.trackingUrl === "string" ? bag.trackingUrl : void 0;
+  const estimatedDelivery = typeof bag.estimatedDelivery === "string" ? bag.estimatedDelivery : void 0;
+  const addr = hasAddress(order.shippingAddress) ? order.shippingAddress : void 0;
+  if (!addr && !trackingNumber && !estimatedDelivery) return null;
+  return /* @__PURE__ */ jsxs("div", { className: "overflow-hidden rounded-xl border border-[var(--border-default)] bg-[var(--bg-elevated)]", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 border-b border-[var(--border-default)] px-4 py-3", children: [
+      /* @__PURE__ */ jsx(Truck, { className: "h-[15px] w-[15px] text-[var(--text-tertiary)]" }),
+      /* @__PURE__ */ jsx("h3", { className: "text-sm font-semibold text-[var(--text-primary)]", children: "Shipping" })
+    ] }),
+    /* @__PURE__ */ jsxs("div", { className: "space-y-3 px-4 py-3 text-sm", children: [
+      addr && /* @__PURE__ */ jsxs("address", { className: "not-italic leading-relaxed text-[var(--text-secondary)]", children: [
+        (addr.firstName || addr.lastName) && /* @__PURE__ */ jsx("span", { className: "block font-medium text-[var(--text-primary)]", children: [addr.firstName, addr.lastName].filter(Boolean).join(" ") }),
+        addr.company && /* @__PURE__ */ jsx("span", { className: "block", children: addr.company }),
+        addr.address1 && /* @__PURE__ */ jsx("span", { className: "block", children: addr.address1 }),
+        addr.address2 && /* @__PURE__ */ jsx("span", { className: "block", children: addr.address2 }),
+        cityLine(addr) && /* @__PURE__ */ jsx("span", { className: "block", children: cityLine(addr) }),
+        addr.country && /* @__PURE__ */ jsx("span", { className: "block", children: addr.country }),
+        addr.phone && /* @__PURE__ */ jsx(
+          "a",
+          {
+            href: `tel:${addr.phone}`,
+            className: "mt-1 block text-brand-500 transition-colors hover:text-brand-600",
+            children: addr.phone
+          }
+        )
+      ] }),
+      (trackingNumber || estimatedDelivery) && /* @__PURE__ */ jsxs("dl", { className: "space-y-2 border-t border-[var(--border-subtle)] pt-3", children: [
+        trackingNumber && /* @__PURE__ */ jsxs("div", { className: "flex items-baseline justify-between gap-3", children: [
+          /* @__PURE__ */ jsx("dt", { className: "text-[var(--text-tertiary)]", children: "Tracking" }),
+          /* @__PURE__ */ jsx("dd", { className: "min-w-0 truncate font-medium text-[var(--text-primary)]", children: trackingUrl ? /* @__PURE__ */ jsxs(
+            "a",
+            {
+              href: trackingUrl,
+              target: "_blank",
+              rel: "noopener noreferrer",
+              className: "inline-flex items-center gap-1 text-brand-500 transition-colors hover:text-brand-600",
+              children: [
+                trackingNumber,
+                /* @__PURE__ */ jsx(ExternalLink, { className: "flex-shrink-0" })
+              ]
+            }
+          ) : trackingNumber })
+        ] }),
+        estimatedDelivery && /* @__PURE__ */ jsxs("div", { className: "flex items-baseline justify-between gap-3", children: [
+          /* @__PURE__ */ jsx("dt", { className: "text-[var(--text-tertiary)]", children: "Estimated delivery" }),
+          /* @__PURE__ */ jsx("dd", { className: "font-medium text-[var(--text-primary)]", children: estimatedDelivery })
+        ] })
+      ] })
+    ] })
+  ] });
+}
+export {
+  ShippingInfoSection
+};
+//# sourceMappingURL=shipping-info-section.js.map

package/dist/intent/sections/shipping-info-section.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/intent/sections/shipping-info-section.tsx"],"sourcesContent":["'use client';\n\nimport { Truck, ExternalLink } from 'lucide-react';\nimport type { SectionProps } from '@withpotter/lib/intents/section-registry';\nimport type { Order } from '@withpotter/lib/api/types';\nimport { cityLine, hasAddress } from '@withpotter/lib/order-shipping';\n\n/**\n * Where it is going and where it has got to.\n *\n * Declared by sell-products and default-commerce and never registered, so the\n * two archetypes that actually ship things had no shipping panel on the order.\n *\n * Tracking lives in `order.data`, not on a column — update-fulfillment-status\n * stuffs it there with a comment saying the order has no tracking column. Read\n * from the same place rather than inventing a second convention.\n */\nexport function ShippingInfoSection({ data }: SectionProps) {\n  const order = data as unknown as Order | undefined;\n  if (!order) return null;\n\n  const bag = (order.data ?? {}) as Record<string, unknown>;\n  const trackingNumber =\n    typeof bag.trackingNumber === 'string' ? bag.trackingNumber : undefined;\n  const trackingUrl =\n    typeof bag.trackingUrl === 'string' ? bag.trackingUrl : undefined;\n  const estimatedDelivery =\n    typeof bag.estimatedDelivery === 'string'\n      ? bag.estimatedDelivery\n      : undefined;\n  // A walk-in sale's address is all empty strings; that is no address.\n  const addr = hasAddress(order.shippingAddress) ? order.shippingAddress : undefined;\n\n  // Nothing to show is not the same as a panel full of dashes.\n  if (!addr && !trackingNumber && !estimatedDelivery) return null;\n\n  return (\n    <div className=\"overflow-hidden rounded-xl border border-[var(--border-default)] bg-[var(--bg-elevated)]\">\n      <div className=\"flex items-center gap-2 border-b border-[var(--border-default)] px-4 py-3\">\n        <Truck className=\"h-[15px] w-[15px] text-[var(--text-tertiary)]\" />\n        <h3 className=\"text-sm font-semibold text-[var(--text-primary)]\">\n          Shipping\n        </h3>\n      </div>\n\n      <div className=\"space-y-3 px-4 py-3 text-sm\">\n        {addr && (\n          <address className=\"not-italic leading-relaxed text-[var(--text-secondary)]\">\n            {(addr.firstName || addr.lastName) && (\n              <span className=\"block font-medium text-[var(--text-primary)]\">\n                {[addr.firstName, addr.lastName].filter(Boolean).join(' ')}\n              </span>\n            )}\n            {addr.company && <span className=\"block\">{addr.company}</span>}\n            {addr.address1 && <span className=\"block\">{addr.address1}</span>}\n            {addr.address2 && <span className=\"block\">{addr.address2}</span>}\n            {cityLine(addr) && <span className=\"block\">{cityLine(addr)}</span>}\n            {addr.country && <span className=\"block\">{addr.country}</span>}\n            {addr.phone && (\n              <a\n                href={`tel:${addr.phone}`}\n                className=\"mt-1 block text-brand-500 transition-colors hover:text-brand-600\"\n              >\n                {addr.phone}\n              </a>\n            )}\n          </address>\n        )}\n\n        {(trackingNumber || estimatedDelivery) && (\n          <dl className=\"space-y-2 border-t border-[var(--border-subtle)] pt-3\">\n            {trackingNumber && (\n              <div className=\"flex items-baseline justify-between gap-3\">\n                <dt className=\"text-[var(--text-tertiary)]\">Tracking</dt>\n                <dd className=\"min-w-0 truncate font-medium text-[var(--text-primary)]\">\n                  {trackingUrl ? (\n                    <a\n                      href={trackingUrl}\n                      target=\"_blank\"\n                      rel=\"noopener noreferrer\"\n                      className=\"inline-flex items-center gap-1 text-brand-500 transition-colors hover:text-brand-600\"\n                    >\n                      {trackingNumber}\n                      <ExternalLink className=\"flex-shrink-0\" />\n                    </a>\n                  ) : (\n                    trackingNumber\n                  )}\n                </dd>\n              </div>\n            )}\n            {estimatedDelivery && (\n              <div className=\"flex items-baseline justify-between gap-3\">\n                <dt className=\"text-[var(--text-tertiary)]\">\n                  Estimated delivery\n                </dt>\n                <dd className=\"font-medium text-[var(--text-primary)]\">\n                  {estimatedDelivery}\n                </dd>\n              </div>\n            )}\n          </dl>\n        )}\n      </div>\n    </div>\n  );\n}\n"],"mappings":";AAsCM,SACE,KADF;AApCN,SAAS,OAAO,oBAAoB;AAGpC,SAAS,UAAU,kBAAkB;AAY9B,SAAS,oBAAoB,EAAE,KAAK,GAAiB;AAC1D,QAAM,QAAQ;AACd,MAAI,CAAC,MAAO,QAAO;AAEnB,QAAM,MAAO,MAAM,QAAQ,CAAC;AAC5B,QAAM,iBACJ,OAAO,IAAI,mBAAmB,WAAW,IAAI,iBAAiB;AAChE,QAAM,cACJ,OAAO,IAAI,gBAAgB,WAAW,IAAI,cAAc;AAC1D,QAAM,oBACJ,OAAO,IAAI,sBAAsB,WAC7B,IAAI,oBACJ;AAEN,QAAM,OAAO,WAAW,MAAM,eAAe,IAAI,MAAM,kBAAkB;AAGzE,MAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,kBAAmB,QAAO;AAE3D,SACE,qBAAC,SAAI,WAAU,4FACb;AAAA,yBAAC,SAAI,WAAU,6EACb;AAAA,0BAAC,SAAM,WAAU,iDAAgD;AAAA,MACjE,oBAAC,QAAG,WAAU,oDAAmD,sBAEjE;AAAA,OACF;AAAA,IAEA,qBAAC,SAAI,WAAU,+BACZ;AAAA,cACC,qBAAC,aAAQ,WAAU,2DACf;AAAA,cAAK,aAAa,KAAK,aACvB,oBAAC,UAAK,WAAU,gDACb,WAAC,KAAK,WAAW,KAAK,QAAQ,EAAE,OAAO,OAAO,EAAE,KAAK,GAAG,GAC3D;AAAA,QAED,KAAK,WAAW,oBAAC,UAAK,WAAU,SAAS,eAAK,SAAQ;AAAA,QACtD,KAAK,YAAY,oBAAC,UAAK,WAAU,SAAS,eAAK,UAAS;AAAA,QACxD,KAAK,YAAY,oBAAC,UAAK,WAAU,SAAS,eAAK,UAAS;AAAA,QACxD,SAAS,IAAI,KAAK,oBAAC,UAAK,WAAU,SAAS,mBAAS,IAAI,GAAE;AAAA,QAC1D,KAAK,WAAW,oBAAC,UAAK,WAAU,SAAS,eAAK,SAAQ;AAAA,QACtD,KAAK,SACJ;AAAA,UAAC;AAAA;AAAA,YACC,MAAM,OAAO,KAAK,KAAK;AAAA,YACvB,WAAU;AAAA,YAET,eAAK;AAAA;AAAA,QACR;AAAA,SAEJ;AAAA,OAGA,kBAAkB,sBAClB,qBAAC,QAAG,WAAU,yDACX;AAAA,0BACC,qBAAC,SAAI,WAAU,6CACb;AAAA,8BAAC,QAAG,WAAU,+BAA8B,sBAAQ;AAAA,UACpD,oBAAC,QAAG,WAAU,2DACX,wBACC;AAAA,YAAC;AAAA;AAAA,cACC,MAAM;AAAA,cACN,QAAO;AAAA,cACP,KAAI;AAAA,cACJ,WAAU;AAAA,cAET;AAAA;AAAA,gBACD,oBAAC,gBAAa,WAAU,iBAAgB;AAAA;AAAA;AAAA,UAC1C,IAEA,gBAEJ;AAAA,WACF;AAAA,QAED,qBACC,qBAAC,SAAI,WAAU,6CACb;AAAA,8BAAC,QAAG,WAAU,+BAA8B,gCAE5C;AAAA,UACA,oBAAC,QAAG,WAAU,0CACX,6BACH;AAAA,WACF;AAAA,SAEJ;AAAA,OAEJ;AAAA,KACF;AAEJ;","names":[]}

package/dist/intent/sections/subscription-details-section.d.ts

@@ -0,0 +1,2 @@
+import type { SectionProps } from '@withpotter/lib/intents/section-registry';
+export declare function SubscriptionDetailsSection({ data }: SectionProps): import("react").JSX.Element | null;

package/dist/intent/sections/subscription-details-section.js

@@ -0,0 +1,77 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { AlertCircle, RefreshCw } from "lucide-react";
+import { useApiQuery } from "@withpotter/hooks/use-api-query";
+import { merchantSubscriptionsApi } from "@withpotter/lib/api/merchant-subscriptions";
+import { useFormatCurrency } from "@withpotter/hooks/use-format-currency";
+import { Badge } from "@withpotter/ui-kit";
+const STATUS_LABEL = {
+  active: "Active",
+  non_renewing: "Non-renewing",
+  attention: "Needs attention",
+  cancelled: "Cancelled",
+  completed: "Completed"
+};
+function intervalLabel(subscription) {
+  const plan = subscription.plan;
+  if (!plan?.interval) return "";
+  const every = plan.intervalCount && plan.intervalCount > 1 ? `every ${plan.intervalCount} ` : "every ";
+  return `${every}${plan.interval}`;
+}
+function SubscriptionDetailsSection({ data }) {
+  const formatCurrency = useFormatCurrency();
+  const order = data;
+  const customerId = order?.memberId;
+  const { data: result, isLoading } = useApiQuery(
+    ["order-subscriptions", customerId],
+    (slug) => merchantSubscriptionsApi.listSubscriptions(slug, {
+      customerId,
+      limit: 5
+    }),
+    { enabled: Boolean(customerId) }
+  );
+  const subscriptions = result?.subscriptions ?? [];
+  if (isLoading || subscriptions.length === 0) return null;
+  return /* @__PURE__ */ jsxs("div", { className: "overflow-hidden rounded-xl border border-[var(--border-default)] bg-[var(--bg-elevated)]", children: [
+    /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 border-b border-[var(--border-default)] px-4 py-3", children: [
+      /* @__PURE__ */ jsx(RefreshCw, { className: "h-[15px] w-[15px] text-[var(--text-tertiary)]" }),
+      /* @__PURE__ */ jsx("h3", { className: "text-sm font-semibold text-[var(--text-primary)]", children: "Membership" })
+    ] }),
+    /* @__PURE__ */ jsx("ul", { className: "divide-y divide-[var(--border-subtle)]", children: subscriptions.map((subscription) => {
+      const needsAttention = subscription.status === "attention";
+      return /* @__PURE__ */ jsxs(
+        "li",
+        {
+          className: "flex items-center justify-between gap-3 px-4 py-3 text-sm",
+          children: [
+            /* @__PURE__ */ jsxs("div", { className: "min-w-0", children: [
+              /* @__PURE__ */ jsx("p", { className: "truncate text-[var(--text-primary)]", children: subscription.plan?.name ?? "Plan" }),
+              /* @__PURE__ */ jsxs("p", { className: "truncate text-xs text-[var(--text-tertiary)]", children: [
+                formatCurrency(
+                  subscription.amount / 100,
+                  subscription.currency
+                ),
+                intervalLabel(subscription) ? ` \xB7 ${intervalLabel(subscription)}` : "",
+                subscription.nextPaymentDate ? ` \xB7 renews ${new Date(
+                  subscription.nextPaymentDate
+                ).toLocaleDateString("en-US", {
+                  day: "numeric",
+                  month: "short"
+                })}` : ""
+              ] })
+            ] }),
+            needsAttention ? /* @__PURE__ */ jsxs(Badge, { variant: "warning", className: "flex-shrink-0 gap-1", children: [
+              /* @__PURE__ */ jsx(AlertCircle, {}),
+              STATUS_LABEL.attention
+            ] }) : /* @__PURE__ */ jsx(Badge, { className: "flex-shrink-0", children: STATUS_LABEL[subscription.status] ?? subscription.status })
+          ]
+        },
+        subscription.id
+      );
+    }) })
+  ] });
+}
+export {
+  SubscriptionDetailsSection
+};
+//# sourceMappingURL=subscription-details-section.js.map

package/dist/intent/sections/subscription-details-section.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/intent/sections/subscription-details-section.tsx"],"sourcesContent":["'use client';\n\nimport { AlertCircle, RefreshCw } from 'lucide-react';\nimport type { SectionProps } from '@withpotter/lib/intents/section-registry';\nimport { useApiQuery } from '@withpotter/hooks/use-api-query';\nimport { merchantSubscriptionsApi } from '@withpotter/lib/api/merchant-subscriptions';\nimport { useFormatCurrency } from '@withpotter/hooks/use-format-currency';\nimport type { CustomerSubscription } from '@withpotter/lib/api/types';\nimport { Badge } from '@withpotter/ui-kit';\n\n/**\n * What this payment is against.\n *\n * `subscriptions` declared `subscription-details` in its order detail and\n * nothing ever registered it. Unregistered keys are skipped in silence, so a\n * membership business opened a payment and saw a header, a total and a\n * timeline — and no plan, no interval, no renewal date. The one thing that\n * makes it a subscription rather than a one-off was the missing panel.\n *\n * Three sections had already been fixed for exactly this reason and each is\n * commented in `register-sections.ts` as its own discovery. This was the\n * fourth, found by comparing the two lists rather than by opening the page.\n *\n * Subscriptions are keyed by customer, not by order, so this reads the\n * customer's — which is the honest answer to \"what is this payment part of\".\n */\nconst STATUS_LABEL: Record<string, string> = {\n  active: 'Active',\n  non_renewing: 'Non-renewing',\n  attention: 'Needs attention',\n  cancelled: 'Cancelled',\n  completed: 'Completed',\n};\n\nfunction intervalLabel(subscription: CustomerSubscription): string {\n  const plan = subscription.plan;\n  if (!plan?.interval) return '';\n  const every =\n    plan.intervalCount && plan.intervalCount > 1\n      ? `every ${plan.intervalCount} `\n      : 'every ';\n  return `${every}${plan.interval}`;\n}\n\nexport function SubscriptionDetailsSection({ data }: SectionProps) {\n  const formatCurrency = useFormatCurrency();\n  const order = data as\n    { memberId?: string; customerEmail?: string } | undefined;\n  const customerId = order?.memberId;\n\n  const { data: result, isLoading } = useApiQuery(\n    ['order-subscriptions', customerId],\n    (slug) =>\n      merchantSubscriptionsApi.listSubscriptions(slug, {\n        customerId,\n        limit: 5,\n      }),\n    { enabled: Boolean(customerId) },\n  );\n\n  const subscriptions = result?.subscriptions ?? [];\n  // Nothing to say rather than an empty panel — the same rule the other\n  // sections follow, and the reason a one-off payment inside a membership\n  // business does not grow a blank box.\n  if (isLoading || subscriptions.length === 0) return null;\n\n  return (\n    <div className=\"overflow-hidden rounded-xl border border-[var(--border-default)] bg-[var(--bg-elevated)]\">\n      <div className=\"flex items-center gap-2 border-b border-[var(--border-default)] px-4 py-3\">\n        <RefreshCw className=\"h-[15px] w-[15px] text-[var(--text-tertiary)]\" />\n        <h3 className=\"text-sm font-semibold text-[var(--text-primary)]\">\n          Membership\n        </h3>\n      </div>\n\n      <ul className=\"divide-y divide-[var(--border-subtle)]\">\n        {subscriptions.map((subscription) => {\n          const needsAttention = subscription.status === 'attention';\n          return (\n            <li\n              key={subscription.id}\n              className=\"flex items-center justify-between gap-3 px-4 py-3 text-sm\"\n            >\n              <div className=\"min-w-0\">\n                <p className=\"truncate text-[var(--text-primary)]\">\n                  {subscription.plan?.name ?? 'Plan'}\n                </p>\n                <p className=\"truncate text-xs text-[var(--text-tertiary)]\">\n                  {formatCurrency(\n                    subscription.amount / 100,\n                    subscription.currency,\n                  )}\n                  {intervalLabel(subscription)\n                    ? ` · ${intervalLabel(subscription)}`\n                    : ''}\n                  {subscription.nextPaymentDate\n                    ? ` · renews ${new Date(\n                        subscription.nextPaymentDate,\n                      ).toLocaleDateString('en-US', {\n                        day: 'numeric',\n                        month: 'short',\n                      })}`\n                    : ''}\n                </p>\n              </div>\n\n              {/* A failed payment is the only state here that needs a person. */}\n              {needsAttention ? (\n                <Badge variant=\"warning\" className=\"flex-shrink-0 gap-1\">\n                  <AlertCircle />\n                  {STATUS_LABEL.attention}\n                </Badge>\n              ) : (\n                <Badge className=\"flex-shrink-0\">\n                  {STATUS_LABEL[subscription.status] ?? subscription.status}\n                </Badge>\n              )}\n            </li>\n          );\n        })}\n      </ul>\n    </div>\n  );\n}\n"],"mappings":";AAoEM,SACE,KADF;AAlEN,SAAS,aAAa,iBAAiB;AAEvC,SAAS,mBAAmB;AAC5B,SAAS,gCAAgC;AACzC,SAAS,yBAAyB;AAElC,SAAS,aAAa;AAkBtB,MAAM,eAAuC;AAAA,EAC3C,QAAQ;AAAA,EACR,cAAc;AAAA,EACd,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AACb;AAEA,SAAS,cAAc,cAA4C;AACjE,QAAM,OAAO,aAAa;AAC1B,MAAI,CAAC,MAAM,SAAU,QAAO;AAC5B,QAAM,QACJ,KAAK,iBAAiB,KAAK,gBAAgB,IACvC,SAAS,KAAK,aAAa,MAC3B;AACN,SAAO,GAAG,KAAK,GAAG,KAAK,QAAQ;AACjC;AAEO,SAAS,2BAA2B,EAAE,KAAK,GAAiB;AACjE,QAAM,iBAAiB,kBAAkB;AACzC,QAAM,QAAQ;AAEd,QAAM,aAAa,OAAO;AAE1B,QAAM,EAAE,MAAM,QAAQ,UAAU,IAAI;AAAA,IAClC,CAAC,uBAAuB,UAAU;AAAA,IAClC,CAAC,SACC,yBAAyB,kBAAkB,MAAM;AAAA,MAC/C;AAAA,MACA,OAAO;AAAA,IACT,CAAC;AAAA,IACH,EAAE,SAAS,QAAQ,UAAU,EAAE;AAAA,EACjC;AAEA,QAAM,gBAAgB,QAAQ,iBAAiB,CAAC;AAIhD,MAAI,aAAa,cAAc,WAAW,EAAG,QAAO;AAEpD,SACE,qBAAC,SAAI,WAAU,4FACb;AAAA,yBAAC,SAAI,WAAU,6EACb;AAAA,0BAAC,aAAU,WAAU,iDAAgD;AAAA,MACrE,oBAAC,QAAG,WAAU,oDAAmD,wBAEjE;AAAA,OACF;AAAA,IAEA,oBAAC,QAAG,WAAU,0CACX,wBAAc,IAAI,CAAC,iBAAiB;AACnC,YAAM,iBAAiB,aAAa,WAAW;AAC/C,aACE;AAAA,QAAC;AAAA;AAAA,UAEC,WAAU;AAAA,UAEV;AAAA,iCAAC,SAAI,WAAU,WACb;AAAA,kCAAC,OAAE,WAAU,uCACV,uBAAa,MAAM,QAAQ,QAC9B;AAAA,cACA,qBAAC,OAAE,WAAU,gDACV;AAAA;AAAA,kBACC,aAAa,SAAS;AAAA,kBACtB,aAAa;AAAA,gBACf;AAAA,gBACC,cAAc,YAAY,IACvB,SAAM,cAAc,YAAY,CAAC,KACjC;AAAA,gBACH,aAAa,kBACV,gBAAa,IAAI;AAAA,kBACf,aAAa;AAAA,gBACf,EAAE,mBAAmB,SAAS;AAAA,kBAC5B,KAAK;AAAA,kBACL,OAAO;AAAA,gBACT,CAAC,CAAC,KACF;AAAA,iBACN;AAAA,eACF;AAAA,YAGC,iBACC,qBAAC,SAAM,SAAQ,WAAU,WAAU,uBACjC;AAAA,kCAAC,eAAY;AAAA,cACZ,aAAa;AAAA,eAChB,IAEA,oBAAC,SAAM,WAAU,iBACd,uBAAa,aAAa,MAAM,KAAK,aAAa,QACrD;AAAA;AAAA;AAAA,QAnCG,aAAa;AAAA,MAqCpB;AAAA,IAEJ,CAAC,GACH;AAAA,KACF;AAEJ;","names":[]}

package/dist/intent/use-intent-filter.d.ts

@@ -0,0 +1,43 @@
+import type { FilterChipOption } from '@withpotter/ui-kit/filter-chip';
+/**
+ * Which part of the business this screen is showing, as a filter.
+ *
+ * This was a row of pills under the page title — `IntentFilterBar` — and it was
+ * the wrong control twice over. It is exclusive (exactly one option is lit at
+ * any moment: `clearActive` lights "Everything", `setActive` lights one chip,
+ * nothing else can match), so it was a tab strip wearing a filter's clothes;
+ * and it drew a brand fill directly under the page title, which put the loudest
+ * thing on the screen on the narrowing rather than on the data it narrows.
+ *
+ * The catalogue had already made this call once: live-and-draft were tabs above
+ * the table and moved into the filters on the argument that a merchant reaches
+ * for "show me my drafts" in the same breath as "under ₦10,000". "Show me the
+ * events" is that same breath.
+ *
+ * PINNED, not folded into the disclosed panel. Orders' own note on the pill row
+ * was right about one thing — the panel narrows a list, this says WHICH list,
+ * and behind a button the answer to "what is this page" costs four actions to
+ * read. As a pinned chip it states itself: "Showing: Event Listings".
+ *
+ * Returns null when there is nothing to narrow: a single-archetype business, or
+ * several archetypes that call this screen one word (see `buildIntentChips` —
+ * a restaurant does not have a dine-in menu and a takeaway menu, it has a menu).
+ *
+ * `itemId` is the nav item this screen is: 'catalog', 'orders'. It decides
+ * which of each archetype's nouns to show, because the same archetype calls its
+ * catalogue "Menu" and its queue "Kitchen Orders".
+ */
+export declare function useIntentFilter({ itemId, allLabel, label, }: {
+    itemId: string;
+    /** What the unnarrowed view is called. "Everything you sell", not "All". */
+    allLabel?: string;
+    /** The chip's attribute word, read as "Showing: Event Listings". */
+    label?: string;
+}): {
+    key: string;
+    label: string;
+    options: FilterChipOption[];
+    value: string;
+    onChange: (value: string) => void;
+    allValue: string;
+} | null;

package/dist/intent/use-intent-filter.js

@@ -0,0 +1,43 @@
+"use client";
+import { usePathname } from "@withpotter/lib/use-pathname";
+import { useActiveIntent } from "@withpotter/lib/intents/use-active-intent";
+import { buildIntentChips } from "@withpotter/lib/intents/intent-chips";
+const ALL = "__all__";
+function useIntentFilter({
+  itemId,
+  allLabel = "All",
+  label = "Showing"
+}) {
+  const { mode, all, activeKeys, setActive, clearActive } = useActiveIntent();
+  const pathname = usePathname();
+  if (mode !== "multi" || all.length < 2) return null;
+  const chips = buildIntentChips(
+    all.map((config) => config.key),
+    itemId,
+    pathname ?? void 0
+  );
+  if (chips.length < 2) return null;
+  const contributors = chips.flatMap((chip) => chip.keys);
+  const showingAll = contributors.every((key) => activeKeys.includes(key));
+  const current = chips.find(
+    (chip) => activeKeys.length === chip.keys.length && chip.keys.every((key) => activeKeys.includes(key))
+  );
+  return {
+    key: "intent",
+    label,
+    allValue: ALL,
+    value: showingAll ? ALL : current?.keys.join(",") ?? ALL,
+    onChange: (value) => value === ALL ? clearActive() : setActive(value.split(",")),
+    options: [
+      { value: ALL, label: allLabel },
+      ...chips.map((chip) => ({
+        value: chip.keys.join(","),
+        label: chip.label
+      }))
+    ]
+  };
+}
+export {
+  useIntentFilter
+};
+//# sourceMappingURL=use-intent-filter.js.map

package/dist/intent/use-intent-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intent/use-intent-filter.ts"],"sourcesContent":["'use client';\n\nimport { usePathname } from '@withpotter/lib/use-pathname';\nimport { useActiveIntent } from '@withpotter/lib/intents/use-active-intent';\nimport { buildIntentChips } from '@withpotter/lib/intents/intent-chips';\nimport type { FilterChipOption } from '@withpotter/ui-kit/filter-chip';\n\n/** The value that means \"not narrowed\". Not '', which is a legal intent join. */\nconst ALL = '__all__';\n\n/**\n * Which part of the business this screen is showing, as a filter.\n *\n * This was a row of pills under the page title — `IntentFilterBar` — and it was\n * the wrong control twice over. It is exclusive (exactly one option is lit at\n * any moment: `clearActive` lights \"Everything\", `setActive` lights one chip,\n * nothing else can match), so it was a tab strip wearing a filter's clothes;\n * and it drew a brand fill directly under the page title, which put the loudest\n * thing on the screen on the narrowing rather than on the data it narrows.\n *\n * The catalogue had already made this call once: live-and-draft were tabs above\n * the table and moved into the filters on the argument that a merchant reaches\n * for \"show me my drafts\" in the same breath as \"under ₦10,000\". \"Show me the\n * events\" is that same breath.\n *\n * PINNED, not folded into the disclosed panel. Orders' own note on the pill row\n * was right about one thing — the panel narrows a list, this says WHICH list,\n * and behind a button the answer to \"what is this page\" costs four actions to\n * read. As a pinned chip it states itself: \"Showing: Event Listings\".\n *\n * Returns null when there is nothing to narrow: a single-archetype business, or\n * several archetypes that call this screen one word (see `buildIntentChips` —\n * a restaurant does not have a dine-in menu and a takeaway menu, it has a menu).\n *\n * `itemId` is the nav item this screen is: 'catalog', 'orders'. It decides\n * which of each archetype's nouns to show, because the same archetype calls its\n * catalogue \"Menu\" and its queue \"Kitchen Orders\".\n */\nexport function useIntentFilter({\n  itemId,\n  allLabel = 'All',\n  label = 'Showing',\n}: {\n  itemId: string;\n  /** What the unnarrowed view is called. \"Everything you sell\", not \"All\". */\n  allLabel?: string;\n  /** The chip's attribute word, read as \"Showing: Event Listings\". */\n  label?: string;\n}): {\n  key: string;\n  label: string;\n  options: FilterChipOption[];\n  value: string;\n  onChange: (value: string) => void;\n  allValue: string;\n} | null {\n  const { mode, all, activeKeys, setActive, clearActive } = useActiveIntent();\n  const pathname = usePathname();\n\n  if (mode !== 'multi' || all.length < 2) return null;\n\n  // One option per word, not per archetype, and the option carries every\n  // archetype contributing that word — so Menu means the whole menu.\n  const chips = buildIntentChips(\n    all.map((config) => config.key),\n    itemId,\n    pathname ?? undefined,\n  );\n  // One option is no choice — either a single archetype feeds this screen, or\n  // several do under one word, which reads the same as not narrowing at all.\n  if (chips.length < 2) return null;\n\n  // Not `isAllIntents`. The row that opens this screen carries every archetype\n  // that feeds it — a catalogue narrows to the archetypes with a catalogue, not\n  // to the ones whose stock lives on another screen — so \"narrowed to all of\n  // them\" and \"not narrowed\" are the same view and must read as unset.\n  const contributors = chips.flatMap((chip) => chip.keys);\n  const showingAll = contributors.every((key) => activeKeys.includes(key));\n\n  // Exact, not `includes`: a view narrowed to two archetypes is not the same as\n  // either one of them, so neither option may claim it.\n  const current = chips.find(\n    (chip) =>\n      activeKeys.length === chip.keys.length &&\n      chip.keys.every((key) => activeKeys.includes(key)),\n  );\n\n  return {\n    key: 'intent',\n    label,\n    allValue: ALL,\n    value: showingAll ? ALL : (current?.keys.join(',') ?? ALL),\n    onChange: (value) =>\n      value === ALL ? clearActive() : setActive(value.split(',')),\n    options: [\n      { value: ALL, label: allLabel },\n      ...chips.map((chip) => ({\n        value: chip.keys.join(','),\n        label: chip.label,\n      })),\n    ],\n  };\n}\n"],"mappings":";AAEA,SAAS,mBAAmB;AAC5B,SAAS,uBAAuB;AAChC,SAAS,wBAAwB;AAIjC,MAAM,MAAM;AA8BL,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA,WAAW;AAAA,EACX,QAAQ;AACV,GAaS;AACP,QAAM,EAAE,MAAM,KAAK,YAAY,WAAW,YAAY,IAAI,gBAAgB;AAC1E,QAAM,WAAW,YAAY;AAE7B,MAAI,SAAS,WAAW,IAAI,SAAS,EAAG,QAAO;AAI/C,QAAM,QAAQ;AAAA,IACZ,IAAI,IAAI,CAAC,WAAW,OAAO,GAAG;AAAA,IAC9B;AAAA,IACA,YAAY;AAAA,EACd;AAGA,MAAI,MAAM,SAAS,EAAG,QAAO;AAM7B,QAAM,eAAe,MAAM,QAAQ,CAAC,SAAS,KAAK,IAAI;AACtD,QAAM,aAAa,aAAa,MAAM,CAAC,QAAQ,WAAW,SAAS,GAAG,CAAC;AAIvE,QAAM,UAAU,MAAM;AAAA,IACpB,CAAC,SACC,WAAW,WAAW,KAAK,KAAK,UAChC,KAAK,KAAK,MAAM,CAAC,QAAQ,WAAW,SAAS,GAAG,CAAC;AAAA,EACrD;AAEA,SAAO;AAAA,IACL,KAAK;AAAA,IACL;AAAA,IACA,UAAU;AAAA,IACV,OAAO,aAAa,MAAO,SAAS,KAAK,KAAK,GAAG,KAAK;AAAA,IACtD,UAAU,CAAC,UACT,UAAU,MAAM,YAAY,IAAI,UAAU,MAAM,MAAM,GAAG,CAAC;AAAA,IAC5D,SAAS;AAAA,MACP,EAAE,OAAO,KAAK,OAAO,SAAS;AAAA,MAC9B,GAAG,MAAM,IAAI,CAAC,UAAU;AAAA,QACtB,OAAO,KAAK,KAAK,KAAK,GAAG;AAAA,QACzB,OAAO,KAAK;AAAA,MACd,EAAE;AAAA,IACJ;AAAA,EACF;AACF;","names":[]}

package/dist/intent.d.ts

@@ -0,0 +1 @@
+export * from './intent/index';

package/dist/intent.js

@@ -0,0 +1 @@
+export * from './intent/index.js';

package/dist/intents/capture-leads.d.ts

@@ -0,0 +1,3 @@
+/** Capture leads: listings people enquire about, and the enquiries that arrive. */
+declare const _default: import("./define").IntentComposer;
+export default _default;

package/dist/intents/capture-leads.js

@@ -0,0 +1,61 @@
+import { defineIntent, route } from "./define";
+import { mountable } from "./mountable";
+var capture_leads_default = defineIntent({
+  key: "capture-leads",
+  label: "Capture leads",
+  group: "Let people book or enquire",
+  nav: { label: "Leads", icon: "MessageSquare" },
+  behaviors: ["leadCapture"],
+  vocabulary: {
+    item: ["Listing", "Listings"],
+    order: ["Enquiry", "Enquiries"],
+    booking: ["Viewing", "Viewings"],
+    resource: ["Listing", "Listings"]
+  },
+  routes: [
+    route({
+      path: "lead-listings",
+      label: "Listings",
+      landingLabel: "Listings",
+      icon: "FileText",
+      requires: ["leadCapture"],
+      permissions: ["canViewProducts", "canManageProducts"],
+      empty: {
+        title: "No listings yet",
+        description: "Add what people can enquire about and it will appear here."
+      },
+      mount: mountable.itemList,
+      props: {
+        data: { call: "items.list", filter: { intent: "capture-leads" } }
+      }
+    }),
+    route({
+      path: "lead-enquiries",
+      label: "Enquiries",
+      navId: "inquiries",
+      icon: "MessageSquare",
+      requires: ["leadCapture"],
+      permissions: [
+        "canViewCommunications",
+        "canManageCommunications",
+        "canViewMembers",
+        "canManageMembers"
+      ],
+      mount: mountable.inbox
+    }),
+    route({
+      path: "new-listing",
+      label: "New listing",
+      icon: "Plus",
+      hidden: true,
+      requires: ["leadCapture"],
+      permissions: ["canManageProducts"],
+      mount: mountable.itemCreate,
+      props: { data: { call: "items.create", intent: "capture-leads" } }
+    })
+  ]
+});
+export {
+  capture_leads_default as default
+};
+//# sourceMappingURL=capture-leads.js.map

package/dist/intents/capture-leads.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intents/capture-leads.ts"],"sourcesContent":["import { defineIntent, route } from './define';\nimport { mountable } from './mountable';\n\n/** Capture leads: listings people enquire about, and the enquiries that arrive. */\nexport default defineIntent({\n  key: 'capture-leads',\n  label: 'Capture leads',\n  group: 'Let people book or enquire',\n  nav: { label: 'Leads', icon: 'MessageSquare' },\n  behaviors: ['leadCapture'],\n  vocabulary: {\n    item: ['Listing', 'Listings'],\n    order: ['Enquiry', 'Enquiries'],\n    booking: ['Viewing', 'Viewings'],\n    resource: ['Listing', 'Listings'],\n  },\n  routes: [\n    route({\n      path: 'lead-listings',\n      label: 'Listings',\n      landingLabel: 'Listings',\n      icon: 'FileText',\n      requires: ['leadCapture'],\n      permissions: ['canViewProducts', 'canManageProducts'],\n      empty: {\n        title: 'No listings yet',\n        description:\n          'Add what people can enquire about and it will appear here.',\n      },\n      mount: mountable.itemList,\n      props: {\n        data: { call: 'items.list', filter: { intent: 'capture-leads' } },\n      },\n    }),\n    route({\n      path: 'lead-enquiries',\n      label: 'Enquiries',\n      navId: 'inquiries',\n      icon: 'MessageSquare',\n      requires: ['leadCapture'],\n      permissions: [\n        'canViewCommunications',\n        'canManageCommunications',\n        'canViewMembers',\n        'canManageMembers',\n      ],\n      mount: mountable.inbox,\n    }),\n    route({\n      path: 'new-listing',\n      label: 'New listing',\n      icon: 'Plus',\n      hidden: true,\n      requires: ['leadCapture'],\n      permissions: ['canManageProducts'],\n      mount: mountable.itemCreate,\n      props: { data: { call: 'items.create', intent: 'capture-leads' } },\n    }),\n  ],\n});\n"],"mappings":"AAAA,SAAS,cAAc,aAAa;AACpC,SAAS,iBAAiB;AAG1B,IAAO,wBAAQ,aAAa;AAAA,EAC1B,KAAK;AAAA,EACL,OAAO;AAAA,EACP,OAAO;AAAA,EACP,KAAK,EAAE,OAAO,SAAS,MAAM,gBAAgB;AAAA,EAC7C,WAAW,CAAC,aAAa;AAAA,EACzB,YAAY;AAAA,IACV,MAAM,CAAC,WAAW,UAAU;AAAA,IAC5B,OAAO,CAAC,WAAW,WAAW;AAAA,IAC9B,SAAS,CAAC,WAAW,UAAU;AAAA,IAC/B,UAAU,CAAC,WAAW,UAAU;AAAA,EAClC;AAAA,EACA,QAAQ;AAAA,IACN,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,OAAO;AAAA,MACP,cAAc;AAAA,MACd,MAAM;AAAA,MACN,UAAU,CAAC,aAAa;AAAA,MACxB,aAAa,CAAC,mBAAmB,mBAAmB;AAAA,MACpD,OAAO;AAAA,QACL,OAAO;AAAA,QACP,aACE;AAAA,MACJ;AAAA,MACA,OAAO,UAAU;AAAA,MACjB,OAAO;AAAA,QACL,MAAM,EAAE,MAAM,cAAc,QAAQ,EAAE,QAAQ,gBAAgB,EAAE;AAAA,MAClE;AAAA,IACF,CAAC;AAAA,IACD,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,OAAO;AAAA,MACP,OAAO;AAAA,MACP,MAAM;AAAA,MACN,UAAU,CAAC,aAAa;AAAA,MACxB,aAAa;AAAA,QACX;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,MACA,OAAO,UAAU;AAAA,IACnB,CAAC;AAAA,IACD,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,OAAO;AAAA,MACP,MAAM;AAAA,MACN,QAAQ;AAAA,MACR,UAAU,CAAC,aAAa;AAAA,MACxB,aAAa,CAAC,mBAAmB;AAAA,MACjC,OAAO,UAAU;AAAA,MACjB,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,QAAQ,gBAAgB,EAAE;AAAA,IACnE,CAAC;AAAA,EACH;AACF,CAAC;","names":[]}

package/dist/intents/composed-screen.d.ts

@@ -0,0 +1,9 @@
+import type { ComposedRoute } from './define';
+/**
+ * Mounts the screen a composed route names, with the props it declared, as
+ * the intent that owns the route.
+ */
+export declare function ComposedScreen({ route, intent, }: {
+    route: ComposedRoute;
+    intent: string;
+}): import("react").JSX.Element;

package/dist/intents/composed-screen.js

@@ -0,0 +1,26 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { Suspense } from "react";
+import { BoxesLoader } from "@withpotter/ui-kit/boxes-loader";
+import { IntentScope } from "@withpotter/lib/intents/intent-scope";
+import { INTENTS } from "./index";
+import { scopeLabelsFor } from "./scope-labels";
+function ComposedScreen({
+  route,
+  intent
+}) {
+  const Screen = route.mount.Component;
+  const composer = INTENTS.find((i) => i.key === intent);
+  const labels = composer ? scopeLabelsFor(composer, route.label, route.empty, route) : null;
+  return /* @__PURE__ */ jsx(
+    Suspense,
+    {
+      fallback: /* @__PURE__ */ jsx("div", { className: "min-h-[60vh] flex items-center justify-center", children: /* @__PURE__ */ jsx(BoxesLoader, { size: "lg", className: "mx-auto" }) }),
+      children: /* @__PURE__ */ jsx(IntentScope, { intentKey: intent, labels, children: /* @__PURE__ */ jsx(Screen, { ...route.props }) })
+    }
+  );
+}
+export {
+  ComposedScreen
+};
+//# sourceMappingURL=composed-screen.js.map

package/dist/intents/composed-screen.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intents/composed-screen.tsx"],"sourcesContent":["'use client';\n\nimport { Suspense } from 'react';\nimport { BoxesLoader } from '@withpotter/ui-kit/boxes-loader';\nimport { IntentScope } from '@withpotter/lib/intents/intent-scope';\nimport { INTENTS } from './index';\nimport { scopeLabelsFor } from './scope-labels';\nimport type { ComposedRoute } from './define';\n\n/**\n * Mounts the screen a composed route names, with the props it declared, as\n * the intent that owns the route.\n */\nexport function ComposedScreen({\n  route,\n  intent,\n}: {\n  route: ComposedRoute;\n  intent: string;\n}) {\n  const Screen = route.mount.Component;\n  const composer = INTENTS.find((i) => i.key === intent);\n  const labels = composer\n    ? scopeLabelsFor(composer, route.label, route.empty, route)\n    : null;\n  return (\n    <Suspense\n      fallback={\n        <div className=\"min-h-[60vh] flex items-center justify-center\">\n          <BoxesLoader size=\"lg\" className=\"mx-auto\" />\n        </div>\n      }\n    >\n      <IntentScope intentKey={intent} labels={labels}>\n        <Screen {...route.props} />\n      </IntentScope>\n    </Suspense>\n  );\n}\n"],"mappings":";AA6BU;AA3BV,SAAS,gBAAgB;AACzB,SAAS,mBAAmB;AAC5B,SAAS,mBAAmB;AAC5B,SAAS,eAAe;AACxB,SAAS,sBAAsB;AAOxB,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AACF,GAGG;AACD,QAAM,SAAS,MAAM,MAAM;AAC3B,QAAM,WAAW,QAAQ,KAAK,CAAC,MAAM,EAAE,QAAQ,MAAM;AACrD,QAAM,SAAS,WACX,eAAe,UAAU,MAAM,OAAO,MAAM,OAAO,KAAK,IACxD;AACJ,SACE;AAAA,IAAC;AAAA;AAAA,MACC,UACE,oBAAC,SAAI,WAAU,iDACb,8BAAC,eAAY,MAAK,MAAK,WAAU,WAAU,GAC7C;AAAA,MAGF,8BAAC,eAAY,WAAW,QAAQ,QAC9B,8BAAC,UAAQ,GAAG,MAAM,OAAO,GAC3B;AAAA;AAAA,EACF;AAEJ;","names":[]}

package/dist/intents/define.d.ts

@@ -0,0 +1,88 @@
+import type { ContentBehavior } from '@withpotter/lib/template-types';
+import type { PermissionKey } from '@withpotter/lib/use-permissions';
+import type { Mountable } from './mount';
+/** A route as the engine stores it: the props were checked when it was made. */
+export interface ComposedRoute {
+    /** Under /dashboard, kebab-case, no leading slash. Unique across intents. */
+    readonly path: string;
+    readonly label: string;
+    /** What the intent's row calls this screen when it is the landing (the first route). */
+    readonly landingLabel?: string;
+    /** Reachable by link (create screens) but never a row in the sidebar. */
+    readonly hidden?: boolean;
+    /** The spine row this route replaces (`invoices`, `inquiries`), so the spine drops its own. */
+    readonly navId?: 'invoices' | 'inquiries';
+    /** What the screen says when it has nothing to list. Else the industry's copy. */
+    readonly empty?: {
+        readonly title: string;
+        readonly description: string;
+    };
+    /** A lucide icon name, resolved by the sidebar. */
+    readonly icon: string;
+    /** Shown only while one of these behaviors is active. Absent = always. */
+    readonly requires?: readonly ContentBehavior[];
+    /**
+     * A team member sees the row with AT LEAST ONE of these (the owner always
+     * does). Required, because the sidebar's default is closed: a route that
+     * declared none would be hidden from every non-owner without saying why.
+     */
+    readonly permissions: readonly PermissionKey[];
+    readonly mount: Mountable<any>;
+    readonly props: object;
+}
+interface RouteBase<P extends object> {
+    path: string;
+    label: string;
+    landingLabel?: string;
+    hidden?: boolean;
+    navId?: 'invoices' | 'inquiries';
+    empty?: {
+        title: string;
+        description: string;
+    };
+    icon: string;
+    requires?: readonly ContentBehavior[];
+    permissions: readonly PermissionKey[];
+    mount: Mountable<P>;
+}
+/**
+ * `props` is typed from the mounted screen, and REQUIRED whenever that screen
+ * has a prop it cannot do without. A screen that needs its data declared (the
+ * order list needs its request) cannot be mounted by a route that leaves it
+ * out: the file does not compile.
+ */
+type RouteInput<P extends object> = RouteBase<P> & (object extends P ? {
+    props?: NoInfer<P>;
+} : {
+    props: NoInfer<P>;
+});
+/**
+ * Declare a route. `props` must match what `mount` accepts, so a column the
+ * list does not take is a compile error rather than a silent no-op.
+ */
+export declare function route<P extends object = object>(input: RouteInput<P>): ComposedRoute;
+export type EntityNoun = readonly [singular: string, plural: string];
+export interface IntentComposer {
+    readonly key: string;
+    readonly label: string;
+    readonly group: string;
+    /** How this intent's rows are headed in the sidebar. */
+    readonly nav: {
+        readonly label: string;
+        readonly icon: string;
+    };
+    readonly behaviors: readonly ContentBehavior[];
+    /** The resource types this intent manages (a table, a room, a staff member). */
+    readonly resources?: readonly string[];
+    /** The nouns this intent uses. Screens read these and never hardcode one. */
+    readonly vocabulary: {
+        readonly item: EntityNoun;
+        readonly order: EntityNoun;
+        readonly booking?: EntityNoun;
+        readonly resource?: EntityNoun;
+    };
+    readonly routes: readonly ComposedRoute[];
+}
+/** Identity function: its only job is to make the compiler check the file. */
+export declare function defineIntent(composer: IntentComposer): IntentComposer;
+export {};

package/dist/intents/define.js

@@ -0,0 +1,11 @@
+function route(input) {
+  return { ...input, props: input.props ?? {} };
+}
+function defineIntent(composer) {
+  return composer;
+}
+export {
+  defineIntent,
+  route
+};
+//# sourceMappingURL=define.js.map

package/dist/intents/define.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intents/define.ts"],"sourcesContent":["import type { ContentBehavior } from '@withpotter/lib/template-types';\nimport type { PermissionKey } from '@withpotter/lib/use-permissions';\nimport type { Mountable } from './mount';\n\n/** A route as the engine stores it: the props were checked when it was made. */\nexport interface ComposedRoute {\n  /** Under /dashboard, kebab-case, no leading slash. Unique across intents. */\n  readonly path: string;\n  readonly label: string;\n  /** What the intent's row calls this screen when it is the landing (the first route). */\n  readonly landingLabel?: string;\n  /** Reachable by link (create screens) but never a row in the sidebar. */\n  readonly hidden?: boolean;\n  /** The spine row this route replaces (`invoices`, `inquiries`), so the spine drops its own. */\n  readonly navId?: 'invoices' | 'inquiries';\n  /** What the screen says when it has nothing to list. Else the industry's copy. */\n  readonly empty?: { readonly title: string; readonly description: string };\n  /** A lucide icon name, resolved by the sidebar. */\n  readonly icon: string;\n  /** Shown only while one of these behaviors is active. Absent = always. */\n  readonly requires?: readonly ContentBehavior[];\n  /**\n   * A team member sees the row with AT LEAST ONE of these (the owner always\n   * does). Required, because the sidebar's default is closed: a route that\n   * declared none would be hidden from every non-owner without saying why.\n   */\n  readonly permissions: readonly PermissionKey[];\n  // `any` is the erasure point: `route()` below is the only way in, and it has\n  // already tied `props` to the props this mountable accepts.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  readonly mount: Mountable<any>;\n  readonly props: object;\n}\n\ninterface RouteBase<P extends object> {\n  path: string;\n  label: string;\n  landingLabel?: string;\n  hidden?: boolean;\n  navId?: 'invoices' | 'inquiries';\n  empty?: { title: string; description: string };\n  icon: string;\n  requires?: readonly ContentBehavior[];\n  permissions: readonly PermissionKey[];\n  mount: Mountable<P>;\n}\n\n/**\n * `props` is typed from the mounted screen, and REQUIRED whenever that screen\n * has a prop it cannot do without. A screen that needs its data declared (the\n * order list needs its request) cannot be mounted by a route that leaves it\n * out: the file does not compile.\n */\ntype RouteInput<P extends object> = RouteBase<P> &\n  (object extends P ? { props?: NoInfer<P> } : { props: NoInfer<P> });\n\n/**\n * Declare a route. `props` must match what `mount` accepts, so a column the\n * list does not take is a compile error rather than a silent no-op.\n */\nexport function route<P extends object = object>(\n  input: RouteInput<P>,\n): ComposedRoute {\n  return { ...input, props: input.props ?? {} };\n}\n\nexport type EntityNoun = readonly [singular: string, plural: string];\n\nexport interface IntentComposer {\n  readonly key: string;\n  readonly label: string;\n  readonly group: string;\n  /** How this intent's rows are headed in the sidebar. */\n  readonly nav: { readonly label: string; readonly icon: string };\n  readonly behaviors: readonly ContentBehavior[];\n  /** The resource types this intent manages (a table, a room, a staff member). */\n  readonly resources?: readonly string[];\n  /** The nouns this intent uses. Screens read these and never hardcode one. */\n  readonly vocabulary: {\n    readonly item: EntityNoun;\n    readonly order: EntityNoun;\n    readonly booking?: EntityNoun;\n    readonly resource?: EntityNoun;\n  };\n  readonly routes: readonly ComposedRoute[];\n}\n\n/** Identity function: its only job is to make the compiler check the file. */\nexport function defineIntent(composer: IntentComposer): IntentComposer {\n  return composer;\n}\n"],"mappings":"AA4DO,SAAS,MACd,OACe;AACf,SAAO,EAAE,GAAG,OAAO,OAAO,MAAM,SAAS,CAAC,EAAE;AAC9C;AAwBO,SAAS,aAAa,UAA0C;AACrE,SAAO;AACT;","names":[]}

package/dist/intents/detail-rewrites.d.ts

@@ -0,0 +1,11 @@
+import type { IntentComposer } from './define';
+export interface DetailRewrite {
+    source: string;
+    destination: string;
+}
+/** The record base a route's list screen keeps its records under, if any. */
+export declare const detailBaseOf: (route: {
+    mount: unknown;
+}) => string | undefined;
+/** A rewrite per list route, from the composer files alone. */
+export declare function detailRewrites(intents: readonly IntentComposer[]): DetailRewrite[];

package/dist/intents/detail-rewrites.js

@@ -0,0 +1,30 @@
+import { mountable } from "./mountable";
+const DETAIL_BASES = /* @__PURE__ */ new Map([
+  [mountable.itemList, "catalog"],
+  [mountable.orderList, "orders"],
+  [mountable.bookingList, "bookings"],
+  [mountable.resourceList, "resources"],
+  [mountable.invoiceList, "invoices"],
+  // The events list opens an event as the item it is.
+  [mountable.eventList, "catalog"],
+  [mountable.membershipPlans, "subscriptions/plans"]
+]);
+const detailBaseOf = (route) => DETAIL_BASES.get(route.mount);
+function detailRewrites(intents) {
+  return intents.flatMap(
+    (intent) => intent.routes.flatMap((route) => {
+      const base = detailBaseOf(route);
+      return base ? [
+        {
+          source: `/dashboard/${route.path}/:id/:rest*`,
+          destination: `/dashboard/${base}/:id/:rest*`
+        }
+      ] : [];
+    })
+  );
+}
+export {
+  detailBaseOf,
+  detailRewrites
+};
+//# sourceMappingURL=detail-rewrites.js.map

package/dist/intents/detail-rewrites.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/intents/detail-rewrites.ts"],"sourcesContent":["import type { IntentComposer } from './define';\nimport { mountable } from './mountable';\n\n/**\n * Where each kind of list keeps its records' own screens.\n *\n * A record has one real page — an item's is under `catalog`, an order's under\n * `orders` — and an intent's list route is where the merchant came from. The\n * record's address is that list route plus its id (`/dashboard/ticket-events/\n * <id>`), so the URL says which intent they are in, the sidebar lights the\n * right row, and Back goes to the right list. The page behind it is the one\n * real page, served at the intent's address.\n */\nconst DETAIL_BASES = new Map<unknown, string>([\n  [mountable.itemList, 'catalog'],\n  [mountable.orderList, 'orders'],\n  [mountable.bookingList, 'bookings'],\n  [mountable.resourceList, 'resources'],\n  [mountable.invoiceList, 'invoices'],\n  // The events list opens an event as the item it is.\n  [mountable.eventList, 'catalog'],\n  [mountable.membershipPlans, 'subscriptions/plans'],\n]);\n\nexport interface DetailRewrite {\n  source: string;\n  destination: string;\n}\n\n/** The record base a route's list screen keeps its records under, if any. */\nexport const detailBaseOf = (route: { mount: unknown }): string | undefined =>\n  DETAIL_BASES.get(route.mount);\n\n/** A rewrite per list route, from the composer files alone. */\nexport function detailRewrites(\n  intents: readonly IntentComposer[],\n): DetailRewrite[] {\n  return intents.flatMap((intent) =>\n    intent.routes.flatMap((route) => {\n      const base = detailBaseOf(route);\n      return base\n        ? [\n            {\n              source: `/dashboard/${route.path}/:id/:rest*`,\n              destination: `/dashboard/${base}/:id/:rest*`,\n            },\n          ]\n        : [];\n    }),\n  );\n}\n"],"mappings":"AACA,SAAS,iBAAiB;AAY1B,MAAM,eAAe,oBAAI,IAAqB;AAAA,EAC5C,CAAC,UAAU,UAAU,SAAS;AAAA,EAC9B,CAAC,UAAU,WAAW,QAAQ;AAAA,EAC9B,CAAC,UAAU,aAAa,UAAU;AAAA,EAClC,CAAC,UAAU,cAAc,WAAW;AAAA,EACpC,CAAC,UAAU,aAAa,UAAU;AAAA;AAAA,EAElC,CAAC,UAAU,WAAW,SAAS;AAAA,EAC/B,CAAC,UAAU,iBAAiB,qBAAqB;AACnD,CAAC;AAQM,MAAM,eAAe,CAAC,UAC3B,aAAa,IAAI,MAAM,KAAK;AAGvB,SAAS,eACd,SACiB;AACjB,SAAO,QAAQ;AAAA,IAAQ,CAAC,WACtB,OAAO,OAAO,QAAQ,CAAC,UAAU;AAC/B,YAAM,OAAO,aAAa,KAAK;AAC/B,aAAO,OACH;AAAA,QACE;AAAA,UACE,QAAQ,cAAc,MAAM,IAAI;AAAA,UAChC,aAAa,cAAc,IAAI;AAAA,QACjC;AAAA,MACF,IACA,CAAC;AAAA,IACP,CAAC;AAAA,EACH;AACF;","names":[]}