@f-ewald/components 0.7.0 → 1.0.2

package/dist/utils/calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.js","sourceRoot":"","sources":["../../src/utils/calendar.ts"],"names":[],"mappings":"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","sourcesContent":["import type { StatusPillColor } from \"../status-pill.js\";\nimport type { CalendarEntry } from \"../calendar-entry.js\";\n\n/** Plain data extracted from a `calendar-entry` element's properties. */\nexport interface CalendarEntryData {\n  start: string;\n  end: string;\n  label: string;\n  details?: string[];\n  footer?: string;\n  color: StatusPillColor;\n  href?: string;\n}\n\n/** A `CalendarEntryData` with its date strings resolved to local `Date`s. */\nexport interface ResolvedCalendarEntry extends CalendarEntryData {\n  startDate: Date;\n  endDate: Date;\n}\n\n/** A `ResolvedCalendarEntry` assigned a stacking column by `assignLanes`. */\nexport interface LanedEntry extends ResolvedCalendarEntry {\n  lane: number;\n}\n\nconst ISO_DATE_PATTERN = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\n\n/** Attributes whose mutations can change a rendered calendar entry. */\nexport const CALENDAR_ENTRY_ATTRIBUTES = [\"start\", \"end\", \"label\", \"color\", \"href\", \"slot\"];\n\n/** Number of days in `month` (1-12) of `year`, leap years included. */\nexport function daysInMonth(year: number, month: number): number {\n  return new Date(year, month, 0).getDate();\n}\n\n/**\n * Parses `\"YYYY-MM-DD\"` as a local-midnight `Date`. Returns `null` for\n * anything that doesn't match or doesn't round-trip (e.g. \"2026-02-30\") —\n * deliberately never uses `new Date(iso)`/`.toISOString()`, both of which\n * are UTC-based and would silently shift the date in negative-UTC-offset\n * timezones.\n */\nexport function parseIsoDate(iso: string): Date | null {\n  const match = ISO_DATE_PATTERN.exec(iso);\n  if (!match) return null;\n\n  const year = Number(match[1]);\n  const month = Number(match[2]);\n  const day = Number(match[3]);\n  const date = new Date(year, month - 1, day);\n  if (date.getFullYear() !== year || date.getMonth() !== month - 1 || date.getDate() !== day) {\n    return null;\n  }\n  return date;\n}\n\n/** Formats a `Date`'s local year/month/day as `\"YYYY-MM-DD\"`. */\nexport function toIsoDate(date: Date): string {\n  const year = String(date.getFullYear()).padStart(4, \"0\");\n  const month = String(date.getMonth() + 1).padStart(2, \"0\");\n  const day = String(date.getDate()).padStart(2, \"0\");\n  return `${year}-${month}-${day}`;\n}\n\nconst monthNameFormatter = new Intl.DateTimeFormat(undefined, { month: \"long\" });\n\n/** Locale-aware full month name for `month` (1-12). */\nexport function monthName(month: number): string {\n  return monthNameFormatter.format(new Date(2000, month - 1, 1));\n}\n\n/** Sunday-first weekday abbreviations, indexed by `Date.getDay()` (0 = Sunday). */\nexport const WEEKDAY_ABBR: readonly string[] = [\"Sun\", \"Mon\", \"Tue\", \"Wed\", \"Thu\", \"Fri\", \"Sat\"];\n\n/**\n * Whether `date` falls on a Saturday or Sunday, per JS's `Date.getDay()`\n * convention (Sunday = 0 .. Saturday = 6) — note this differs from Python's\n * `calendar` module (Monday = 0), which the original reference\n * implementation this component's layout is based on used.\n */\nexport function isWeekend(date: Date): boolean {\n  const day = date.getDay();\n  return day === 0 || day === 6;\n}\n\n/** Reads normalized plain-text content from direct children assigned to a named slot. */\nfunction slottedText(el: CalendarEntry, slotName: string): string[] {\n  return Array.from(el.querySelectorAll<HTMLElement>(`:scope > [slot=\"${slotName}\"]`))\n    .map((node) => (node.textContent ?? \"\").replace(/\\s+/g, \" \").trim());\n}\n\n/** Reads a `calendar-entry` element's properties and named text slots into plain data. */\nexport function readCalendarEntryElement(el: CalendarEntry): CalendarEntryData {\n  const title = slottedText(el, \"title\").find((line) => line.length > 0);\n  const footer = slottedText(el, \"footer\").find((line) => line.length > 0);\n  return {\n    start: el.start,\n    end: el.end,\n    label: title ?? el.label,\n    details: slottedText(el, \"detail\"),\n    footer,\n    color: el.color,\n    href: el.href,\n  };\n}\n\n/**\n * Resolves a `CalendarEntryData`'s date strings to `Date`s. Returns `null`\n * when `start` is missing or unparseable — such entries are dropped\n * silently rather than thrown, since this reads declarative markup a\n * consumer authored, not validated user input. A blank `end` defaults to\n * `start` (single-day entry); an `end` before `start` is clamped up to\n * `start` rather than treated as an error.\n */\nexport function resolveEntry(data: CalendarEntryData): ResolvedCalendarEntry | null {\n  const startDate = parseIsoDate(data.start);\n  if (!startDate) return null;\n\n  const endDate = parseIsoDate(data.end) ?? startDate;\n  return {\n    ...data,\n    details: data.details ?? [],\n    startDate,\n    endDate: endDate < startDate ? startDate : endDate,\n  };\n}\n\n/** Whether `entry`'s inclusive date range intersects the inclusive `[rangeStart, rangeEnd]` range. */\nexport function overlapsRange(entry: ResolvedCalendarEntry, rangeStart: Date, rangeEnd: Date): boolean {\n  return entry.startDate <= rangeEnd && entry.endDate >= rangeStart;\n}\n\n/**\n * Assigns each entry a 0-based stacking lane via greedy interval\n * partitioning (\"meeting rooms II\"): entries are sorted by start date, then\n * each is placed in the lowest-numbered lane whose current occupant ends\n * strictly before the entry starts. Because entry ranges are\n * inclusive-inclusive, an entry ending on day X and one starting on day X\n * both occupy day X and must not share a lane — hence the strict `<`.\n *\n * Lane assignment is meant to be computed independently per `calendar-month`\n * (from only the entries overlapping that month); an entry spanning a month\n * boundary may therefore land in a different lane in adjacent months. This\n * is an accepted v1 limitation, not a bug.\n */\nexport function assignLanes(entries: ResolvedCalendarEntry[]): {\n  entries: LanedEntry[];\n  laneCount: number;\n} {\n  const sorted = entries\n    .map((entry, index) => ({ entry, index }))\n    .sort((a, b) => {\n      const startDiff = a.entry.startDate.getTime() - b.entry.startDate.getTime();\n      if (startDiff !== 0) return startDiff;\n      const endDiff = a.entry.endDate.getTime() - b.entry.endDate.getTime();\n      if (endDiff !== 0) return endDiff;\n      return a.index - b.index;\n    });\n\n  const laneEnds: Date[] = [];\n  const laned: LanedEntry[] = [];\n  for (const { entry } of sorted) {\n    let lane = laneEnds.findIndex((end) => end < entry.startDate);\n    if (lane === -1) {\n      lane = laneEnds.length;\n      laneEnds.push(entry.endDate);\n    } else {\n      laneEnds[lane] = entry.endDate;\n    }\n    laned.push({ ...entry, lane });\n  }\n\n  return { entries: laned, laneCount: laneEnds.length };\n}\n"]}

package/dist/utils/form.d.ts

@@ -0,0 +1,3 @@
+/** Submits a form through its default enabled native submit control when present. */
+export declare function submitWithDefaultButton(form: HTMLFormElement): void;
+//# sourceMappingURL=form.d.ts.map

package/dist/utils/form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/utils/form.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAWnE"}

package/dist/utils/form.js

@@ -0,0 +1,14 @@
+/** Submits a form through its default enabled native submit control when present. */
+export function submitWithDefaultButton(form) {
+    const submitter = Array.from(form.elements).find((element) => (element instanceof HTMLButtonElement ||
+        element instanceof HTMLInputElement) &&
+        (element.type === "submit" ||
+            (element instanceof HTMLInputElement && element.type === "image")));
+    if (submitter?.matches(":disabled"))
+        return;
+    if (submitter)
+        submitter.click();
+    else
+        form.requestSubmit();
+}
+//# sourceMappingURL=form.js.map

package/dist/utils/form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.js","sourceRoot":"","sources":["../../src/utils/form.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,UAAU,uBAAuB,CAAC,IAAqB;IAC3D,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAC9C,CAAC,OAAO,EAAmD,EAAE,CAC3D,CAAC,OAAO,YAAY,iBAAiB;QACnC,OAAO,YAAY,gBAAgB,CAAC;QACtC,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ;YACxB,CAAC,OAAO,YAAY,gBAAgB,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CACvE,CAAC;IACF,IAAI,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC;QAAE,OAAO;IAC5C,IAAI,SAAS;QAAE,SAAS,CAAC,KAAK,EAAE,CAAC;;QAC5B,IAAI,CAAC,aAAa,EAAE,CAAC;AAC5B,CAAC","sourcesContent":["/** Submits a form through its default enabled native submit control when present. */\nexport function submitWithDefaultButton(form: HTMLFormElement): void {\n  const submitter = Array.from(form.elements).find(\n    (element): element is HTMLButtonElement | HTMLInputElement =>\n      (element instanceof HTMLButtonElement ||\n        element instanceof HTMLInputElement) &&\n      (element.type === \"submit\" ||\n        (element instanceof HTMLInputElement && element.type === \"image\")),\n  );\n  if (submitter?.matches(\":disabled\")) return;\n  if (submitter) submitter.click();\n  else form.requestSubmit();\n}\n"]}

package/dist/utils/layer-stack.d.ts

@@ -0,0 +1,9 @@
+/** Registers an open overlay as the current topmost interactive layer. */
+export declare function activateLayer(layer: HTMLElement): void;
+/** Removes a closed or disconnected overlay from the layer stack. */
+export declare function deactivateLayer(layer: HTMLElement): void;
+/** Whether this overlay currently owns global Escape/focus behavior. */
+export declare function isTopLayer(layer: HTMLElement): boolean;
+/** Claims Escape for the topmost layer and marks it handled for other listeners. */
+export declare function claimEscape(layer: HTMLElement, event: KeyboardEvent): boolean;
+//# sourceMappingURL=layer-stack.d.ts.map

package/dist/utils/layer-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer-stack.d.ts","sourceRoot":"","sources":["../../src/utils/layer-stack.ts"],"names":[],"mappings":"AAUA,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAItD;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAKxD;AAED,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAEtD;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAM7E"}

package/dist/utils/layer-stack.js

@@ -0,0 +1,35 @@
+const layers = [];
+const baseZIndex = 100;
+/** Keeps visual z-order synchronized with interaction-stack order. */
+function syncLayerOrder() {
+    layers.forEach((layer, index) => {
+        layer.style.setProperty("--component-layer-z", String(baseZIndex + index));
+    });
+}
+/** Registers an open overlay as the current topmost interactive layer. */
+export function activateLayer(layer) {
+    deactivateLayer(layer);
+    layers.push(layer);
+    syncLayerOrder();
+}
+/** Removes a closed or disconnected overlay from the layer stack. */
+export function deactivateLayer(layer) {
+    const index = layers.indexOf(layer);
+    if (index >= 0)
+        layers.splice(index, 1);
+    layer.style.removeProperty("--component-layer-z");
+    syncLayerOrder();
+}
+/** Whether this overlay currently owns global Escape/focus behavior. */
+export function isTopLayer(layer) {
+    return layers.at(-1) === layer;
+}
+/** Claims Escape for the topmost layer and marks it handled for other listeners. */
+export function claimEscape(layer, event) {
+    if (event.key !== "Escape" || event.defaultPrevented || !isTopLayer(layer)) {
+        return false;
+    }
+    event.preventDefault();
+    return true;
+}
+//# sourceMappingURL=layer-stack.js.map

package/dist/utils/layer-stack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer-stack.js","sourceRoot":"","sources":["../../src/utils/layer-stack.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAkB,EAAE,CAAC;AACjC,MAAM,UAAU,GAAG,GAAG,CAAC;AAEvB,sEAAsE;AACtE,SAAS,cAAc;IACrB,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9B,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,qBAAqB,EAAE,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,eAAe,CAAC,KAAK,CAAC,CAAC;IACvB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnB,cAAc,EAAE,CAAC;AACnB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,KAAkB;IAChD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,KAAK,IAAI,CAAC;QAAE,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACxC,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;IAClD,cAAc,EAAE,CAAC;AACnB,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,UAAU,CAAC,KAAkB;IAC3C,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC;AACjC,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,WAAW,CAAC,KAAkB,EAAE,KAAoB;IAClE,IAAI,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,gBAAgB,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,KAAK,CAAC,cAAc,EAAE,CAAC;IACvB,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["const layers: HTMLElement[] = [];\nconst baseZIndex = 100;\n\n/** Keeps visual z-order synchronized with interaction-stack order. */\nfunction syncLayerOrder(): void {\n  layers.forEach((layer, index) => {\n    layer.style.setProperty(\"--component-layer-z\", String(baseZIndex + index));\n  });\n}\n\n/** Registers an open overlay as the current topmost interactive layer. */\nexport function activateLayer(layer: HTMLElement): void {\n  deactivateLayer(layer);\n  layers.push(layer);\n  syncLayerOrder();\n}\n\n/** Removes a closed or disconnected overlay from the layer stack. */\nexport function deactivateLayer(layer: HTMLElement): void {\n  const index = layers.indexOf(layer);\n  if (index >= 0) layers.splice(index, 1);\n  layer.style.removeProperty(\"--component-layer-z\");\n  syncLayerOrder();\n}\n\n/** Whether this overlay currently owns global Escape/focus behavior. */\nexport function isTopLayer(layer: HTMLElement): boolean {\n  return layers.at(-1) === layer;\n}\n\n/** Claims Escape for the topmost layer and marks it handled for other listeners. */\nexport function claimEscape(layer: HTMLElement, event: KeyboardEvent): boolean {\n  if (event.key !== \"Escape\" || event.defaultPrevented || !isTopLayer(layer)) {\n    return false;\n  }\n  event.preventDefault();\n  return true;\n}\n"]}

package/dist/weight-bar-chart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"weight-bar-chart.d.ts","sourceRoot":"","sources":["../src/weight-bar-chart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAa,MAAM,KAAK,CAAC;AAK5C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,qBACa,cAAe,SAAQ,UAAU;IAC5C,oEAAoE;IACpC,KAAK,EAAE,aAAa,EAAE,CAAM;IAE5D,OAAgB,MAAM,4BAuCpB;IAEO,MAAM,gDAuBd;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,kBAAkB,EAAE,cAAc,CAAC;KACpC;CACF"}
+{"version":3,"file":"weight-bar-chart.d.ts","sourceRoot":"","sources":["../src/weight-bar-chart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAa,MAAM,KAAK,CAAC;AAK5C,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;GASG;AACH,qBACa,cAAe,SAAQ,UAAU;IAC5C,oEAAoE;IACpC,KAAK,EAAE,aAAa,EAAE,CAAM;IAE5D,OAAgB,MAAM,4BA0DpB;IAEO,MAAM,gDAuBd;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,kBAAkB,EAAE,cAAc,CAAC;KACpC;CACF"}

package/dist/weight-bar-chart.js

@@ -33,35 +33,54 @@ let WeightBarChart = class WeightBarChart extends LitElement {
       .row {
         display: flex;
         align-items: center;
-        gap: 8px;
-        margin: 6px 0;
+        gap: 0.5rem;
+        margin: 0.5rem 0;
       }
       .label {
-        flex: 0 0 90px;
+        flex: 0 0 5.5rem;
         font-size: var(--ui-font-size-sm, 0.75rem);
-        font-family: var(--ui-font, ui-sans-serif, system-ui, sans-serif);
+        font-family: var(
+          --ui-font,
+          ui-sans-serif,
+          system-ui,
+          sans-serif,
+          "Apple Color Emoji",
+          "Segoe UI Emoji",
+          "Segoe UI Symbol",
+          "Noto Color Emoji"
+        );
         color: var(--ui-text, #0f172a);
       }
       .track {
         flex: 1 1 auto;
-        height: 12px;
+        height: 0.75rem;
         background: var(--ui-surface-muted, #f8fafc);
         border-radius: var(--ui-radius-sm, 0.25rem);
         overflow: hidden;
       }
       .bar {
         height: 100%;
-        background: var(--ui-primary, #4f46e5);
+        /* Match map-circle's 30% white/black vertical depth while preserving token overrides. */
+        background: linear-gradient(
+          to bottom,
+          color-mix(in srgb, var(--ui-primary, #4f46e5) 70%, #ffffff) 0%,
+          color-mix(in srgb, var(--ui-primary, #4f46e5) 70%, #000000) 100%
+        );
         border-radius: 0 var(--ui-radius-sm, 0.25rem) var(--ui-radius-sm, 0.25rem) 0;
-        transition: width 0.15s ease-out;
+        transition: width 150ms ease-out;
       }
       .pct {
-        flex: 0 0 40px;
+        flex: 0 0 2.5rem;
         text-align: right;
         font-size: var(--ui-font-size-sm, 0.75rem);
         font-variant-numeric: tabular-nums;
         color: var(--ui-text-muted, #64748b);
       }
+      @media (prefers-reduced-motion: reduce) {
+        .bar {
+          transition: none;
+        }
+      }
     `,
     ]; }
     render() {

package/dist/weight-bar-chart.js.map

@@ -1 +1 @@
-{"version":3,"file":"weight-bar-chart.js","sourceRoot":"","sources":["../src/weight-bar-chart.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AASrC;;;;;;;;;GASG;AAEI,IAAM,cAAc,GAApB,MAAM,cAAe,SAAQ,UAAU;IAAvC;;QACL,oEAAoE;QACpC,UAAK,GAAoB,EAAE,CAAC;IAmE9D,CAAC;aAjEiB,WAAM,GAAG;QACvB,MAAM;QACN,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAoCF;KACF,AAvCqB,CAuCpB;IAEO,MAAM;QACb,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,+EAA+E;QAC/E,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClG,OAAO,IAAI,CAAA;6CAC8B,OAAO;UAC1C,MAAM,CACN,MAAM,EACN,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EACjB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAA;;oCAEY,IAAI,CAAC,KAAK;;iDAEG,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG;;kCAEvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC;;WAEnD,CACF;;KAEJ,CAAC;IACJ,CAAC;CACF,CAAA;AAnEiC;IAA/B,QAAQ,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;6CAA6B;AAFjD,cAAc;IAD1B,aAAa,CAAC,kBAAkB,CAAC;GACrB,cAAc,CAqE1B","sourcesContent":["import { LitElement, css, html } from \"lit\";\nimport { customElement, property } from \"lit/decorators.js\";\nimport { repeat } from \"lit/directives/repeat.js\";\nimport { tokens } from \"./tokens.js\";\n\nexport interface WeightBarItem {\n  id: string;\n  label: string;\n  /** Normalized fraction (fractions across all items sum to ~1). */\n  value: number;\n}\n\n/**\n * Sorted horizontal bar chart of labeled weights (normalized fractions\n * summing to ~1). Bars sort descending — the order IS the priority ranking.\n * Widths scale relative to the largest weight (which fills its track); the\n * percent labels carry the absolute values. Rows are keyed by item id\n * (repeat directive) so a re-render with new weights moves the existing\n * rows; bar widths animate via CSS, re-sorting is instant.\n *\n * @element weight-bar-chart\n */\n@customElement(\"weight-bar-chart\")\nexport class WeightBarChart extends LitElement {\n  /** Items to render as weighted rows, sorted descending by value. */\n  @property({ attribute: false }) items: WeightBarItem[] = [];\n\n  static override styles = [\n    tokens,\n    css`\n      :host {\n        display: block;\n      }\n      .row {\n        display: flex;\n        align-items: center;\n        gap: 8px;\n        margin: 6px 0;\n      }\n      .label {\n        flex: 0 0 90px;\n        font-size: var(--ui-font-size-sm, 0.75rem);\n        font-family: var(--ui-font, ui-sans-serif, system-ui, sans-serif);\n        color: var(--ui-text, #0f172a);\n      }\n      .track {\n        flex: 1 1 auto;\n        height: 12px;\n        background: var(--ui-surface-muted, #f8fafc);\n        border-radius: var(--ui-radius-sm, 0.25rem);\n        overflow: hidden;\n      }\n      .bar {\n        height: 100%;\n        background: var(--ui-primary, #4f46e5);\n        border-radius: 0 var(--ui-radius-sm, 0.25rem) var(--ui-radius-sm, 0.25rem) 0;\n        transition: width 0.15s ease-out;\n      }\n      .pct {\n        flex: 0 0 40px;\n        text-align: right;\n        font-size: var(--ui-font-size-sm, 0.75rem);\n        font-variant-numeric: tabular-nums;\n        color: var(--ui-text-muted, #64748b);\n      }\n    `,\n  ];\n\n  override render() {\n    if (this.items.length === 0) return null;\n    // Stable sort: ties keep the incoming item order, so the chart never flickers.\n    const sorted = [...this.items].sort((a, b) => b.value - a.value);\n    const max = Math.max(0.01, ...sorted.map((item) => item.value));\n    const summary = sorted.map((item) => `${item.label} ${Math.round(item.value * 100)}%`).join(\", \");\n    return html`\n      <div role=\"img\" aria-label=\"Weights: ${summary}\">\n        ${repeat(\n          sorted,\n          (item) => item.id,\n          (item) => html`\n            <div class=\"row\">\n              <span class=\"label\">${item.label}</span>\n              <div class=\"track\">\n                <div class=\"bar\" style=\"width: ${(item.value / max) * 100}%\"></div>\n              </div>\n              <span class=\"pct\">${Math.round(item.value * 100)}%</span>\n            </div>\n          `,\n        )}\n      </div>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    \"weight-bar-chart\": WeightBarChart;\n  }\n}\n"]}
+{"version":3,"file":"weight-bar-chart.js","sourceRoot":"","sources":["../src/weight-bar-chart.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AASrC;;;;;;;;;GASG;AAEI,IAAM,cAAc,GAApB,MAAM,cAAe,SAAQ,UAAU;IAAvC;;QACL,oEAAoE;QACpC,UAAK,GAAoB,EAAE,CAAC;IAsF9D,CAAC;aApFiB,WAAM,GAAG;QACvB,MAAM;QACN,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAuDF;KACF,AA1DqB,CA0DpB;IAEO,MAAM;QACb,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,+EAA+E;QAC/E,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClG,OAAO,IAAI,CAAA;6CAC8B,OAAO;UAC1C,MAAM,CACN,MAAM,EACN,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EACjB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAA;;oCAEY,IAAI,CAAC,KAAK;;iDAEG,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG;;kCAEvC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC;;WAEnD,CACF;;KAEJ,CAAC;IACJ,CAAC;CACF,CAAA;AAtFiC;IAA/B,QAAQ,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;6CAA6B;AAFjD,cAAc;IAD1B,aAAa,CAAC,kBAAkB,CAAC;GACrB,cAAc,CAwF1B","sourcesContent":["import { LitElement, css, html } from \"lit\";\nimport { customElement, property } from \"lit/decorators.js\";\nimport { repeat } from \"lit/directives/repeat.js\";\nimport { tokens } from \"./tokens.js\";\n\nexport interface WeightBarItem {\n  id: string;\n  label: string;\n  /** Normalized fraction (fractions across all items sum to ~1). */\n  value: number;\n}\n\n/**\n * Sorted horizontal bar chart of labeled weights (normalized fractions\n * summing to ~1). Bars sort descending — the order IS the priority ranking.\n * Widths scale relative to the largest weight (which fills its track); the\n * percent labels carry the absolute values. Rows are keyed by item id\n * (repeat directive) so a re-render with new weights moves the existing\n * rows; bar widths animate via CSS, re-sorting is instant.\n *\n * @element weight-bar-chart\n */\n@customElement(\"weight-bar-chart\")\nexport class WeightBarChart extends LitElement {\n  /** Items to render as weighted rows, sorted descending by value. */\n  @property({ attribute: false }) items: WeightBarItem[] = [];\n\n  static override styles = [\n    tokens,\n    css`\n      :host {\n        display: block;\n      }\n      .row {\n        display: flex;\n        align-items: center;\n        gap: 0.5rem;\n        margin: 0.5rem 0;\n      }\n      .label {\n        flex: 0 0 5.5rem;\n        font-size: var(--ui-font-size-sm, 0.75rem);\n        font-family: var(\n          --ui-font,\n          ui-sans-serif,\n          system-ui,\n          sans-serif,\n          \"Apple Color Emoji\",\n          \"Segoe UI Emoji\",\n          \"Segoe UI Symbol\",\n          \"Noto Color Emoji\"\n        );\n        color: var(--ui-text, #0f172a);\n      }\n      .track {\n        flex: 1 1 auto;\n        height: 0.75rem;\n        background: var(--ui-surface-muted, #f8fafc);\n        border-radius: var(--ui-radius-sm, 0.25rem);\n        overflow: hidden;\n      }\n      .bar {\n        height: 100%;\n        /* Match map-circle's 30% white/black vertical depth while preserving token overrides. */\n        background: linear-gradient(\n          to bottom,\n          color-mix(in srgb, var(--ui-primary, #4f46e5) 70%, #ffffff) 0%,\n          color-mix(in srgb, var(--ui-primary, #4f46e5) 70%, #000000) 100%\n        );\n        border-radius: 0 var(--ui-radius-sm, 0.25rem) var(--ui-radius-sm, 0.25rem) 0;\n        transition: width 150ms ease-out;\n      }\n      .pct {\n        flex: 0 0 2.5rem;\n        text-align: right;\n        font-size: var(--ui-font-size-sm, 0.75rem);\n        font-variant-numeric: tabular-nums;\n        color: var(--ui-text-muted, #64748b);\n      }\n      @media (prefers-reduced-motion: reduce) {\n        .bar {\n          transition: none;\n        }\n      }\n    `,\n  ];\n\n  override render() {\n    if (this.items.length === 0) return null;\n    // Stable sort: ties keep the incoming item order, so the chart never flickers.\n    const sorted = [...this.items].sort((a, b) => b.value - a.value);\n    const max = Math.max(0.01, ...sorted.map((item) => item.value));\n    const summary = sorted.map((item) => `${item.label} ${Math.round(item.value * 100)}%`).join(\", \");\n    return html`\n      <div role=\"img\" aria-label=\"Weights: ${summary}\">\n        ${repeat(\n          sorted,\n          (item) => item.id,\n          (item) => html`\n            <div class=\"row\">\n              <span class=\"label\">${item.label}</span>\n              <div class=\"track\">\n                <div class=\"bar\" style=\"width: ${(item.value / max) * 100}%\"></div>\n              </div>\n              <span class=\"pct\">${Math.round(item.value * 100)}%</span>\n            </div>\n          `,\n        )}\n      </div>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    \"weight-bar-chart\": WeightBarChart;\n  }\n}\n"]}

package/docs/address-autocomplete.md

@@ -35,6 +35,7 @@ import "@f-ewald/components/address-autocomplete.js";
 | `value` | `value` | `string` | `""` | Current input value; also the form-associated value submitted with the form. |
 | `placeholder` | `placeholder` | `string` | `""` | Placeholder text shown when the input is empty. |
 | `required` | `required` | `boolean` | `false` | Marks the input as required for native form validation. |
+| `disabled` | `disabled` | `boolean` | `false` | Disables the input and closes its suggestion popup. |
 | `types` | `types` | `string` | `"address"` | Mapbox `types` param, e.g. "address" or "address,poi". |
 | `endpoint` | `endpoint` | `string` | `"https://api.mapbox.com/search/geocode/v6/forward"` | Geocoding endpoint URL. Defaults to the Mapbox Geocoding v6 forward URL. |
 | `accessToken` | `access-token` | `string` | `""` | Mapbox access token. Required for requests to succeed. |
@@ -60,9 +61,13 @@ _None._
 | Custom property |
 | --- |
 | `--ui-border` |
+| `--ui-focus-ring` |
 | `--ui-font` |
 | `--ui-font-size-sm` |
+| `--ui-primary` |
 | `--ui-radius-sm` |
 | `--ui-shadow` |
 | `--ui-surface` |
 | `--ui-surface-muted` |
+| `--ui-text` |
+| `--ui-text-muted` |

package/docs/autocomplete-input.md

@@ -49,6 +49,7 @@ import "@f-ewald/components/autocomplete-input.js";
 | `value` | `value` | `string` | `""` | Current input value; also the form-associated value submitted with the form. |
 | `placeholder` | `placeholder` | `string` | `""` | Placeholder text shown when the input is empty. |
 | `required` | `required` | `boolean` | `false` | Marks the input as required for native form validation. |
+| `disabled` | `disabled` | `boolean` | `false` | Disables the input and closes its suggestion popup. |
 | `endpoint` | `endpoint` | `string` | `""` | API endpoint queried in API mode. Ignored when `options` is set. |
 | `queryParam` | `query-param` | `string` | `"q"` | Query string parameter name the current input text is sent under. |
 | `debounce` | `debounce` | `number` | `300` | Debounce delay (ms) before firing a request/filter after typing. |
@@ -71,9 +72,13 @@ _None._
 | Custom property |
 | --- |
 | `--ui-border` |
+| `--ui-focus-ring` |
 | `--ui-font` |
 | `--ui-font-size-sm` |
+| `--ui-primary` |
 | `--ui-radius-sm` |
 | `--ui-shadow` |
 | `--ui-surface` |
 | `--ui-surface-muted` |
+| `--ui-text` |
+| `--ui-text-muted` |

package/docs/calendar-entry.md

@@ -0,0 +1,53 @@
+# `<calendar-entry>`
+
+Declarative metadata for one calendar event, consumed by a parent
+`calendar-month` or `calendar-year`. Read-only/non-interactive; renders
+nothing itself.
+
+## Install
+
+```js
+import "@f-ewald/components/calendar-entry.js";
+```
+
+## Usage
+
+```html
+<calendar-entry
+  start="2026-07-10"
+  end="2026-07-18"
+  label="Vacation"
+  color="success"
+>
+  <span slot="title">Vacation</span>
+  <span slot="detail">Out of office</span>
+  <span slot="detail">Road trip along the California coast with several scenic stops</span>
+  <span slot="footer">Return July 19 at 6 PM</span>
+</calendar-entry>
+```
+
+## Attributes / properties
+
+| Property | Attribute | Type | Default | Description |
+| --- | --- | --- | --- | --- |
+| `start` | `start` | `string` | `""` | Inclusive start date, `"YYYY-MM-DD"`. |
+| `end` | `end` | `string` | `""` | Inclusive end date, `"YYYY-MM-DD"`. Falls back to `start` when unset (single-day entry). |
+| `label` | `label` | `string` | `""` | Fallback title used when no `title` slot is provided. |
+| `color` | `color` | `StatusPillColor` | `"neutral"` | Color variant, reusing `status-pill`'s palette. |
+| `href` | `href` | `string | undefined` | `—` | Optional link target; the parent renders the entry as an `<a>` when set. |
+
+## Events
+
+_None._
+
+## Slots
+
+| Slot | Description |
+| --- | --- |
+| `title` | Plain-text title shown instead of the `label` fallback. |
+| `detail` | Repeatable plain-text details rendered inside the shared body spanning all remaining days. |
+| `footer` | Plain-text ending note pinned to the bottom of the shared body. |
+
+## CSS custom properties
+
+_None._

package/docs/calendar-month.md

@@ -0,0 +1,79 @@
+# `<calendar-month>`
+
+One month rendered as a top-to-bottom list of days — weekends and today
+highlighted, with declarative `calendar-entry` children shown as colored
+bars spanning the days they cover. An entry's title uses its first visible
+day; every remaining visible day becomes one shared body for wrapped
+details and an optional ending footer. Overlapping entries stack into
+side-by-side lanes rather than being layered/hidden. Read-only.
+
+Lanes are computed independently per instance, from only the entries
+overlapping this month — an entry spanning a month boundary may therefore
+land in a different lane index in the adjacent month's `calendar-month`.
+This is an accepted v1 limitation: cross-month lane continuity would
+require a shared parent (`calendar-year`) to assign lanes globally.
+
+Entry attributes and slotted title/detail text are observed, so a
+standalone month re-renders when consumers update declarative metadata.
+
+## Install
+
+```js
+import "@f-ewald/components/calendar-month.js";
+```
+
+## Usage
+
+```html
+<calendar-month year="2026" month="7">
+  <calendar-entry start="2026-07-10" end="2026-07-18" label="Vacation" color="success">
+    <span slot="title">Vacation</span>
+    <span slot="detail">Out of office</span>
+    <span slot="detail">Road trip along the California coast with several scenic stops</span>
+    <span slot="footer">Return July 19 at 6 PM</span>
+  </calendar-entry>
+  <calendar-entry start="2026-07-15" end="2026-07-20" label="Conference" color="warning" href="#conf">
+    <span slot="detail">Talks and workshops</span>
+    <span slot="footer">Closing keynote · July 20</span>
+  </calendar-entry>
+</calendar-month>
+```
+
+## Attributes / properties
+
+| Property | Attribute | Type | Default | Description |
+| --- | --- | --- | --- | --- |
+| `year` | `year` | `number` | `—` | Calendar year, e.g. `2026`. |
+| `month` | `month` | `number` | `1` | Calendar month, 1-12 (January = 1). |
+
+## Events
+
+_None._
+
+## Slots
+
+| Slot | Description |
+| --- | --- |
+| `(default)` | Declarative `calendar-entry` elements to render for this month. |
+
+## CSS custom properties
+
+| Custom property |
+| --- |
+| `--ui-border` |
+| `--ui-danger` |
+| `--ui-focus-ring` |
+| `--ui-font` |
+| `--ui-font-size` |
+| `--ui-font-size-sm` |
+| `--ui-font-size-xs` |
+| `--ui-hover-overlay` |
+| `--ui-info` |
+| `--ui-primary` |
+| `--ui-radius-sm` |
+| `--ui-success` |
+| `--ui-surface` |
+| `--ui-surface-muted` |
+| `--ui-text` |
+| `--ui-text-muted` |
+| `--ui-warning` |

package/docs/calendar-year.md

@@ -0,0 +1,53 @@
+# `<calendar-year>`
+
+A full year of `calendar-month` blocks, generated from declarative
+`calendar-entry` children. Each entry is re-projected into the
+`calendar-month` blocks it overlaps as a freshly-created `calendar-entry`
+element — the original elements stay slotted here and are never moved,
+since a DOM node can only have one parent. Read-only.
+
+## Install
+
+```js
+import "@f-ewald/components/calendar-year.js";
+```
+
+## Usage
+
+```html
+<calendar-year year="2026">
+  <calendar-entry start="2026-01-28" end="2026-02-03" label="Offsite" color="primary" href="#offsite">
+    <span slot="detail">New York</span>
+    <span slot="detail">Team workshops</span>
+    <span slot="footer">Closing dinner Friday</span>
+  </calendar-entry>
+  <calendar-entry start="2026-03-05" end="2026-03-18" label="Product launch" color="success" href="#launch">
+    <span slot="detail">Coordinate the release across engineering, design, support, and marketing.</span>
+    <span slot="detail">Monitor adoption and production health throughout the rollout.</span>
+    <span slot="footer">Public launch · March 18 at 9 AM</span>
+  </calendar-entry>
+  <calendar-entry start="2026-07-10" end="2026-07-18" label="Vacation" color="success"></calendar-entry>
+</calendar-year>
+```
+
+## Attributes / properties
+
+| Property | Attribute | Type | Default | Description |
+| --- | --- | --- | --- | --- |
+| `year` | `year` | `number` | `—` | Calendar year to render all 12 months for, e.g. `2026`. |
+
+## Events
+
+_None._
+
+## Slots
+
+| Slot | Description |
+| --- | --- |
+| `(default)` | Declarative `calendar-entry` elements spanning the displayed year, re-projected into each month. |
+
+## CSS custom properties
+
+| Custom property |
+| --- |
+| `--ui-font` |

package/docs/chat-message.md

@@ -50,10 +50,14 @@ _None._
 | Custom property |
 | --- |
 | `--ui-border` |
+| `--ui-focus-ring` |
 | `--ui-font` |
+| `--ui-font-mono` |
 | `--ui-font-size` |
+| `--ui-font-size-sm` |
 | `--ui-primary` |
 | `--ui-radius` |
+| `--ui-radius-sm` |
 | `--ui-surface` |
 | `--ui-text` |
 | `--ui-text-muted` |

package/docs/confirm-dialog.md

@@ -51,9 +51,11 @@ import "@f-ewald/components/confirm-dialog.js";
 | `--ui-border` |
 | `--ui-danger` |
 | `--ui-danger-hover` |
+| `--ui-focus-ring` |
 | `--ui-font` |
 | `--ui-font-size` |
 | `--ui-font-size-sm` |
+| `--ui-on-accent` |
 | `--ui-overlay` |
 | `--ui-primary` |
 | `--ui-primary-hover` |

package/docs/copy-link-button.md

@@ -24,6 +24,7 @@ import "@f-ewald/components/copy-link-button.js";
 | --- | --- | --- | --- | --- |
 | `value` | `value` | `string` | `""` | Text to copy. Defaults to `window.location.href` at click time. |
 | `label` | `label` | `string` | `"Copy link"` | Accessible label / tooltip text. |
+| `disabled` | `disabled` | `boolean` | `false` | Disables clipboard copying. |
 
 ## Events
 
@@ -40,6 +41,7 @@ _None._
 
 | Custom property |
 | --- |
+| `--ui-focus-ring` |
 | `--ui-radius-sm` |
 | `--ui-surface-muted` |
 | `--ui-text` |

package/docs/data-table.md

@@ -42,6 +42,7 @@ import "@f-ewald/components/data-table.js";
 | `rowKey` | _(JS property only)_ | `(row: unknown, index: number) => string | number` | `—` | Stable identity for `rows[i]`, used as the repeat-directive key. Defaults to the row's index. |
 | `renderCell` | _(JS property only)_ | `(row: unknown, key: string) => unknown` | `—` | Produces a cell's rendered content for `row`/`column.key`. Default: `row[key]`. |
 | `rowHref` | _(JS property only)_ | `((row: unknown) => string | null) | null` | `null` | When set, clicking a row (outside any nested link/button) navigates to this hash. |
+| `rowLabel` | _(JS property only)_ | `((row: unknown) => string) | null` | `null` | Accessible label for a row's keyboard link; defaults to primitive cell values. |
 
 ## Events
 
@@ -56,6 +57,7 @@ _None._
 | Custom property |
 | --- |
 | `--ui-border` |
+| `--ui-focus-ring` |
 | `--ui-font` |
 | `--ui-font-size-sm` |
 | `--ui-surface-muted` |