@withpotter/lib 0.13.0-next.101

package/dist/resource-types.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Internal classification for resource categories.
+ * Determines default behavior, schedule type, and form fields.
+ */
+export type ResourceCategoryKind = 'person' | 'space' | 'equipment' | 'unit';
+/**
+ * Custom field definition for resource categories.
+ * Merchants can add custom fields (e.g., "Specialties", "Amenities").
+ */
+export interface ResourceCategoryCustomField {
+    name: string;
+    type: 'text' | 'number' | 'select' | 'multiselect' | 'boolean';
+    options?: string[];
+    required?: boolean;
+}
+/**
+ * A merchant-defined category for grouping resources (e.g., "Doctors", "Rooms").
+ * Replaces the hardcoded ResourceType enum for display purposes.
+ */
+export interface ResourceCategory {
+    id: string;
+    tenantId: string;
+    label: string;
+    labelPlural: string;
+    kind: ResourceCategoryKind;
+    icon: string | null;
+    customFields: ResourceCategoryCustomField[];
+    sortOrder: number;
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateResourceCategoryInput {
+    label: string;
+    labelPlural: string;
+    kind?: ResourceCategoryKind;
+    icon?: string;
+    customFields?: ResourceCategoryCustomField[];
+}
+export interface UpdateResourceCategoryInput {
+    label?: string;
+    labelPlural?: string;
+    kind?: ResourceCategoryKind;
+    icon?: string;
+    customFields?: ResourceCategoryCustomField[];
+    isActive?: boolean;
+}
+export interface ScheduleSlot {
+    start: string;
+    end: string;
+}
+export interface DaySchedule {
+    available: boolean;
+    slots?: ScheduleSlot[];
+}
+/** Weekly schedule indexed by day (0=Sunday, 1=Monday, ..., 6=Saturday) */
+export type WeeklySchedule = Record<number, DaySchedule>;
+/** The internal resource type enum (matches API ResourceType) */
+export type ResourceType = 'staff' | 'room' | 'table' | 'equipment' | 'vehicle' | 'space';
+/**
+ * A bookable resource (person, room, equipment, etc.).
+ * Resources belong to a category and have their own schedule and pricing.
+ */
+export interface Resource {
+    id: string;
+    tenantId: string;
+    type: ResourceType;
+    status: 'active' | 'inactive';
+    name: string;
+    shortName: string | null;
+    description: string | null;
+    imageUrl: string | null;
+    categoryId: string | null;
+    /**
+     * Which branch it is at. A court or a room sits at one address. Null only
+     * on rows written before branches existed.
+     */
+    locationId?: string | null;
+    skills: string[];
+    timezone: string;
+    schedule: WeeklySchedule | null;
+    defaultDurationMinutes: number;
+    bufferMinutes: number;
+    advanceBookingDays: number | null;
+    minNoticeHours: number | null;
+    maxBookingsPerSlot: number | null;
+    price: number | null;
+    pricePerHour: number | null;
+    currency: string;
+    sortOrder: number;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateResourceInput {
+    type: ResourceType;
+    name: string;
+    categoryId?: string;
+    skills?: string[];
+    shortName?: string;
+    description?: string;
+    imageUrl?: string;
+    timezone?: string;
+    schedule?: WeeklySchedule;
+    defaultDurationMinutes?: number;
+    bufferMinutes?: number;
+    advanceBookingDays?: number;
+    minNoticeHours?: number;
+    maxBookingsPerSlot?: number;
+    price?: number;
+    pricePerHour?: number;
+    currency?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface UpdateResourceInput {
+    name?: string;
+    categoryId?: string;
+    skills?: string[];
+    shortName?: string;
+    description?: string;
+    imageUrl?: string;
+    timezone?: string;
+    schedule?: WeeklySchedule;
+    defaultDurationMinutes?: number;
+    bufferMinutes?: number;
+    advanceBookingDays?: number;
+    minNoticeHours?: number;
+    maxBookingsPerSlot?: number;
+    price?: number;
+    pricePerHour?: number;
+    currency?: string;
+    metadata?: Record<string, unknown>;
+}
+export type AssignmentStrategy = 'auto-first' | 'auto-best' | 'customer-chooses' | 'round-robin' | 'pool' | 'sole-provider';
+export interface ContentResourceRequirement {
+    id: string;
+    contentId: string;
+    categoryId: string;
+    tenantId: string;
+    isRequired: boolean;
+    assignmentStrategy: AssignmentStrategy;
+    requiredSkills: string[];
+    eligibleResourceIds: string[] | null;
+    sortOrder: number;
+    category?: ResourceCategory;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ContentResourceRequirementItem {
+    categoryId: string;
+    isRequired?: boolean;
+    assignmentStrategy?: AssignmentStrategy;
+    requiredSkills?: string[];
+    eligibleResourceIds?: string[] | null;
+}
+/** One service that asks for a group of bookable things. */
+export interface CategoryUsageService {
+    id: string;
+    title: string;
+    type: string;
+    isRequired: boolean;
+}
+/**
+ * A group, and what asks for it.
+ *
+ * `GET /resource-categories/usage`. Absent from the list means nothing asks for
+ * it — which is the state worth telling a merchant about, because a coach no
+ * service requires is a name the website will never offer.
+ */
+export interface CategoryUsage {
+    categoryId: string;
+    services: CategoryUsageService[];
+}
+export interface SetContentRequirementsInput {
+    requirements: ContentResourceRequirementItem[];
+}
+export interface KindDefaults {
+    label: string;
+    description: string;
+    defaultCapacity: number;
+    scheduleType: 'individual' | 'operating-hours' | 'date-range';
+    defaultFields: string[];
+    defaultResourceType: ResourceType;
+    useCase: string;
+}
+export declare const KIND_DEFAULTS: Record<ResourceCategoryKind, KindDefaults>;
+export declare function kindToResourceType(kind: ResourceCategoryKind): ResourceType;
+interface KindOption {
+    label: string;
+    description: string;
+    emoji: string;
+}
+export declare const KIND_OPTIONS: ({
+    value: ResourceCategoryKind;
+} & KindOption)[];
+export declare const DAY_LABELS: readonly ["Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"];
+export declare const SHORT_DAY_LABELS: readonly ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+export {};

package/dist/resource-types.js

@@ -0,0 +1,96 @@
+const KIND_DEFAULTS = {
+  person: {
+    label: "Person",
+    description: "Individual service providers with their own schedule",
+    defaultCapacity: 1,
+    scheduleType: "individual",
+    defaultFields: ["name", "photo", "skills", "break-times"],
+    defaultResourceType: "staff",
+    useCase: "Stylist, doctor, therapist, instructor"
+  },
+  space: {
+    label: "Space",
+    description: "Shared spaces with variable capacity",
+    defaultCapacity: 10,
+    scheduleType: "operating-hours",
+    defaultFields: ["name", "capacity", "amenities"],
+    defaultResourceType: "room",
+    useCase: "Room, table, studio, court"
+  },
+  equipment: {
+    label: "Equipment",
+    description: "Physical equipment with maintenance windows",
+    defaultCapacity: 1,
+    scheduleType: "operating-hours",
+    defaultFields: ["name", "serial-number", "condition"],
+    defaultResourceType: "equipment",
+    useCase: "Projector, dermatoscope, vehicle"
+  },
+  unit: {
+    label: "Unit",
+    description: "Date-range units for nightly/weekly bookings",
+    defaultCapacity: 1,
+    scheduleType: "date-range",
+    defaultFields: ["name", "photos", "check-in", "check-out"],
+    defaultResourceType: "room",
+    useCase: "Property, apartment, rental car"
+  }
+};
+function kindToResourceType(kind) {
+  return KIND_DEFAULTS[kind].defaultResourceType;
+}
+const KINDS = {
+  person: {
+    label: "Person",
+    description: "Staff, providers, instructors",
+    emoji: "\u{1F464}"
+  },
+  space: {
+    label: "Space",
+    description: "Rooms, tables, studios",
+    emoji: "\u{1F3E0}"
+  },
+  equipment: {
+    label: "Equipment",
+    description: "Devices, vehicles, tools",
+    emoji: "\u{1F527}"
+  },
+  unit: {
+    label: "Unit",
+    description: "Properties, apartments, rentals",
+    emoji: "\u{1F3E2}"
+  }
+};
+const KIND_RANK = {
+  person: 0,
+  space: 1,
+  equipment: 2,
+  unit: 3
+};
+const KIND_OPTIONS = Object.keys(KINDS).sort((a, b) => KIND_RANK[a] - KIND_RANK[b]).map((value) => ({ value, ...KINDS[value] }));
+const DAY_LABELS = [
+  "Sunday",
+  "Monday",
+  "Tuesday",
+  "Wednesday",
+  "Thursday",
+  "Friday",
+  "Saturday"
+];
+const SHORT_DAY_LABELS = [
+  "Sun",
+  "Mon",
+  "Tue",
+  "Wed",
+  "Thu",
+  "Fri",
+  "Sat"
+];
+export {
+  DAY_LABELS,
+  KIND_DEFAULTS,
+  KIND_OPTIONS,
+  SHORT_DAY_LABELS,
+  kindToResourceType
+};
+//# sourceMappingURL=resource-types.js.map

package/dist/resource-types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resource-types.ts"],"sourcesContent":["// ============================================\n// Resource Category & Resource Types\n// ============================================\n\n/**\n * Internal classification for resource categories.\n * Determines default behavior, schedule type, and form fields.\n */\nexport type ResourceCategoryKind = 'person' | 'space' | 'equipment' | 'unit';\n\n/**\n * Custom field definition for resource categories.\n * Merchants can add custom fields (e.g., \"Specialties\", \"Amenities\").\n */\nexport interface ResourceCategoryCustomField {\n  name: string;\n  type: 'text' | 'number' | 'select' | 'multiselect' | 'boolean';\n  options?: string[];\n  required?: boolean;\n}\n\n/**\n * A merchant-defined category for grouping resources (e.g., \"Doctors\", \"Rooms\").\n * Replaces the hardcoded ResourceType enum for display purposes.\n */\nexport interface ResourceCategory {\n  id: string;\n  tenantId: string;\n  label: string;\n  labelPlural: string;\n  kind: ResourceCategoryKind;\n  icon: string | null;\n  customFields: ResourceCategoryCustomField[];\n  sortOrder: number;\n  isActive: boolean;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface CreateResourceCategoryInput {\n  label: string;\n  labelPlural: string;\n  kind?: ResourceCategoryKind;\n  icon?: string;\n  customFields?: ResourceCategoryCustomField[];\n}\n\nexport interface UpdateResourceCategoryInput {\n  label?: string;\n  labelPlural?: string;\n  kind?: ResourceCategoryKind;\n  icon?: string;\n  customFields?: ResourceCategoryCustomField[];\n  isActive?: boolean;\n}\n\n// ============================================\n// Resource Schedule Types\n// ============================================\n\nexport interface ScheduleSlot {\n  start: string; // \"HH:mm\"\n  end: string; // \"HH:mm\"\n}\n\nexport interface DaySchedule {\n  available: boolean;\n  slots?: ScheduleSlot[];\n}\n\n/** Weekly schedule indexed by day (0=Sunday, 1=Monday, ..., 6=Saturday) */\nexport type WeeklySchedule = Record<number, DaySchedule>;\n\n// ============================================\n// Resource Types\n// ============================================\n\n/** The internal resource type enum (matches API ResourceType) */\nexport type ResourceType =\n  | 'staff'\n  | 'room'\n  | 'table'\n  | 'equipment'\n  | 'vehicle'\n  | 'space';\n\n/**\n * A bookable resource (person, room, equipment, etc.).\n * Resources belong to a category and have their own schedule and pricing.\n */\nexport interface Resource {\n  id: string;\n  tenantId: string;\n  type: ResourceType;\n  status: 'active' | 'inactive';\n  name: string;\n  shortName: string | null;\n  description: string | null;\n  imageUrl: string | null;\n  categoryId: string | null;\n  /**\n   * Which branch it is at. A court or a room sits at one address. Null only\n   * on rows written before branches existed.\n   */\n  locationId?: string | null;\n  skills: string[];\n  timezone: string;\n  schedule: WeeklySchedule | null;\n  defaultDurationMinutes: number;\n  bufferMinutes: number;\n  advanceBookingDays: number | null;\n  minNoticeHours: number | null;\n  maxBookingsPerSlot: number | null;\n  price: number | null;\n  pricePerHour: number | null;\n  currency: string;\n  sortOrder: number;\n  metadata?: Record<string, unknown>;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface CreateResourceInput {\n  type: ResourceType;\n  name: string;\n  categoryId?: string;\n  skills?: string[];\n  shortName?: string;\n  description?: string;\n  imageUrl?: string;\n  timezone?: string;\n  schedule?: WeeklySchedule;\n  defaultDurationMinutes?: number;\n  bufferMinutes?: number;\n  advanceBookingDays?: number;\n  minNoticeHours?: number;\n  maxBookingsPerSlot?: number;\n  price?: number;\n  pricePerHour?: number;\n  currency?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface UpdateResourceInput {\n  name?: string;\n  categoryId?: string;\n  skills?: string[];\n  shortName?: string;\n  description?: string;\n  imageUrl?: string;\n  timezone?: string;\n  schedule?: WeeklySchedule;\n  defaultDurationMinutes?: number;\n  bufferMinutes?: number;\n  advanceBookingDays?: number;\n  minNoticeHours?: number;\n  maxBookingsPerSlot?: number;\n  price?: number;\n  pricePerHour?: number;\n  currency?: string;\n  metadata?: Record<string, unknown>;\n}\n\n// ============================================\n// Content Resource Requirements\n// ============================================\n\nexport type AssignmentStrategy =\n  | 'auto-first'\n  | 'auto-best'\n  | 'customer-chooses'\n  | 'round-robin'\n  | 'pool'\n  | 'sole-provider';\n\nexport interface ContentResourceRequirement {\n  id: string;\n  contentId: string;\n  categoryId: string;\n  tenantId: string;\n  isRequired: boolean;\n  assignmentStrategy: AssignmentStrategy;\n  requiredSkills: string[];\n  eligibleResourceIds: string[] | null;\n  sortOrder: number;\n  category?: ResourceCategory;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface ContentResourceRequirementItem {\n  categoryId: string;\n  isRequired?: boolean;\n  assignmentStrategy?: AssignmentStrategy;\n  requiredSkills?: string[];\n  eligibleResourceIds?: string[] | null;\n}\n\n/** One service that asks for a group of bookable things. */\nexport interface CategoryUsageService {\n  id: string;\n  title: string;\n  type: string;\n  isRequired: boolean;\n}\n\n/**\n * A group, and what asks for it.\n *\n * `GET /resource-categories/usage`. Absent from the list means nothing asks for\n * it — which is the state worth telling a merchant about, because a coach no\n * service requires is a name the website will never offer.\n */\nexport interface CategoryUsage {\n  categoryId: string;\n  services: CategoryUsageService[];\n}\n\nexport interface SetContentRequirementsInput {\n  requirements: ContentResourceRequirementItem[];\n}\n\n// ============================================\n// Kind Defaults\n// ============================================\n\nexport interface KindDefaults {\n  label: string;\n  description: string;\n  defaultCapacity: number;\n  scheduleType: 'individual' | 'operating-hours' | 'date-range';\n  defaultFields: string[];\n  defaultResourceType: ResourceType;\n  useCase: string;\n}\n\nexport const KIND_DEFAULTS: Record<ResourceCategoryKind, KindDefaults> = {\n  person: {\n    label: 'Person',\n    description: 'Individual service providers with their own schedule',\n    defaultCapacity: 1,\n    scheduleType: 'individual',\n    defaultFields: ['name', 'photo', 'skills', 'break-times'],\n    defaultResourceType: 'staff',\n    useCase: 'Stylist, doctor, therapist, instructor',\n  },\n  space: {\n    label: 'Space',\n    description: 'Shared spaces with variable capacity',\n    defaultCapacity: 10,\n    scheduleType: 'operating-hours',\n    defaultFields: ['name', 'capacity', 'amenities'],\n    defaultResourceType: 'room',\n    useCase: 'Room, table, studio, court',\n  },\n  equipment: {\n    label: 'Equipment',\n    description: 'Physical equipment with maintenance windows',\n    defaultCapacity: 1,\n    scheduleType: 'operating-hours',\n    defaultFields: ['name', 'serial-number', 'condition'],\n    defaultResourceType: 'equipment',\n    useCase: 'Projector, dermatoscope, vehicle',\n  },\n  unit: {\n    label: 'Unit',\n    description: 'Date-range units for nightly/weekly bookings',\n    defaultCapacity: 1,\n    scheduleType: 'date-range',\n    defaultFields: ['name', 'photos', 'check-in', 'check-out'],\n    defaultResourceType: 'room',\n    useCase: 'Property, apartment, rental car',\n  },\n};\n\n// ============================================\n// Kind → Default ResourceType mapping\n// ============================================\n\nexport function kindToResourceType(kind: ResourceCategoryKind): ResourceType {\n  return KIND_DEFAULTS[kind].defaultResourceType;\n}\n\n// ============================================\n// Helper: Kind option labels for UI\n// ============================================\n\ninterface KindOption {\n  label: string;\n  description: string;\n  emoji: string;\n}\n\n/**\n * Every kind a group can be, described once.\n *\n * A `Record` KEYED ON THE UNION, not an array of objects that happen to carry a\n * `value`. The array shape compiled perfectly with a kind missing from it — the\n * element type says what each entry looks like and nothing says the set is\n * complete — so adding a fifth `ResourceCategoryKind` would have left it out of\n * the Add group picker on both desktop and mobile, silently, with the type\n * checker satisfied. That is this codebase's own recurring bug: a thing\n * declared in one place and not connected in another.\n *\n * Keyed, a new kind is a compile error in this file until somebody writes the\n * label a merchant will read. John, 2026-08-23: *\"on the add group, all those\n * categories — check, don't let us miss out on anything\"*. Today's four are all\n * there; this is what makes tomorrow's fifth be there too.\n */\nconst KINDS: Record<ResourceCategoryKind, KindOption> = {\n  person: {\n    label: 'Person',\n    description: 'Staff, providers, instructors',\n    emoji: '👤',\n  },\n  space: {\n    label: 'Space',\n    description: 'Rooms, tables, studios',\n    emoji: '🏠',\n  },\n  equipment: {\n    label: 'Equipment',\n    description: 'Devices, vehicles, tools',\n    emoji: '🔧',\n  },\n  unit: {\n    label: 'Unit',\n    description: 'Properties, apartments, rentals',\n    emoji: '🏢',\n  },\n};\n\n/**\n * The order they are offered in, deliberate rather than alphabetical: a person\n * and a space are what most businesses book, equipment and units are the long\n * tail.\n *\n * ALSO KEYED ON THE UNION, for the same reason the descriptions are. A plain\n * `ResourceCategoryKind[]` would have compiled with an entry missing and\n * dropped that kind from the picker — the exact hole the Record above closes,\n * reopened one line later by the thing that orders it.\n */\nconst KIND_RANK: Record<ResourceCategoryKind, number> = {\n  person: 0,\n  space: 1,\n  equipment: 2,\n  unit: 3,\n};\n\nexport const KIND_OPTIONS: ({\n  value: ResourceCategoryKind;\n} & KindOption)[] = (Object.keys(KINDS) as ResourceCategoryKind[])\n  .sort((a, b) => KIND_RANK[a] - KIND_RANK[b])\n  .map((value) => ({ value, ...KINDS[value] }));\n\n// ============================================\n// Day labels for schedule\n// ============================================\n\nexport const DAY_LABELS = [\n  'Sunday',\n  'Monday',\n  'Tuesday',\n  'Wednesday',\n  'Thursday',\n  'Friday',\n  'Saturday',\n] as const;\n\nexport const SHORT_DAY_LABELS = [\n  'Sun',\n  'Mon',\n  'Tue',\n  'Wed',\n  'Thu',\n  'Fri',\n  'Sat',\n] as const;\n"],"mappings":"AA4OO,MAAM,gBAA4D;AAAA,EACvE,QAAQ;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,iBAAiB;AAAA,IACjB,cAAc;AAAA,IACd,eAAe,CAAC,QAAQ,SAAS,UAAU,aAAa;AAAA,IACxD,qBAAqB;AAAA,IACrB,SAAS;AAAA,EACX;AAAA,EACA,OAAO;AAAA,IACL,OAAO;AAAA,IACP,aAAa;AAAA,IACb,iBAAiB;AAAA,IACjB,cAAc;AAAA,IACd,eAAe,CAAC,QAAQ,YAAY,WAAW;AAAA,IAC/C,qBAAqB;AAAA,IACrB,SAAS;AAAA,EACX;AAAA,EACA,WAAW;AAAA,IACT,OAAO;AAAA,IACP,aAAa;AAAA,IACb,iBAAiB;AAAA,IACjB,cAAc;AAAA,IACd,eAAe,CAAC,QAAQ,iBAAiB,WAAW;AAAA,IACpD,qBAAqB;AAAA,IACrB,SAAS;AAAA,EACX;AAAA,EACA,MAAM;AAAA,IACJ,OAAO;AAAA,IACP,aAAa;AAAA,IACb,iBAAiB;AAAA,IACjB,cAAc;AAAA,IACd,eAAe,CAAC,QAAQ,UAAU,YAAY,WAAW;AAAA,IACzD,qBAAqB;AAAA,IACrB,SAAS;AAAA,EACX;AACF;AAMO,SAAS,mBAAmB,MAA0C;AAC3E,SAAO,cAAc,IAAI,EAAE;AAC7B;AA4BA,MAAM,QAAkD;AAAA,EACtD,QAAQ;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,OAAO;AAAA,EACT;AAAA,EACA,OAAO;AAAA,IACL,OAAO;AAAA,IACP,aAAa;AAAA,IACb,OAAO;AAAA,EACT;AAAA,EACA,WAAW;AAAA,IACT,OAAO;AAAA,IACP,aAAa;AAAA,IACb,OAAO;AAAA,EACT;AAAA,EACA,MAAM;AAAA,IACJ,OAAO;AAAA,IACP,aAAa;AAAA,IACb,OAAO;AAAA,EACT;AACF;AAYA,MAAM,YAAkD;AAAA,EACtD,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,WAAW;AAAA,EACX,MAAM;AACR;AAEO,MAAM,eAEQ,OAAO,KAAK,KAAK,EACnC,KAAK,CAAC,GAAG,MAAM,UAAU,CAAC,IAAI,UAAU,CAAC,CAAC,EAC1C,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,MAAM,KAAK,EAAE,EAAE;AAMvC,MAAM,aAAa;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,mBAAmB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;","names":[]}

package/dist/resume-screen.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Putting someone back where they were when the app starts over.
+ *
+ * An installed phone app is relaunched at its start address (Home) after the
+ * phone has dropped it from memory — a call, another app taking the room. A
+ * browser tab reopens at the address it was on, so only the installed app
+ * needs this, and only for a short while: someone who comes back the next
+ * morning meant to start at Home.
+ */
+export declare const RESUME_MAX_AGE_MS: number;
+export interface LastScreen {
+    /** Path and query, as it was when they left. */
+    path: string;
+    /** The last moment they were on it. */
+    savedAt: number;
+    tenantSlug: string;
+}
+export declare function isResumable(path: string): boolean;
+/**
+ * Where to send them, or null to leave them on Home.
+ *
+ * Only from a bare start on `/dashboard`, only in the installed app, only for
+ * the same workspace and only if they left recently.
+ */
+export declare function resumeTarget({ current, standalone, saved, tenantSlug, now, }: {
+    current: string;
+    standalone: boolean;
+    saved: LastScreen | null;
+    tenantSlug: string;
+    now: number;
+}): string | null;

package/dist/resume-screen.js

@@ -0,0 +1,25 @@
+const RESUME_MAX_AGE_MS = 30 * 60 * 1e3;
+function isResumable(path) {
+  return path.startsWith("/dashboard/") && // Never put someone back onto the sign-in or setup flows.
+  !/^\/dashboard\/(workspaces|setup|onboarding)(\/|$)/.test(path);
+}
+function resumeTarget({
+  current,
+  standalone,
+  saved,
+  tenantSlug,
+  now
+}) {
+  if (!standalone || current !== "/dashboard" || !saved) return null;
+  if (saved.tenantSlug !== tenantSlug) return null;
+  if (now < saved.savedAt || now - saved.savedAt > RESUME_MAX_AGE_MS) {
+    return null;
+  }
+  return isResumable(saved.path) ? saved.path : null;
+}
+export {
+  RESUME_MAX_AGE_MS,
+  isResumable,
+  resumeTarget
+};
+//# sourceMappingURL=resume-screen.js.map

package/dist/resume-screen.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resume-screen.ts"],"sourcesContent":["/**\n * Putting someone back where they were when the app starts over.\n *\n * An installed phone app is relaunched at its start address (Home) after the\n * phone has dropped it from memory — a call, another app taking the room. A\n * browser tab reopens at the address it was on, so only the installed app\n * needs this, and only for a short while: someone who comes back the next\n * morning meant to start at Home.\n */\n\nexport const RESUME_MAX_AGE_MS = 30 * 60 * 1000;\n\nexport interface LastScreen {\n  /** Path and query, as it was when they left. */\n  path: string;\n  /** The last moment they were on it. */\n  savedAt: number;\n  tenantSlug: string;\n}\n\nexport function isResumable(path: string): boolean {\n  return (\n    path.startsWith('/dashboard/') &&\n    // Never put someone back onto the sign-in or setup flows.\n    !/^\\/dashboard\\/(workspaces|setup|onboarding)(\\/|$)/.test(path)\n  );\n}\n\n/**\n * Where to send them, or null to leave them on Home.\n *\n * Only from a bare start on `/dashboard`, only in the installed app, only for\n * the same workspace and only if they left recently.\n */\nexport function resumeTarget({\n  current,\n  standalone,\n  saved,\n  tenantSlug,\n  now,\n}: {\n  current: string;\n  standalone: boolean;\n  saved: LastScreen | null;\n  tenantSlug: string;\n  now: number;\n}): string | null {\n  if (!standalone || current !== '/dashboard' || !saved) return null;\n  if (saved.tenantSlug !== tenantSlug) return null;\n  if (now < saved.savedAt || now - saved.savedAt > RESUME_MAX_AGE_MS) {\n    return null;\n  }\n  return isResumable(saved.path) ? saved.path : null;\n}\n"],"mappings":"AAUO,MAAM,oBAAoB,KAAK,KAAK;AAUpC,SAAS,YAAY,MAAuB;AACjD,SACE,KAAK,WAAW,aAAa;AAAA,EAE7B,CAAC,oDAAoD,KAAK,IAAI;AAElE;AAQO,SAAS,aAAa;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAMkB;AAChB,MAAI,CAAC,cAAc,YAAY,gBAAgB,CAAC,MAAO,QAAO;AAC9D,MAAI,MAAM,eAAe,WAAY,QAAO;AAC5C,MAAI,MAAM,MAAM,WAAW,MAAM,MAAM,UAAU,mBAAmB;AAClE,WAAO;AAAA,EACT;AACA,SAAO,YAAY,MAAM,IAAI,IAAI,MAAM,OAAO;AAChD;","names":[]}

package/dist/rider-display.d.ts

@@ -0,0 +1,37 @@
+import type { DeliveryAssignment, DeliveryStatus } from './api/deliveries';
+import type { Rider, RiderShownStatus } from './api/riders';
+/**
+ * How riders and their deliveries read on the dashboard. Pure, so the words
+ * the merchant sees are tested in one place.
+ */
+export declare const RIDER_STATUS_LABEL: Record<RiderShownStatus, string>;
+/** "3 riders · 1 on a delivery". */
+export declare function ridersSummary(riders: Rider[]): string;
+/** "just now", "12 min ago", "2 h ago", or the day. */
+export declare function timeAgo(iso: string, nowMs?: number): string;
+/** "2:10 pm". */
+export declare function clockTime(iso: string): string;
+/** What the rider is doing now, for the line under their name. */
+export declare function riderNowLine(rider: Rider, nowMs?: number): string;
+/** "4 delivered today · 0 failed". */
+export declare function todayLine(rider: Pick<Rider, 'deliveredToday' | 'failedToday'>): string;
+/** The delivery's status, in the merchant's words. */
+export declare function deliveryStatusLabel(a: Pick<DeliveryAssignment, 'status' | 'notAcceptedYet'>): string;
+export type TimelineState = 'done' | 'waiting' | 'failed';
+export interface TimelineStep {
+    label: string;
+    state: TimelineState;
+    /** "2:10 pm", or what it is waiting for. */
+    detail: string;
+}
+/** Accepted, Picked up, Delivered: the three taps the rider makes. */
+export declare function deliveryTimeline(a: DeliveryAssignment): TimelineStep[];
+/** A delivery still in the rider's hands. */
+export declare function isActiveDelivery(status: DeliveryStatus): boolean;
+/** Riders the merchant can pick: on ones only, available first, then the least busy. */
+export declare function ridersForPicking(riders: Rider[]): Rider[];
+/** "Carrying 2", or nothing when free. */
+export declare function carryingLine(rider: Rider): string;
+/** "TB" for Tunde Bello. */
+export declare function initials(name: string): string;
+export declare const firstName: (name: string) => string;

package/dist/rider-display.js

@@ -0,0 +1,110 @@
+import { formatOrderNumber } from "./order-config";
+const RIDER_STATUS_LABEL = {
+  available: "Available",
+  on_delivery: "On a delivery",
+  off: "Off"
+};
+const plural = (n, one, many) => `${n} ${n === 1 ? one : many}`;
+function ridersSummary(riders) {
+  if (riders.length === 0) return "No riders yet";
+  const busy = riders.filter((r) => r.status === "on_delivery").length;
+  return `${plural(riders.length, "rider", "riders")} \xB7 ${busy} on a delivery`;
+}
+function timeAgo(iso, nowMs = Date.now()) {
+  const minutes = Math.floor((nowMs - new Date(iso).getTime()) / 6e4);
+  if (minutes < 1) return "just now";
+  if (minutes < 60) return `${minutes} min ago`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) return `${hours} h ago`;
+  return new Date(iso).toLocaleDateString(void 0, {
+    day: "numeric",
+    month: "short"
+  });
+}
+function clockTime(iso) {
+  return new Date(iso).toLocaleTimeString("en-GB", { hour: "numeric", minute: "2-digit", hour12: true }).replace(/\s?([ap])\.?m\.?/i, " $1m").toLowerCase();
+}
+const NOT_ACCEPTED_MS = 15 * 6e4;
+function riderNowLine(rider, nowMs = Date.now()) {
+  const now = rider.now;
+  if (now) {
+    const order = formatOrderNumber(now.orderNumber);
+    if (now.step === "picked_up" && now.pickedUpAt)
+      return `Picked up ${order} \xB7 ${timeAgo(now.pickedUpAt, nowMs)}`;
+    if (now.step === "accepted" && now.acceptedAt)
+      return `Accepted ${order} \xB7 ${timeAgo(now.acceptedAt, nowMs)}`;
+    const waited = nowMs - new Date(now.assignedAt).getTime();
+    return waited > NOT_ACCEPTED_MS ? `Not accepted yet \xB7 ${order}` : `Sent ${order} \xB7 ${timeAgo(now.assignedAt, nowMs)}`;
+  }
+  if (rider.availability === "off") return "Turned off by the shop";
+  if (rider.deliveredToday > 0) return `${rider.deliveredToday} delivered today`;
+  return "Ready for deliveries";
+}
+function todayLine(rider) {
+  return `${rider.deliveredToday} delivered today \xB7 ${rider.failedToday} failed`;
+}
+function deliveryStatusLabel(a) {
+  const labels = {
+    assigned: a.notAcceptedYet ? "Not accepted yet" : "Waiting for the rider",
+    accepted: "Accepted",
+    picked_up: "On the way",
+    delivered: "Delivered",
+    failed: "Delivery failed",
+    declined: "Declined",
+    cancelled: "Cancelled",
+    reassigned: "Moved to another rider"
+  };
+  return labels[a.status];
+}
+function deliveryTimeline(a) {
+  const step = (label, at, waiting) => at ? { label, state: "done", detail: clockTime(at) } : { label, state: "waiting", detail: waiting };
+  const steps = [
+    step("Accepted", a.acceptedAt, "waiting for the rider"),
+    step("Picked up", a.pickedUpAt, a.acceptedAt ? "not yet" : "")
+  ];
+  if (a.status === "failed") {
+    steps.push({
+      label: "Couldn't deliver",
+      state: "failed",
+      detail: a.failedAt ? clockTime(a.failedAt) : ""
+    });
+  } else {
+    steps.push(
+      step("Delivered", a.deliveredAt, a.pickedUpAt ? "waiting for the code" : "")
+    );
+  }
+  return steps;
+}
+function isActiveDelivery(status) {
+  return status === "assigned" || status === "accepted" || status === "picked_up";
+}
+function ridersForPicking(riders) {
+  const rank = (r) => r.status === "available" ? 0 : 1;
+  return riders.filter((r) => r.availability !== "off" && !r.removedAt).sort(
+    (a, b) => rank(a) - rank(b) || a.activeDeliveries - b.activeDeliveries || a.name.localeCompare(b.name)
+  );
+}
+function carryingLine(rider) {
+  return rider.activeDeliveries > 0 ? `Carrying ${rider.activeDeliveries}` : "Free now";
+}
+function initials(name) {
+  const parts = name.trim().split(/\s+/).filter(Boolean);
+  return ((parts[0]?.[0] ?? "?") + (parts.length > 1 ? parts[parts.length - 1][0] : "")).toUpperCase();
+}
+const firstName = (name) => name.trim().split(/\s+/)[0] ?? name;
+export {
+  RIDER_STATUS_LABEL,
+  carryingLine,
+  clockTime,
+  deliveryStatusLabel,
+  deliveryTimeline,
+  firstName,
+  initials,
+  isActiveDelivery,
+  riderNowLine,
+  ridersForPicking,
+  ridersSummary,
+  timeAgo,
+  todayLine
+};
+//# sourceMappingURL=rider-display.js.map

package/dist/rider-display.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rider-display.ts"],"sourcesContent":["import type { DeliveryAssignment, DeliveryStatus } from './api/deliveries';\nimport type { Rider, RiderShownStatus } from './api/riders';\nimport { formatOrderNumber } from './order-config';\n\n/**\n * How riders and their deliveries read on the dashboard. Pure, so the words\n * the merchant sees are tested in one place.\n */\nexport const RIDER_STATUS_LABEL: Record<RiderShownStatus, string> = {\n  available: 'Available',\n  on_delivery: 'On a delivery',\n  off: 'Off',\n};\n\nconst plural = (n: number, one: string, many: string) =>\n  `${n} ${n === 1 ? one : many}`;\n\n/** \"3 riders · 1 on a delivery\". */\nexport function ridersSummary(riders: Rider[]): string {\n  if (riders.length === 0) return 'No riders yet';\n  const busy = riders.filter((r) => r.status === 'on_delivery').length;\n  return `${plural(riders.length, 'rider', 'riders')} · ${busy} on a delivery`;\n}\n\n/** \"just now\", \"12 min ago\", \"2 h ago\", or the day. */\nexport function timeAgo(iso: string, nowMs = Date.now()): string {\n  const minutes = Math.floor((nowMs - new Date(iso).getTime()) / 60_000);\n  if (minutes < 1) return 'just now';\n  if (minutes < 60) return `${minutes} min ago`;\n  const hours = Math.floor(minutes / 60);\n  if (hours < 24) return `${hours} h ago`;\n  return new Date(iso).toLocaleDateString(undefined, {\n    day: 'numeric',\n    month: 'short',\n  });\n}\n\n/** \"2:10 pm\". */\nexport function clockTime(iso: string): string {\n  return new Date(iso)\n    .toLocaleTimeString('en-GB', { hour: 'numeric', minute: '2-digit', hour12: true })\n    .replace(/\\s?([ap])\\.?m\\.?/i, ' $1m')\n    .toLowerCase();\n}\n\nconst NOT_ACCEPTED_MS = 15 * 60_000;\n\n/** What the rider is doing now, for the line under their name. */\nexport function riderNowLine(rider: Rider, nowMs = Date.now()): string {\n  const now = rider.now;\n  if (now) {\n    const order = formatOrderNumber(now.orderNumber);\n    if (now.step === 'picked_up' && now.pickedUpAt)\n      return `Picked up ${order} · ${timeAgo(now.pickedUpAt, nowMs)}`;\n    if (now.step === 'accepted' && now.acceptedAt)\n      return `Accepted ${order} · ${timeAgo(now.acceptedAt, nowMs)}`;\n    const waited = nowMs - new Date(now.assignedAt).getTime();\n    return waited > NOT_ACCEPTED_MS\n      ? `Not accepted yet · ${order}`\n      : `Sent ${order} · ${timeAgo(now.assignedAt, nowMs)}`;\n  }\n  if (rider.availability === 'off') return 'Turned off by the shop';\n  if (rider.deliveredToday > 0) return `${rider.deliveredToday} delivered today`;\n  return 'Ready for deliveries';\n}\n\n/** \"4 delivered today · 0 failed\". */\nexport function todayLine(rider: Pick<Rider, 'deliveredToday' | 'failedToday'>): string {\n  return `${rider.deliveredToday} delivered today · ${rider.failedToday} failed`;\n}\n\n/** The delivery's status, in the merchant's words. */\nexport function deliveryStatusLabel(\n  a: Pick<DeliveryAssignment, 'status' | 'notAcceptedYet'>,\n): string {\n  const labels: Record<DeliveryStatus, string> = {\n    assigned: a.notAcceptedYet ? 'Not accepted yet' : 'Waiting for the rider',\n    accepted: 'Accepted',\n    picked_up: 'On the way',\n    delivered: 'Delivered',\n    failed: 'Delivery failed',\n    declined: 'Declined',\n    cancelled: 'Cancelled',\n    reassigned: 'Moved to another rider',\n  };\n  return labels[a.status];\n}\n\nexport type TimelineState = 'done' | 'waiting' | 'failed';\n\nexport interface TimelineStep {\n  label: string;\n  state: TimelineState;\n  /** \"2:10 pm\", or what it is waiting for. */\n  detail: string;\n}\n\n/** Accepted, Picked up, Delivered: the three taps the rider makes. */\nexport function deliveryTimeline(a: DeliveryAssignment): TimelineStep[] {\n  const step = (label: string, at: string | null, waiting: string): TimelineStep =>\n    at\n      ? { label, state: 'done', detail: clockTime(at) }\n      : { label, state: 'waiting', detail: waiting };\n\n  const steps = [\n    step('Accepted', a.acceptedAt, 'waiting for the rider'),\n    step('Picked up', a.pickedUpAt, a.acceptedAt ? 'not yet' : ''),\n  ];\n  if (a.status === 'failed') {\n    steps.push({\n      label: \"Couldn't deliver\",\n      state: 'failed',\n      detail: a.failedAt ? clockTime(a.failedAt) : '',\n    });\n  } else {\n    steps.push(\n      step('Delivered', a.deliveredAt, a.pickedUpAt ? 'waiting for the code' : ''),\n    );\n  }\n  return steps;\n}\n\n/** A delivery still in the rider's hands. */\nexport function isActiveDelivery(status: DeliveryStatus): boolean {\n  return status === 'assigned' || status === 'accepted' || status === 'picked_up';\n}\n\n/** Riders the merchant can pick: on ones only, available first, then the least busy. */\nexport function ridersForPicking(riders: Rider[]): Rider[] {\n  const rank = (r: Rider) => (r.status === 'available' ? 0 : 1);\n  return riders\n    .filter((r) => r.availability !== 'off' && !r.removedAt)\n    .sort(\n      (a, b) =>\n        rank(a) - rank(b) ||\n        a.activeDeliveries - b.activeDeliveries ||\n        a.name.localeCompare(b.name),\n    );\n}\n\n/** \"Carrying 2\", or nothing when free. */\nexport function carryingLine(rider: Rider): string {\n  return rider.activeDeliveries > 0 ? `Carrying ${rider.activeDeliveries}` : 'Free now';\n}\n\n/** \"TB\" for Tunde Bello. */\nexport function initials(name: string): string {\n  const parts = name.trim().split(/\\s+/).filter(Boolean);\n  return ((parts[0]?.[0] ?? '?') + (parts.length > 1 ? parts[parts.length - 1][0] : '')).toUpperCase();\n}\n\nexport const firstName = (name: string) => name.trim().split(/\\s+/)[0] ?? name;\n"],"mappings":"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","names":[]}

package/dist/rider-view.d.ts

@@ -0,0 +1,37 @@
+import type { Rider, RiderShownStatus } from './api/riders';
+/**
+ * The rules behind the Riders tab on the Delivery page: which riders a status
+ * filter keeps, what a list that is still arriving shows, and which server
+ * errors are worth showing a merchant word for word.
+ */
+export type RiderFilter = 'all' | RiderShownStatus;
+export declare const RIDER_FILTERS: {
+    value: RiderFilter;
+    label: string;
+}[];
+export declare function filterRiders(riders: Rider[], filter: RiderFilter): Rider[];
+export declare function riderCounts(riders: Rider[]): Record<RiderFilter, number>;
+export type ListState = 'loading' | 'error' | 'ready';
+/**
+ * What a polled list shows, read so a failing request cannot blink.
+ *
+ * React Query puts a query with no data back to `pending` every time it
+ * re-asks, so a list whose every request fails swung between "loading" and
+ * "failed" on each poll, and anything drawn from `isLoading` appeared and
+ * vanished with it. Once a request has failed (`errorUpdatedAt` is set) the
+ * list stays failed until data arrives.
+ */
+export declare function listState(query: {
+    data?: unknown;
+    isPending: boolean;
+    errorUpdatedAt: number;
+}): ListState;
+/**
+ * The server's own sentence when it wrote one for people ("Tunde already uses
+ * this email"), otherwise the fallback. A missing route ("Cannot POST
+ * /riders"), a server fault or a dropped connection is never shown raw.
+ */
+export declare function riderErrorMessage(err: unknown, fallback: string): string;
+export type DeliveryTab = 'riders' | 'delivery';
+/** The tab named in the address (`?tab=delivery`), else Riders. */
+export declare function deliveryTabFrom(search: string, canSeeRiders: boolean): DeliveryTab;

package/dist/rider-view.js

@@ -0,0 +1,47 @@
+const RIDER_FILTERS = [
+  { value: "all", label: "All" },
+  { value: "available", label: "Available" },
+  { value: "on_delivery", label: "On a delivery" },
+  { value: "off", label: "Off" }
+];
+function filterRiders(riders, filter) {
+  return filter === "all" ? riders : riders.filter((r) => r.status === filter);
+}
+function riderCounts(riders) {
+  const counts = {
+    all: riders.length,
+    available: 0,
+    on_delivery: 0,
+    off: 0
+  };
+  for (const r of riders) counts[r.status] += 1;
+  return counts;
+}
+function listState(query) {
+  if (query.data !== void 0) return "ready";
+  if (query.errorUpdatedAt > 0) return "error";
+  return query.isPending ? "loading" : "ready";
+}
+const MACHINE = /^(Cannot (GET|POST|PUT|PATCH|DELETE) \/|HTTP \d{3}\b|Failed to fetch|NetworkError|Load failed|Internal server error)/i;
+function riderErrorMessage(err, fallback) {
+  const retry = `${fallback} Try again in a few minutes.`;
+  if (!(err instanceof Error) || !err.message.trim()) return retry;
+  const status = err.status;
+  if (typeof status === "number" && (status === 404 || status === 405 || status >= 500)) {
+    return retry;
+  }
+  return MACHINE.test(err.message.trim()) ? retry : err.message;
+}
+function deliveryTabFrom(search, canSeeRiders) {
+  if (!canSeeRiders) return "delivery";
+  return new URLSearchParams(search).get("tab") === "delivery" ? "delivery" : "riders";
+}
+export {
+  RIDER_FILTERS,
+  deliveryTabFrom,
+  filterRiders,
+  listState,
+  riderCounts,
+  riderErrorMessage
+};
+//# sourceMappingURL=rider-view.js.map

package/dist/rider-view.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/rider-view.ts"],"sourcesContent":["import type { Rider, RiderShownStatus } from './api/riders';\n\n/**\n * The rules behind the Riders tab on the Delivery page: which riders a status\n * filter keeps, what a list that is still arriving shows, and which server\n * errors are worth showing a merchant word for word.\n */\n\nexport type RiderFilter = 'all' | RiderShownStatus;\n\nexport const RIDER_FILTERS: { value: RiderFilter; label: string }[] = [\n  { value: 'all', label: 'All' },\n  { value: 'available', label: 'Available' },\n  { value: 'on_delivery', label: 'On a delivery' },\n  { value: 'off', label: 'Off' },\n];\n\nexport function filterRiders(riders: Rider[], filter: RiderFilter): Rider[] {\n  return filter === 'all' ? riders : riders.filter((r) => r.status === filter);\n}\n\nexport function riderCounts(riders: Rider[]): Record<RiderFilter, number> {\n  const counts: Record<RiderFilter, number> = {\n    all: riders.length,\n    available: 0,\n    on_delivery: 0,\n    off: 0,\n  };\n  for (const r of riders) counts[r.status] += 1;\n  return counts;\n}\n\nexport type ListState = 'loading' | 'error' | 'ready';\n\n/**\n * What a polled list shows, read so a failing request cannot blink.\n *\n * React Query puts a query with no data back to `pending` every time it\n * re-asks, so a list whose every request fails swung between \"loading\" and\n * \"failed\" on each poll, and anything drawn from `isLoading` appeared and\n * vanished with it. Once a request has failed (`errorUpdatedAt` is set) the\n * list stays failed until data arrives.\n */\nexport function listState(query: {\n  data?: unknown;\n  isPending: boolean;\n  errorUpdatedAt: number;\n}): ListState {\n  if (query.data !== undefined) return 'ready';\n  if (query.errorUpdatedAt > 0) return 'error';\n  return query.isPending ? 'loading' : 'ready';\n}\n\n/** Messages a framework writes when a route is missing, not a sentence for people. */\nconst MACHINE = /^(Cannot (GET|POST|PUT|PATCH|DELETE) \\/|HTTP \\d{3}\\b|Failed to fetch|NetworkError|Load failed|Internal server error)/i;\n\n/**\n * The server's own sentence when it wrote one for people (\"Tunde already uses\n * this email\"), otherwise the fallback. A missing route (\"Cannot POST\n * /riders\"), a server fault or a dropped connection is never shown raw.\n */\nexport function riderErrorMessage(err: unknown, fallback: string): string {\n  const retry = `${fallback} Try again in a few minutes.`;\n  if (!(err instanceof Error) || !err.message.trim()) return retry;\n  const status = (err as { status?: unknown }).status;\n  if (typeof status === 'number' && (status === 404 || status === 405 || status >= 500)) {\n    return retry;\n  }\n  return MACHINE.test(err.message.trim()) ? retry : err.message;\n}\n\nexport type DeliveryTab = 'riders' | 'delivery';\n\n/** The tab named in the address (`?tab=delivery`), else Riders. */\nexport function deliveryTabFrom(search: string, canSeeRiders: boolean): DeliveryTab {\n  if (!canSeeRiders) return 'delivery';\n  return new URLSearchParams(search).get('tab') === 'delivery' ? 'delivery' : 'riders';\n}\n"],"mappings":"AAUO,MAAM,gBAAyD;AAAA,EACpE,EAAE,OAAO,OAAO,OAAO,MAAM;AAAA,EAC7B,EAAE,OAAO,aAAa,OAAO,YAAY;AAAA,EACzC,EAAE,OAAO,eAAe,OAAO,gBAAgB;AAAA,EAC/C,EAAE,OAAO,OAAO,OAAO,MAAM;AAC/B;AAEO,SAAS,aAAa,QAAiB,QAA8B;AAC1E,SAAO,WAAW,QAAQ,SAAS,OAAO,OAAO,CAAC,MAAM,EAAE,WAAW,MAAM;AAC7E;AAEO,SAAS,YAAY,QAA8C;AACxE,QAAM,SAAsC;AAAA,IAC1C,KAAK,OAAO;AAAA,IACZ,WAAW;AAAA,IACX,aAAa;AAAA,IACb,KAAK;AAAA,EACP;AACA,aAAW,KAAK,OAAQ,QAAO,EAAE,MAAM,KAAK;AAC5C,SAAO;AACT;AAaO,SAAS,UAAU,OAIZ;AACZ,MAAI,MAAM,SAAS,OAAW,QAAO;AACrC,MAAI,MAAM,iBAAiB,EAAG,QAAO;AACrC,SAAO,MAAM,YAAY,YAAY;AACvC;AAGA,MAAM,UAAU;AAOT,SAAS,kBAAkB,KAAc,UAA0B;AACxE,QAAM,QAAQ,GAAG,QAAQ;AACzB,MAAI,EAAE,eAAe,UAAU,CAAC,IAAI,QAAQ,KAAK,EAAG,QAAO;AAC3D,QAAM,SAAU,IAA6B;AAC7C,MAAI,OAAO,WAAW,aAAa,WAAW,OAAO,WAAW,OAAO,UAAU,MAAM;AACrF,WAAO;AAAA,EACT;AACA,SAAO,QAAQ,KAAK,IAAI,QAAQ,KAAK,CAAC,IAAI,QAAQ,IAAI;AACxD;AAKO,SAAS,gBAAgB,QAAgB,cAAoC;AAClF,MAAI,CAAC,aAAc,QAAO;AAC1B,SAAO,IAAI,gBAAgB,MAAM,EAAE,IAAI,KAAK,MAAM,aAAa,aAAa;AAC9E;","names":[]}