@volter/twin-stripe 2.0.38 → 3.0.1

package/src/stripe-shared.ts

@@ -1,297 +0,0 @@
-// The stripe mirror's SHARED vocabulary — formatters, tones, reference resolution — with no
-// import from the server side: the mirror client bundles this into the browser (a server import
-// would drag core, and with it node:async_hooks, into the bundle and the page would never mount).
-// The server module re-exports it, so nothing else moves.
-
-export type StripeRow = Record<string, any>;
-
-/** The name an account shows its customers (Checkout, the customer portal): its public business name,
- *  `business_profile.name` ("The customer-facing business name", docs.stripe.com/api/accounts/object), which the
- *  operator sets on the Dashboard ("You can change a Checkout page's name by modifying the Business name field",
- *  docs.stripe.com/payments/checkout/customization/appearance). Where the documentation stops and the twin decides:
- *  with none set it falls back to the Dashboard's account name, `settings.dashboard.display_name` ("used on the Stripe
- *  Dashboard to differentiate between accounts", the same object page), and with neither to "Twin Inc.", the name the
- *  Dashboard mirror has always given the World's own account. */
-export const PLATFORM_DEFAULT_NAME = 'Twin Inc.';
-/** The bookkeeping type of a connected account's Connect OAuth connection (screens/connect-oauth.tsx): one row per
- *  account, `revoked: true` once deauthorized or its code reused. Read by the account list and the event path too. */
-export const OAUTH_CONNECTIONS = '_oauth_connection';
-export function publicBusinessName(account: StripeRow | undefined): string {
-  const named = (v: unknown): string | undefined => (typeof v === 'string' && v.trim() ? v : undefined);
-  return named(account?.business_profile?.name) ?? named(account?.settings?.dashboard?.display_name) ?? PLATFORM_DEFAULT_NAME;
-}
-
-/** Zero-decimal currencies (Stripe stores these in whole units, not cents). */
-const ZERO_DECIMAL = new Set(['bif', 'clp', 'djf', 'gnf', 'jpy', 'kmf', 'krw', 'mga', 'pyg', 'rwf', 'ugx', 'vnd', 'vuv', 'xaf', 'xof', 'xpf']);
-
-/**
- * Format a Stripe minor-unit amount (cents) as a localized currency string.
- * Honors zero-decimal currencies (¥4200 not ¥42.00). Non-numbers → an em dash.
- */
-export function formatStripeAmount(value: unknown, currency?: string): string {
-  if (typeof value !== 'number' || !Number.isFinite(value)) return '—';
-  const ccy = String(currency ?? 'usd').toLowerCase();
-  const zero = ZERO_DECIMAL.has(ccy);
-  const major = zero ? value : value / 100;
-  try {
-    return new Intl.NumberFormat('en-US', {
-      style: 'currency', currency: ccy.toUpperCase(),
-      minimumFractionDigits: zero ? 0 : 2, maximumFractionDigits: zero ? 0 : 2,
-    }).format(major);
-  } catch {
-    // Unknown/invalid currency code → a stable, readable fallback.
-    return `${zero ? major : major.toFixed(2)} ${ccy.toUpperCase()}`;
-  }
-}
-
-/**
- * Render a Stripe price's `recurring` block as a short interval label, e.g.
- * "every month", "every 3 months". Returns '' when it isn't a recurring price.
- */
-export function formatRecurring(recurring: unknown): string {
-  if (!recurring || typeof recurring !== 'object') return '';
-  const r = recurring as Record<string, unknown>;
-  const interval = typeof r.interval === 'string' ? r.interval : '';
-  if (!interval) return '';
-  const count = Number(r.interval_count);
-  return count > 1 ? `every ${count} ${interval}s` : `every ${interval}`;
-}
-
-/**
- * Render a saved payment method as a short human label, e.g. "Visa •••• 4242"
- * for a card, or the bare `type` ("us_bank_account") for non-card methods.
- */
-export function formatPaymentMethod(pm: unknown): string {
-  if (!pm || typeof pm !== 'object') return '—';
-  const m = pm as Record<string, any>;
-  const card = m.card && typeof m.card === 'object' ? (m.card as Record<string, any>) : undefined;
-  if (card && (card.brand || card.last4)) {
-    const brand = card.brand ? String(card.brand).replace(/\b\w/g, (c) => c.toUpperCase()) : 'Card';
-    return card.last4 ? `${brand} •••• ${card.last4}` : brand;
-  }
-  return typeof m.type === 'string' && m.type ? m.type : (m.id ?? '—');
-}
-
-/**
- * Extract the HTTP(S) image URLs from a product's `images` field (Stripe stores an
- * array of URL strings) so the mirror can render them as <img> thumbnails instead
- * of plain text. Non-arrays / non-URL entries are dropped. Order is preserved.
- */
-export function productImageUrls(images: unknown): string[] {
-  if (!Array.isArray(images)) return [];
-  return images.filter((u): u is string => typeof u === 'string' && /^https?:\/\//i.test(u));
-}
-
-/**
- * Render a payment_intent / charge `last_payment_error` (the test-card decline state)
- * as a single human-readable line, e.g. "card_declined (insufficient_funds): Your card
- * has insufficient funds." Returns '' when there is no error object. This is the
- * vendor-faithful decline reason the twin populates on a declined confirm.
- */
-export function formatPaymentError(error: unknown): string {
-  if (!error || typeof error !== 'object') return '';
-  const e = error as Record<string, any>;
-  const code = typeof e.code === 'string' ? e.code : '';
-  const declineCode = typeof e.decline_code === 'string' ? e.decline_code : '';
-  const message = typeof e.message === 'string' ? e.message : '';
-  const head = code ? (declineCode ? `${code} (${declineCode})` : code) : declineCode;
-  if (head && message) return `${head}: ${message}`;
-  return head || message;
-}
-
-/**
- * Summarize a synthesized Stripe `balance` object (available/pending arrays, one entry
- * per currency) into short per-bucket lines, e.g. ["available: $42.00", "pending: $0.00"].
- * The balance is not a list collection, so the mirror renders this summary directly.
- */
-export function formatBalanceSummary(balance: unknown): Array<{ bucket: string; text: string }> {
-  if (!balance || typeof balance !== 'object') return [];
-  const b = balance as Record<string, any>;
-  const sum = (arr: unknown): string => {
-    if (!Array.isArray(arr) || arr.length === 0) return formatStripeAmount(0, 'usd');
-    return arr
-      .map((e) => formatStripeAmount((e as Record<string, any>)?.amount, (e as Record<string, any>)?.currency))
-      .join(', ');
-  };
-  const out: Array<{ bucket: string; text: string }> = [];
-  if (Array.isArray(b.available)) out.push({ bucket: 'available', text: sum(b.available) });
-  if (Array.isArray(b.pending)) out.push({ bucket: 'pending', text: sum(b.pending) });
-  return out;
-}
-
-/**
- * Summarize a Connect connected `account` object's enablement state into the three
- * boolean capability flags a real Stripe Connect dashboard shows up front:
- * charges_enabled, payouts_enabled, details_submitted. Each is rendered as a tone-
- * carrying flag (true → ok, false → warn) so an un-onboarded account reads as such.
- */
-export type AccountFlag = { key: string; label: string; enabled: boolean };
-export function formatAccountFlags(account: unknown): AccountFlag[] {
-  if (!account || typeof account !== 'object') return [];
-  const a = account as Record<string, any>;
-  return [
-    { key: 'charges_enabled', label: 'Charges', enabled: a.charges_enabled === true },
-    { key: 'payouts_enabled', label: 'Payouts', enabled: a.payouts_enabled === true },
-    { key: 'details_submitted', label: 'Details submitted', enabled: a.details_submitted === true },
-  ];
-}
-
-/**
- * Extract a Connect account's outstanding onboarding requirements (the
- * `requirements.currently_due` list real Stripe shows as "needs attention"). Returns
- * an ordered list of the still-due field paths; empty when nothing is due.
- */
-export function accountCurrentlyDue(account: unknown): string[] {
-  if (!account || typeof account !== 'object') return [];
-  const req = (account as Record<string, any>).requirements;
-  if (!req || typeof req !== 'object') return [];
-  const due = (req as Record<string, any>).currently_due;
-  return Array.isArray(due) ? due.filter((d): d is string => typeof d === 'string') : [];
-}
-
-/** Tone for a status pill: 'ok' (green), 'warn' (amber), 'bad' (red), '' (neutral). */
-export type PillTone = 'ok' | 'warn' | 'bad' | '';
-const PILL_OK = new Set(['active', 'succeeded', 'paid', 'true', 'enabled', 'available', 'won']);
-const PILL_WARN = new Set(['open', 'draft', 'pending', 'processing', 'incomplete', 'trialing', 'requires_confirmation', 'requires_action', 'requires_capture', 'requires_payment_method', 'past_due', 'unpaid', 'in_transit', 'warning_needs_response', 'needs_response', 'under_review', 'warning_under_review']);
-const PILL_BAD = new Set(['canceled', 'cancelled', 'void', 'uncollectible', 'failed', 'incomplete_expired', 'false', 'disabled', 'lost', 'charge_refunded']);
-export function statusTone(value: unknown): PillTone {
-  const v = String(value ?? '').toLowerCase();
-  if (PILL_OK.has(v)) return 'ok';
-  if (PILL_BAD.has(v)) return 'bad';
-  if (PILL_WARN.has(v)) return 'warn';
-  return '';
-}
-
-/** True when a key names a field whose value is a Stripe object id we can link. */
-export function isReferenceKey(key: string): boolean {
-  return REFERENCE_FIELDS.has(key);
-}
-// field name → the COLLECTION it points at (so the UI can jump sections + select).
-const REFERENCE_FIELD_MAP: Record<string, string> = {
-  customer: 'customers', product: 'products', price: 'prices',
-  subscription: 'subscriptions', latest_invoice: 'invoices', invoice: 'invoices',
-  payment_intent: 'payment_intents', latest_charge: 'charges', charge: 'charges',
-  payment_method: 'payment_methods', default_payment_method: 'payment_methods',
-  dispute: 'disputes', payout: 'payouts', balance_transaction: 'balance_transactions',
-  source_transaction: 'charges', setup_intent: 'setup_intents',
-  // Connect: a transfer's `destination` points at a connected account.
-  account: 'accounts', destination: 'accounts',
-  // Billing: a customer_balance_transaction may reference the credit_note that created it.
-  credit_note: 'credit_notes',
-};
-const REFERENCE_FIELDS = new Set(Object.keys(REFERENCE_FIELD_MAP));
-/** The collection a reference field points at, or undefined if not a reference. */
-export function referenceCollection(key: string): string | undefined {
-  return REFERENCE_FIELD_MAP[key];
-}
-
-/** A single line in the flattened, human-readable view of a nested value. */
-export type FlatLine = { depth: number; label: string; value: string; ref?: string };
-
-/**
- * Flatten an arbitrary nested Stripe value (object / array / scalar) into ordered,
- * indented label/value lines suitable for a readable detail view — instead of the
- * old "[object Object]". Stripe "list" wrappers ({object:'list',data:[...]}) are
- * unwrapped to their `data`. Amount-ish fields are currency-formatted.
- */
-export function flattenStripeValue(value: unknown, opts: { label?: string; depth?: number; currency?: string } = {}): FlatLine[] {
-  const depth = opts.depth ?? 0;
-  const label = opts.label ?? '';
-  const currency = opts.currency;
-  if (value === null || value === undefined) return [{ depth, label, value: '—' }];
-
-  if (Array.isArray(value)) {
-    if (value.length === 0) return [{ depth, label, value: '(none)' }];
-    const out: FlatLine[] = label ? [{ depth, label, value: '' }] : [];
-    value.forEach((item, i) => {
-      const childDepth = label ? depth + 1 : depth;
-      out.push(...flattenStripeValue(item, { label: `#${i + 1}`, depth: childDepth, currency }));
-    });
-    return out;
-  }
-
-  if (typeof value === 'object') {
-    const obj = value as Record<string, unknown>;
-    // Unwrap Stripe list objects to their data array.
-    if (obj.object === 'list' && Array.isArray(obj.data)) {
-      return flattenStripeValue(obj.data, { label, depth, currency });
-    }
-    const childCurrency = typeof obj.currency === 'string' ? obj.currency : currency;
-    const keys = Object.keys(obj).filter((k) => obj[k] !== null && obj[k] !== undefined && k !== 'object');
-    if (keys.length === 0) return [{ depth, label, value: '(empty)' }];
-    const out: FlatLine[] = label ? [{ depth, label, value: '' }] : [];
-    const childDepth = label ? depth + 1 : depth;
-    for (const k of keys) out.push(...flattenStripeValue(obj[k], { label: k, depth: childDepth, currency: childCurrency }));
-    return out;
-  }
-
-  // scalar
-  const ref = typeof value === 'string' && isReferenceKey(label) ? value : undefined;
-  const isMoney = typeof value === 'number' && (label === 'unit_amount' || /amount|total|subtotal|balance/.test(label));
-  const rendered = isMoney ? formatStripeAmount(value, currency) : String(value);
-  return [{ depth, label, value: rendered, ...(ref ? { ref } : {}) }];
-}
-
-/**
- * Resolve the cross-references for a row: the rows in other collections that this
- * row points AT (outgoing, e.g. invoice→customer) and the rows that point BACK at
- * it (incoming, e.g. customer←subscriptions). Resolved purely from already-fetched
- * collection data, so the UI can render clickable links without extra requests.
- */
-export type RefLink = { collection: string; id: string; label: string };
-export type CrossRefs = { outgoing: RefLink[]; incoming: RefLink[] };
-
-const LABELERS: Record<string, (r: StripeRow) => string> = {
-  customers: (r) => r.name || r.email || r.id,
-  products: (r) => r.name || r.id,
-  prices: (r) => `${formatStripeAmount(r.unit_amount, r.currency)}${formatRecurring(r.recurring) ? ` ${formatRecurring(r.recurring)}` : ''}`,
-  subscriptions: (r) => `${r.status ?? 'subscription'} · ${r.id}`,
-  invoices: (r) => `${r.status ?? 'invoice'} · ${formatStripeAmount(r.total ?? r.amount_due, r.currency)}`,
-  payment_intents: (r) => `${formatStripeAmount(r.amount, r.currency)} · ${r.status ?? ''}`,
-  charges: (r) => `${formatStripeAmount(r.amount, r.currency)} · ${r.status ?? ''}`,
-  refunds: (r) => `${formatStripeAmount(r.amount, r.currency)} · ${r.status ?? 'refund'}`,
-  payment_methods: (r) => `${formatPaymentMethod(r)} · ${r.id}`,
-  disputes: (r) => `${formatStripeAmount(r.amount, r.currency)} · ${r.status ?? 'dispute'}`,
-  payouts: (r) => `${formatStripeAmount(r.amount, r.currency)} · ${r.status ?? 'payout'}`,
-  balance_transactions: (r) => `${formatStripeAmount(r.amount, r.currency)} · ${r.type ?? 'txn'}`,
-  events: (r) => `${r.type ?? 'event'} · ${r.id}`,
-  setup_intents: (r) => `${r.status ?? 'setup_intent'} · ${r.id}`,
-  invoiceitems: (r) => `${formatStripeAmount(r.amount, r.currency)} · ${r.id}`,
-  accounts: (r) => `${r.email || r.id} · ${r.type ?? 'account'}`,
-  transfers: (r) => `${formatStripeAmount(r.amount, r.currency)} → ${r.destination ?? '?'}`,
-  credit_notes: (r) => `${formatStripeAmount(r.amount, r.currency)} · ${r.status ?? 'credit_note'}`,
-  tax_ids: (r) => `${r.value ?? r.id} · ${r.type ?? ''}`,
-};
-function labelFor(collection: string, row: StripeRow): string {
-  return (LABELERS[collection] ?? ((r: StripeRow) => r.id))(row);
-}
-
-export function resolveCrossRefs(
-  collection: string,
-  row: StripeRow,
-  data: Record<string, StripeRow[]>,
-): CrossRefs {
-  const outgoing: RefLink[] = [];
-  const incoming: RefLink[] = [];
-  if (!row) return { outgoing, incoming };
-
-  // Outgoing: every reference field on this row that we can resolve to a row.
-  for (const [key, value] of Object.entries(row)) {
-    if (typeof value !== 'string' || !isReferenceKey(key)) continue;
-    const target = referenceCollection(key)!;
-    const found = (data[target] ?? []).find((r) => r.id === value);
-    outgoing.push({ collection: target, id: value, label: `${key}: ${found ? labelFor(target, found) : value}` });
-  }
-
-  // Incoming: rows in other collections whose reference field points at this row.
-  for (const [other, rows] of Object.entries(data)) {
-    if (other === collection) continue;
-    for (const r of rows) {
-      for (const [key, value] of Object.entries(r)) {
-        if (value !== row.id || !isReferenceKey(key)) continue;
-        incoming.push({ collection: other, id: r.id, label: `${labelFor(other, r)}` });
-      }
-    }
-  }
-  return { outgoing, incoming };
-}

package/src/stripe-ui-conformance.ts

@@ -1,88 +0,0 @@
-// Stripe UI conformance — the declared surface inventory of Stripe's Dashboard, classified against THIS
-// twin, and the read-only completeness check over it.
-//
-// Honesty: `status` is the current truth, verified by the structural cross-check in
-// stripe-ui-conformance.test.ts (which builds the actual Dashboard bundle and asserts each 'rendered'
-// surface's label/class is really present — downgrading to 'modeled' otherwise). `rendered` = the
-// Dashboard shows it today; `modeled` = the twin has the data but the Dashboard doesn't show it; `unmodeled`
-// = Stripe shows it but the twin doesn't model it.
-//
-// Classified against the Dashboard (client/stripe-mirror.tsx, reading through client/dashboard-api.ts):
-// Home, Balances, Transactions > Payments and a payment's page, Customers and a customer's page, Product
-// catalog, Billing's Subscriptions (and a subscription's page) and Invoices (and an invoice's page),
-// Developers, Settings, and the resource lists under Connect, Payments, Reporting and More.
-import { checkUiCompleteness, type UiSurface, type UiCompletenessReport } from '@volter/world-tooling';
-
-/** What Stripe's Dashboard shows, classified vs the twin + its Dashboard. */
-export const STRIPE_UI_INVENTORY: UiSurface[] = [
-  // --- shell ---
-  { key: 'navigation', label: 'Left navigation (Home, Balances, Transactions, Customers, Product catalog, Billing, Developers)', status: 'rendered' },
-  { key: 'testModeBand', label: 'Test-mode band', status: 'rendered' },
-  { key: 'search', label: 'Search across customers, payments, subscriptions, invoices, products', status: 'rendered' },
-  { key: 'statusPill', label: "Status pills in Stripe's words (Succeeded, Refunded, Failed, Active, Trialing, Paid, …)", status: 'rendered' },
-  { key: 'amountFormatting', label: 'Currency-formatted amounts with the currency code', status: 'rendered' },
-
-  // --- Home and Balances ---
-  { key: 'homeToday', label: "Home: today's gross volume, balance and payouts", status: 'rendered' },
-  { key: 'homeOverview', label: 'Home: overview metrics (gross/net volume, successful and failed payments, customers, subscribers)', status: 'rendered' },
-  { key: 'balanceSummary', label: 'Balances: incoming and available per currency', status: 'rendered' },
-  { key: 'balanceTransactions', label: 'Balances: recent activity (balance transactions) and payouts', status: 'rendered' },
-
-  // --- Payments ---
-  { key: 'paymentList', label: 'Payments list: amount + currency, status, payment method, description, customer, date', status: 'rendered' },
-  { key: 'paymentFilters', label: 'Payments status tabs with counts, and filter chips', status: 'rendered' },
-  { key: 'paymentRefundedDate', label: 'Payments list: refunded date and decline reason', status: 'rendered' },
-  { key: 'paymentExport', label: 'Payments export', status: 'rendered' },
-  { key: 'paymentTimeline', label: "A payment's timeline from its events", status: 'rendered' },
-  { key: 'paymentBreakdown', label: "A payment's breakdown (amount, refunded, net)", status: 'rendered' },
-  { key: 'paymentFees', label: "A payment's Stripe fees (balance transaction fee details)", status: 'unmodeled' },
-  { key: 'paymentRefunds', label: "A payment's refunds", status: 'rendered' },
-  { key: 'paymentMethodDetails', label: "A payment's card: last four, expiry, type, origin, CVC check", status: 'rendered' },
-  { key: 'paymentDecline', label: 'A declined payment states its error and decline code', status: 'rendered' },
-  { key: 'refundDialog', label: 'Refund a payment in full or in part, with a reason', status: 'rendered' },
-  { key: 'disputes', label: 'Disputes', status: 'rendered' },
-
-  // --- Customers ---
-  { key: 'customerList', label: 'Customers list: name, email, default payment method, created, total spend, payments, refunds', status: 'rendered' },
-  { key: 'createCustomer', label: 'Create customer', status: 'rendered' },
-  { key: 'customerDetails', label: "A customer's details (ID, since, email, description, billing details)", status: 'rendered' },
-  { key: 'customerSubscriptions', label: "A customer's subscriptions", status: 'rendered' },
-  { key: 'customerPayments', label: "A customer's payments", status: 'rendered' },
-  { key: 'customerPaymentMethods', label: "A customer's saved payment methods, default marked", status: 'rendered' },
-  { key: 'customerInvoices', label: "A customer's invoices", status: 'rendered' },
-  { key: 'customerEvents', label: "A customer's events", status: 'rendered' },
-
-  // --- Billing ---
-  { key: 'subscriptionList', label: 'Subscriptions list: customer, status, billing, product, amount, created', status: 'rendered' },
-  { key: 'subscriptionDetails', label: "A subscription's details: customer, period, trial, billing method, payment method", status: 'rendered' },
-  { key: 'subscriptionPricing', label: "A subscription's pricing items", status: 'rendered' },
-  { key: 'cancelSubscription', label: 'Cancel a subscription now or at period end', status: 'rendered' },
-  { key: 'invoiceList', label: 'Invoices list: amount, status, number, customer, due, created', status: 'rendered' },
-  { key: 'invoiceDetail', label: "An invoice's summary lines and totals", status: 'rendered' },
-  { key: 'quotes', label: 'Quotes', status: 'rendered' },
-
-  // --- Product catalog ---
-  { key: 'productCatalog', label: 'Product catalog: name, pricing, created, updated', status: 'rendered' },
-  { key: 'createProduct', label: 'Create product', status: 'rendered' },
-  { key: 'coupons', label: 'Coupons', status: 'rendered' },
-
-  // --- Developers and Settings ---
-  { key: 'apiKeys', label: 'API keys', status: 'rendered' },
-  { key: 'webhooks', label: 'Webhook endpoints', status: 'rendered' },
-  { key: 'eventsLog', label: 'Events', status: 'rendered' },
-  { key: 'payoutSchedule', label: 'Settings: payout schedule', status: 'rendered' },
-
-  // --- under More ---
-  { key: 'connectAccounts', label: 'Connect: connected accounts, readiness flags and requirements due', status: 'rendered' },
-  { key: 'connectTransfers', label: 'Connect: transfers', status: 'rendered' },
-  { key: 'radar', label: 'Radar: reviews, lists, rules', status: 'rendered' },
-  { key: 'terminal', label: 'Terminal: readers, locations', status: 'rendered' },
-  { key: 'issuing', label: 'Issuing: cards, cardholders', status: 'rendered' },
-  { key: 'taxRates', label: 'Tax: tax rates', status: 'rendered' },
-  { key: 'reports', label: 'Reporting: report runs', status: 'rendered' },
-];
-
-/** Read-only completeness check over the declared Stripe UI inventory. */
-export function stripeUiConformance(): UiCompletenessReport {
-  return checkUiCompleteness('stripe', STRIPE_UI_INVENTORY);
-}

package/src/stripe-ui-structure.ts

@@ -1,182 +0,0 @@
-// The Stripe Dashboard — structural DOM checklist (RUNG-5).
-//
-// Completeness (stripe-ui-conformance.ts) asks "does the Dashboard SHOW the data?". Structure asks
-// "does its rendered DOM have the landmarks Stripe's Dashboard has?": the left navigation at Stripe's
-// paths, the test-mode band, the Payments table with Stripe's columns and status pills, a payment's page
-// (amount, status, timeline from its events, breakdown, refunds, card), a customer's page (details,
-// subscriptions, payments, payment methods, invoices), a subscription's page (pricing, period, invoices,
-// the cancel control), the balance buckets, a connected account's readiness and the resource lists.
-//
-// Each check's `present` is computed from the ACTUAL markup renderToStaticMarkup() produces from the
-// Dashboard's own components (client/stripe-mirror.tsx) over objects shaped as the API returns them, so a
-// check cannot pass unless the component truly emits that structure. Read-only; deterministic.
-import { createElement } from 'react';
-import { renderToStaticMarkup } from 'react-dom/server';
-import { checkUiStructure, type UiStructureReport } from '@volter/world-tooling';
-import {
-  SECTIONS, SideNav, ListPane, TestModeBand, PaymentsTable, PaymentDetailView, CustomerDetailView,
-  SubscriptionDetailView, BalanceSummary, ConnectAccountPanel,
-} from '../client/stripe-mirror.tsx';
-import type { CustomerDetail, Payment, PaymentDetail, SubscriptionDetail } from '../client/dashboard-api.ts';
-import type { StripeRow } from './stripe-mirror-ui.ts';
-
-const noop = () => {};
-const AT = 1790263345;
-
-const CUSTOMER: StripeRow = { id: 'cus_twin001', object: 'customer', name: 'Ada Lovelace', email: 'ada@example.com', created: AT, invoice_settings: { default_payment_method: 'pm_twin001' }, metadata: {} };
-const CARD: StripeRow = { id: 'pm_twin001', object: 'payment_method', type: 'card', customer: 'cus_twin001', card: { brand: 'visa', last4: '4242', exp_month: 12, exp_year: 2034, funding: 'credit', country: 'US', checks: { cvc_check: 'pass' } }, billing_details: {} };
-const INTENT: StripeRow = { id: 'pi_twin001', object: 'payment_intent', amount: 30000, currency: 'usd', status: 'succeeded', customer: 'cus_twin001', payment_method: 'pm_twin001', latest_charge: 'ch_twin001', description: 'Annual workshop seat', created: AT, metadata: {} };
-const CHARGE: StripeRow = { id: 'ch_twin001', object: 'charge', amount: 30000, currency: 'usd', status: 'succeeded', refunded: false, amount_refunded: 10000, payment_intent: 'pi_twin001', customer: 'cus_twin001', created: AT };
-const REFUND: StripeRow = { id: 're_twin001', object: 'refund', amount: 10000, currency: 'usd', status: 'succeeded', charge: 'ch_twin001', payment_intent: 'pi_twin001', reason: 'requested_by_customer', created: AT + 60 };
-const event = (id: string, type: string, object: StripeRow, created: number): StripeRow => ({ id, object: 'event', type, created, data: { object } });
-
-const PARTIAL: PaymentDetail = {
-  id: 'pi_twin001', amount: 30000, currency: 'usd', status: 'partially_refunded', description: 'Annual workshop seat', created: AT,
-  customer: CUSTOMER, charge: CHARGE, intent: INTENT, paymentMethod: CARD, amountRefunded: 10000, refundedAt: AT + 60,
-  refunds: [REFUND],
-  events: [
-    event('evt_3', 'charge.refunded', CHARGE, AT + 60),
-    event('evt_2', 'payment_intent.succeeded', INTENT, AT + 1),
-    event('evt_1', 'payment_intent.created', INTENT, AT),
-  ],
-};
-const DECLINED_INTENT: StripeRow = {
-  id: 'pi_twin009', object: 'payment_intent', amount: 15000, currency: 'usd', status: 'requires_payment_method', customer: 'cus_twin001', created: AT,
-  last_payment_error: { type: 'card_error', code: 'card_declined', decline_code: 'insufficient_funds', message: 'Your card has insufficient funds.', param: 'card' },
-};
-const DECLINED: PaymentDetail = {
-  id: 'pi_twin009', amount: 15000, currency: 'usd', status: 'failed', created: AT, customer: CUSTOMER, intent: DECLINED_INTENT,
-  amountRefunded: 0, declineReason: 'Insufficient funds', declineMessage: 'Your card has insufficient funds.', refunds: [],
-  events: [event('evt_9', 'payment_intent.payment_failed', DECLINED_INTENT, AT)],
-};
-const REFUNDED: Payment = { id: 'pi_twin002', amount: 2500, currency: 'usd', status: 'refunded', description: 'Twin T-shirt', created: AT, customer: CUSTOMER, paymentMethod: CARD, amountRefunded: 2500, refundedAt: AT + 30 };
-const PAYMENTS: Payment[] = [PARTIAL, DECLINED, REFUNDED, { ...REFUNDED, id: 'pi_twin003', status: 'succeeded', amountRefunded: 0, refundedAt: undefined, description: 'Consulting' }];
-
-const PRODUCT: StripeRow = { id: 'prod_twin001', object: 'product', name: 'Pro plan' };
-const SUBSCRIPTION: StripeRow = {
-  id: 'sub_twin001', object: 'subscription', status: 'trialing', customer: 'cus_twin001', currency: 'usd', created: AT, start_date: AT,
-  current_period_start: AT, current_period_end: AT + 14 * 86400, trial_start: AT, trial_end: AT + 14 * 86400, collection_method: 'charge_automatically',
-  items: { object: 'list', data: [{ id: 'si_twin001', object: 'subscription_item', quantity: 3, price: { id: 'price_twin001', product: 'prod_twin001', unit_amount: 4900, currency: 'usd', recurring: { interval: 'month' } } }] },
-};
-const INVOICE: StripeRow = { id: 'in_twin001', object: 'invoice', number: 'TWIN-0001', status: 'paid', customer: 'cus_twin001', subscription: 'sub_twin001', currency: 'usd', total: 14700, amount_due: 14700, created: AT };
-const CUSTOMER_PAGE: CustomerDetail = { customer: CUSTOMER, paymentMethods: [CARD], subscriptions: [SUBSCRIPTION], invoices: [INVOICE], payments: PAYMENTS, products: new Map([[PRODUCT.id, PRODUCT]]), events: [] };
-const SUBSCRIPTION_PAGE: SubscriptionDetail = { subscription: SUBSCRIPTION, customer: CUSTOMER, invoices: [INVOICE], products: new Map([[PRODUCT.id, PRODUCT]]), events: [event('evt_s', 'customer.subscription.created', SUBSCRIPTION, AT)], paymentMethod: CARD };
-
-const BALANCE: StripeRow = { id: 'balance', object: 'balance', available: [{ amount: 16800, currency: 'usd' }], pending: [{ amount: 4200, currency: 'usd' }] };
-const ACCOUNT: StripeRow = {
-  id: 'acct_twin001', object: 'account', type: 'express', country: 'US', charges_enabled: false, payouts_enabled: false, details_submitted: false,
-  requirements: { currently_due: ['external_account', 'tos_acceptance.date'] },
-};
-const TAX_RATE: StripeRow = { id: 'txr_twin001', object: 'tax_rate', display_name: 'Sales Tax', percentage: 8.5, inclusive: false, active: true, jurisdiction: 'US', created: AT };
-
-const html = (el: Parameters<typeof renderToStaticMarkup>[0]) => renderToStaticMarkup(el);
-const count = (markup: string, needle: RegExp) => (markup.match(needle) ?? []).length;
-
-/** Build the structural checklist from the real rendered markup and run it. */
-export function stripeUiStructure(): UiStructureReport {
-  const nav = html(createElement(SideNav, { route: ['payments'], go: noop }));
-  const band = html(createElement(TestModeBand));
-  const payments = html(createElement(PaymentsTable, { payments: PAYMENTS, go: noop }));
-  const partial = html(createElement(PaymentDetailView, { p: PARTIAL, go: noop, onRefund: noop }));
-  const declined = html(createElement(PaymentDetailView, { p: DECLINED, go: noop, onRefund: noop }));
-  const customer = html(createElement(CustomerDetailView, { data: CUSTOMER_PAGE, go: noop }));
-  const subscription = html(createElement(SubscriptionDetailView, { data: SUBSCRIPTION_PAGE, go: noop, onCancel: noop }));
-  const balance = html(createElement(BalanceSummary, { row: BALANCE }));
-  const account = html(createElement(ConnectAccountPanel, { row: ACCOUNT }));
-  const taxRates = html(createElement(ListPane, { section: SECTIONS.find((s) => s.key === 'tax_rates')!, rows: [TAX_RATE], onSelect: noop }));
-
-  const checks = [
-    {
-      key: 'navigation',
-      label: "Left navigation: Home, Balances, Transactions, Customers, Product catalog, Billing's Subscriptions and Invoices, Developers — at Stripe's /test/ paths",
-      present: ['>Home<', '>Balances<', '>Transactions<', '>Customers<', '>Product catalog<', '>Subscriptions<', '>Invoices<', '>Developers<'].every((l) => nav.includes(l))
-        && nav.includes('href="/test/payments"') && nav.includes('href="/test/customers"') && nav.includes('href="/test/subscriptions"'),
-    },
-    {
-      key: 'navActive',
-      label: 'The navigation marks the section being viewed',
-      present: /class="nav-item [^"]*active"[^>]*href="\/test\/payments"|href="\/test\/payments" class="nav-item [^"]*active"/.test(nav),
-    },
-    {
-      key: 'testModeBand',
-      label: "The orange test-mode band across the top",
-      present: band.includes('class="test-band"') && band.includes('Test mode'),
-    },
-    {
-      key: 'paymentsColumns',
-      label: "Payments table carries Stripe's columns (Amount, Payment method, Description, Customer, Date, Refunded date, Decline reason)",
-      present: ['>Amount<', '>Payment method<', '>Description<', '>Customer<', '>Date<', '>Refunded date<', '>Decline reason<'].every((c) => payments.includes(c)),
-    },
-    {
-      key: 'paymentsRowPerPayment',
-      label: 'Payments table emits one row per payment, amount with its currency',
-      present: count(payments, /class="list-row"/g) === PAYMENTS.length && payments.includes('$300.00') && payments.includes('USD'),
-    },
-    {
-      key: 'paymentsStatusPills',
-      label: 'Status pills worded as Stripe words them (Succeeded, Refunded, Partial refund, Failed)',
-      present: ['>Succeeded<', '>Refunded<', '>Partial refund<', '>Failed<'].every((l) => payments.includes(l)),
-    },
-    {
-      key: 'paymentsDeclineReason',
-      label: 'A failed payment shows its decline reason in the list',
-      present: payments.includes('Insufficient funds'),
-    },
-    {
-      key: 'paymentHeader',
-      label: "A payment's page leads with its amount, currency and status, and a Refund control while refundable",
-      present: partial.includes('$300.00') && partial.includes('Partial refund') && partial.includes('Refund</button>'),
-    },
-    {
-      key: 'paymentTimeline',
-      label: "A payment's timeline lists its events (started, succeeded, refunded)",
-      present: partial.includes('class="timeline"') && partial.includes('Payment started') && partial.includes('Payment succeeded') && partial.includes('refunded'),
-    },
-    {
-      key: 'paymentBreakdownAndRefunds',
-      label: "A payment's breakdown (amount, refunded, net) and its refunds",
-      present: partial.includes('Payment breakdown') && partial.includes('$200.00') && partial.includes('>Refunds<') && partial.includes('re_twin001'),
-    },
-    {
-      key: 'paymentMethodBlock',
-      label: "A payment's card: number's last four, expiry, type, CVC check",
-      present: partial.includes('4242') && partial.includes('12 / 2034') && partial.includes('Visa credit card') && partial.includes('Passed'),
-    },
-    {
-      key: 'paymentDecline',
-      label: 'A declined payment states its error and decline code, and offers no refund',
-      present: declined.includes('class="pay-error"') && declined.includes('Your card has insufficient funds.') && declined.includes('insufficient_funds') && !declined.includes('Refund</button>'),
-    },
-    {
-      key: 'customerPage',
-      label: "A customer's page: name, email, Details, Subscriptions, Payments, Payment methods, Invoices",
-      present: customer.includes('Ada Lovelace') && customer.includes('ada@example.com')
-        && ['>Details<', '>Subscriptions<', '>Payments<', '>Payment methods<', '>Invoices<'].every((h) => customer.includes(h))
-        && customer.includes('Pro plan') && customer.includes('TWIN-0001') && customer.includes('>Default<'),
-    },
-    {
-      key: 'subscriptionPage',
-      label: "A subscription's page: customer on product, status, period, pricing items, invoices and Cancel subscription",
-      present: subscription.includes('Ada Lovelace') && subscription.includes('Pro plan') && subscription.includes('>Trialing<')
-        && subscription.includes('Current period') && subscription.includes('>Pricing<') && subscription.includes('$147.00')
-        && subscription.includes('TWIN-0001') && subscription.includes('Cancel subscription'),
-    },
-    {
-      key: 'balanceSummaryBuckets',
-      label: 'The balance renders its incoming and available buckets, amounts formatted',
-      present: balance.includes('class="balance-summary"') && balance.includes('Incoming') && balance.includes('Available') && balance.includes('$168.00') && balance.includes('$42.00'),
-    },
-    {
-      key: 'connectAccountReadiness',
-      label: "A connected account's charges/payouts/details flags and what is currently due",
-      present: account.includes('class="connect-panel"') && count(account, /connect-flag /g) >= 3 && account.includes('Requirements currently due') && account.includes('external_account'),
-    },
-    {
-      key: 'resourceListRow',
-      label: 'A resource list emits one row per object (Tax rates: name and percentage)',
-      present: count(taxRates, /list-row/g) === 1 && taxRates.includes('Sales Tax') && taxRates.includes('8.5'),
-    },
-  ];
-
-  return checkUiStructure('stripe', checks);
-}