temetro/.agents/skills/coss/references/primitives/breadcrumb.md at 2c239fbd2777cd1344c4e75fff5a3cb36867d00a

mirror of https://github.com/temetro/temetro.git synced 2026-08-31 12:58:08 +00:00

Files

T

Khalid Abdi 929bec8f31 feat: AI-added records save with placeholders + "Added by AI" provenance

Stop blocking AI imports/proposals on missing non-critical fields. Records
the chat agent drafts now save with safe placeholders, auto-generated file
numbers, and a source="ai" marker that surfaces an "Added by AI" badge so a
clinician can review/edit them later.

Backend:
- add `source` (manual|ai) column to patients/appointments/prescriptions
  (migration 0014) + canonical types, services, validation schemas
- relax patient/appointment validation: empty file number allowed, demographic
  + type/provider/initials fall back to placeholders (initials derived from name)
- patients.generateFileNumber() auto-assigns an MRN when one is missing
- proposeAppointment accepts a name when no file number resolves; AI commits +
  /api/ai/import stamp source="ai"

Frontend:
- `source` on Appointment/Patient/Prescription types; AI commits send source="ai"
- reusable <AiBadge> shown on the Patients table/detail and prescriptions list

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-14 19:27:17 +03:00

1.8 KiB

Raw Blame History

When to use

Hierarchy/location indicators for current page context.
Compact navigation trails for nested routes and detail pages.

Install

npx shadcn@latest add @coss/breadcrumb

Manual deps from docs:

# No extra runtime dependency required for this primitive.

Canonical imports

import {
  Breadcrumb,
  BreadcrumbEllipsis,
  BreadcrumbItem,
  BreadcrumbLink,
  BreadcrumbList,
  BreadcrumbPage,
  BreadcrumbSeparator,
} from "@/components/ui/breadcrumb"

Minimal pattern

<Breadcrumb>
  <BreadcrumbList>
    <BreadcrumbItem>
      <BreadcrumbLink href="/">Home</BreadcrumbLink>
    </BreadcrumbItem>
    <BreadcrumbSeparator />
    <BreadcrumbItem>
      <BreadcrumbEllipsis />
    </BreadcrumbItem>
    <BreadcrumbItem>
      <BreadcrumbLink href="/components">Components</BreadcrumbLink>
    </BreadcrumbItem>
    <BreadcrumbSeparator />
    <BreadcrumbItem>
      <BreadcrumbPage>Breadcrumb</BreadcrumbPage>
    </BreadcrumbItem>
  </BreadcrumbList>
</Breadcrumb>

Patterns from coss particles

Key patterns

Icon-only home link (requires aria-label):

<BreadcrumbItem>
  <BreadcrumbLink aria-label="Home" href="/">
    <HomeIcon aria-hidden="true" className="size-4" />
  </BreadcrumbLink>
</BreadcrumbItem>

Custom separator:

<BreadcrumbSeparator>
  <SlashIcon className="size-3.5" />
</BreadcrumbSeparator>

More examples

See p-breadcrumb-1 and p-breadcrumb-2 for default and custom separator patterns.

Common pitfalls

Using breadcrumb as primary nav menu instead of contextual trail.
Omitting aria-label on icon-only breadcrumb items.
Adding deep breadcrumb chains without meaningful hierarchy.

Useful particle references

with custom separator: p-breadcrumb-2

1.8 KiB Raw Blame History

coss Breadcrumb