Skip to content

docs(Timeline): canonical despachos pattern stories — #9 detail + #10 list card#44

Merged
Misael703 merged 1 commit into
mainfrom
docs/timeline-despachos-canonical-stories
May 29, 2026
Merged

docs(Timeline): canonical despachos pattern stories — #9 detail + #10 list card#44
Misael703 merged 1 commit into
mainfrom
docs/timeline-despachos-canonical-stories

Conversation

@Misael703
Copy link
Copy Markdown
Owner

Two new Storybook stories

Documenting the recommended order-timeline pattern for despachos (from the recommendation conversation). Story-only — no kit code change, no API change, no npm release.

#9 Despachos · patrón canónico (detalle de orden)

The canonical pattern for /dispatch-orders/[id]. Combines the 4 layers the kit ships:

  • Anchors fijos via variant="milestone" top + bottom (Orden creada always done, Orden completada morphs pending → done).
  • Eventos operativos with state (done/current/pending) + tone.
  • Tipo de evento via right={<Badge>…</Badge>} (envío / retiro / nota).
  • Payload estructurado in children for items that carry detail (guía, tracking).

Scales 1..N dispatches without code changes — the formula is the same whether N=1 or N=10.

#10 Despachos · card de lista (compact)

Same pattern at density="compact" for the list page (/dispatch-orders). Three cards demonstrate the scaling:

  1. Recién creada (N=0) — only anchors. "Started, nothing happened yet."
  2. En curso (N=3, multi-state) — the typical mid-flight case.
  3. Entregada (N=1, happy path) — 3 done markers in a line + both anchors done = closed story.

Gate

tsc 0 · eslint 0 · vitest 510/510 · build 0. No smoke needed (stories only).

No release

Stories live in src/components/*.stories.tsx, NOT in the published dist/. Consumers see the new stories in Storybook (after merge); the npm package stays at 1.30.4. The flow is just push → PR → merge.

…list card

Two new Storybook stories documenting the recommended pattern for an order
detail timeline + the compact list card variant. Story-only — no kit code
change, no version bump, no npm release.

#9 Despachos · patrón canónico (detalle de orden) — combines the 4 layers
the kit offers: milestone anchors top/bottom (Orden creada done, Orden
completada pending/done), default operational items with state/tone, right
Badge slot for event type (envío/retiro/nota), children payload for items
that carry a guía/tracking detail card. The formula scales 1..N dispatches
without code changes.

#10 Despachos · card de lista (compact) — same pattern at `density="compact"`
for the orders list page. Three cards demonstrate the scaling: N=0 (just
created), N=3 multi-state in-progress, N=1 ideal happy path delivered.
@Misael703 Misael703 merged commit 21baffa into main May 29, 2026
1 check passed
@Misael703 Misael703 deleted the docs/timeline-despachos-canonical-stories branch May 29, 2026 18:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant