snice 7.8.0 → 7.9.0

package/dist/cdn/tabs/snice-tabs.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/tag/snice-tag.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/tag-input/snice-tag-input.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/terminal/snice-terminal.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/testimonial/snice-testimonial.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/textarea/snice-textarea.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/time-picker/snice-time-picker.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/time-range-picker/snice-time-range-picker.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/timeline/snice-timeline.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/timer/snice-timer.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/toast/snice-toast.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/tooltip/snice-tooltip.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/tree/snice-tree.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/treemap/snice-treemap.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/user-card/snice-user-card.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/video-player/snice-video-player.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/virtual-scroller/snice-virtual-scroller.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/waterfall/snice-waterfall.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/weather/snice-weather.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/cdn/work-order/snice-work-order.js

@@ -1,5 +1,5 @@
 /*!
- * snice v7.7.0
+ * snice v7.8.0
  * A decorator-driven web component library with routing, controllers, daemons, and 130+ UI components. For better coding-agent results, run npx snice init-ai.
  * (c) 2024
  * Released under the MIT License.

package/dist/components/calendar/snice-calendar.d.ts

@@ -1,7 +1,13 @@
 import '../avatar/snice-avatar';
 import type { SniceCalendarElement, CalendarView, CalendarEvent, CalendarEventTooltip, CalendarEventPopoverProvider } from './snice-calendar.types';
 export declare class SniceCalendar extends HTMLElement implements SniceCalendarElement {
-    value: Date | string;
+    /**
+     * The selected day, or `null` for "nothing selected yet" — the state a
+     * calendar starts in. A default of today would paint the selected
+     * background over today's own highlight, making `highlight-today` invisible
+     * and announcing `aria-selected` for a choice the user never made.
+     */
+    value: Date | string | null;
     view: CalendarView;
     events: CalendarEvent[];
     minDate: Date | string;
@@ -28,11 +34,30 @@ export declare class SniceCalendar extends HTMLElement implements SniceCalendarE
     private header;
     private grid;
     private dayCells;
+    private weekNumberHeader;
+    private weekNumberCells;
     private focusedDate;
+    /**
+     * Columns the day grid is shifted by. The week-number column occupies the
+     * grid's first column, so every explicitly-placed child — weekday headers,
+     * day cells, event stripes — moves one column right while it is shown.
+     */
+    private get columnOffset();
     private computeRovingIndex;
     private handleGridKeydown;
     private dispatchChange;
     private dispatchEventClick;
+    /**
+     * `calendar-more-click` carries a default action (the built-in day panel),
+     * so it is cancelable and the component has to read the result of the
+     * dispatch. `@dispatch` accepts `cancelable` — it is EventInit passthrough —
+     * but the decorated method returns the detail, not `dispatchEvent`'s
+     * boolean, so a cancelable default action cannot be observed through it.
+     * Dispatched by hand for that reason, the same way `snice-link`'s `navigate`
+     * and `snice-stepper`'s `step-change` are.
+     *
+     * @returns `false` when a listener called `preventDefault()`.
+     */
     private dispatchMoreClick;
     styles(): import("snice").CSSResult;
     initialize(): void;
@@ -42,24 +67,172 @@ export declare class SniceCalendar extends HTMLElement implements SniceCalendarE
      * `@respond('calendar/event-popover')` controller can return the content.
      */
     private requestEventPopoverContent;
+    /**
+     * Opens the shared overlay, empty, anchored on `anchor`, and arms its
+     * Escape / outside-press dismissal. Both panels the calendar owns — the
+     * event popover and the "+N more" day list — go through here, so they share
+     * one dismissal contract and one focus-return target.
+     *
+     * @returns the token identifying this opening; async content must check it
+     *          against `popoverToken` before painting.
+     */
+    private beginPopover;
     private openEventPopover;
+    /**
+     * The "+N more" chip's built-in default action: the day's hidden events,
+     * listed in the shared overlay.
+     *
+     * Wiring `calendar-more-click` is an application concern, but a chip that
+     * visibly does nothing when clicked reads as broken, so the component owns a
+     * sensible default. It is only a default — the event is cancelable, and
+     * `preventDefault()` leaves the day to the app.
+     */
+    private openMorePanel;
+    /**
+     * A panel entry behaves like the event's own stripe: it reports the click,
+     * and drills into the event's popover when it has one. Without popover
+     * content there is nothing further to show, so the panel closes and hands
+     * focus back to the chip.
+     */
+    private handleMorePanelEntry;
+    /**
+     * Places an overlay at a point given in viewport coordinates.
+     *
+     * `:host` declares `contain: layout`, which makes the host — not the
+     * viewport — the containing block for its `position: fixed` descendants, so
+     * viewport coordinates written straight into `left`/`top` land the overlay a
+     * whole host-offset down the page. The overlays are `position: absolute`
+     * inside `.calendar` instead, and the target is converted into that box
+     * here, which is correct with or without the containment.
+     */
+    private placeOverlay;
+    /** Gap between a bar and its overlay, and the minimum viewport margin. */
+    private static readonly OVERLAY_GAP;
+    private static readonly OVERLAY_EDGE;
+    /** Clamps an overlay's left edge into the viewport. */
+    private clampOverlayX;
     private positionPopover;
     closeEventPopover(options?: {
         returnFocus?: boolean;
     }): void;
+    /** Keeps a popup trigger's `aria-expanded` in step with the overlay. Guarded
+     *  on `aria-haspopup` so only the anchors that actually advertise a popup —
+     *  the "+N more" chip and an event bar carrying popover content — claim the
+     *  state; a plain bar is not a trigger and must not report one. */
+    private setAnchorExpanded;
     cleanupPopover(): void;
     private showEventTooltip;
+    private positionTooltip;
     private hideEventTooltip;
+    /**
+     * Marks the host while a tooltip or popover is showing. Layout containment
+     * makes the host a stacking context, so an overlay can only paint above what
+     * follows the calendar if the host itself is lifted — see
+     * `:host([overlay-open])` in the stylesheet.
+     */
+    private syncOverlayLift;
     private updateView;
-    /** Visible stacking depth for event stripes; deeper lanes collapse into a
-     *  per-day "+N more" chip. */
-    private static readonly MAX_EVENT_LANES;
+    /**
+     * Attaches or detaches the week-number column and re-places every
+     * explicitly-positioned grid child for the resulting column offset.
+     */
+    private syncWeekNumberColumn;
+    /**
+     * Number of the week that starts on `weekStart`.
+     *
+     * Monday-start calendars use ISO-8601 (week 1 is the week holding the year's
+     * first Thursday). Every other start-of-week uses the common civil rule —
+     * the week containing January 1 is week 1 — anchored on the year the week
+     * ends in, so the turn-of-year week is numbered once, not twice.
+     */
+    private getWeekNumber;
+    /** Event-lane geometry in rem — mirrors snice-calendar.css. */
+    private static readonly LANE_HEIGHT_REM;
+    /** Day-number strip above the first lane (the constant in the cell's
+     *  min-height reservation). */
+    private static readonly LANE_STACK_TOP_REM;
+    /** Strip the "+N more" chip claims when a stack overflows. */
+    private static readonly MORE_CHIP_REM;
+    /** Intrinsic floor of a `cell-sizing="stretch"` cell. */
+    private static readonly STRETCH_FLOOR_REM;
+    /** Lane depth used when there is no layout to measure (headless DOM,
+     *  detached, `display: none`). */
+    private static readonly DEFAULT_EVENT_LANES;
+    /**
+     * Height a single lane physically occupies, measured from the top of the
+     * cell: the bar sits 1.875rem down and is 1.125rem tall.
+     *
+     * LANE_STACK_TOP_REM + LANE_HEIGHT_REM (3.5rem) is the *budgeted* cost of a
+     * lane — it carries a bottom gap so the next lane has somewhere to go. This
+     * is the smaller number the budget falls back to when the row cannot grow:
+     * the point below which a drawn lane would be clipped by its own cell.
+     */
+    private static readonly LANE_MIN_FIT_REM;
+    /** Height the "+N more" chip itself occupies at the bottom of the cell. */
+    private static readonly MORE_CHIP_FIT_REM;
+    /**
+     * Narrowest segment, in rem, that still carries an event avatar.
+     *
+     * A one-day chip in a 400px month grid is ~57px wide; the avatar, its gap,
+     * and the bar padding leave the title three characters ("Des…"). The title
+     * is the payload and the avatar is an adornment, so — like every
+     * professional calendar — a segment that cannot carry both keeps the title
+     * and drops the adornment. 4.5rem is the width at which a default-size
+     * title still reads next to the avatar.
+     */
+    private static readonly AVATAR_MIN_SEGMENT_REM;
+    /**
+     * How many event lanes fit in a day cell, and how many still fit once the
+     * "+N more" chip claims its strip.
+     *
+     * Measured from the cell's own height with every lane reservation cleared,
+     * so the budget follows whatever sizes the cell — the square baseline
+     * (`100cqw / 7`), a height the host imposes on the calendar, or the stretch
+     * floor — and never feeds back on itself. A `cell-sizing="stretch"` cell the
+     * host does not constrain has no budget at all: its row grows to fit every
+     * lane, which is what "collapse to content" means.
+     */
+    private laneBudget;
+    /** True while `--calendar-row-cap` is holding the week rows below the size
+     *  they would take of their own accord. */
+    private rowCapped;
+    /**
+     * Fits the six week rows inside a host that constrains the calendar's
+     * height.
+     *
+     * The square baseline sizes a week row from the *column width*
+     * (`100cqw / 7`), which says nothing about how much height the host has
+     * given the grid. A host that hands down a definite height — the components
+     * page's `aspect-ratio: 1` card is the reported case — therefore gets a grid
+     * whose min-content height exceeds its box: the grid overflows, and whatever
+     * clips it (that card's `overflow: hidden`) takes the bottom weeks of the
+     * month with it.
+     *
+     * The room the grid has and the room it wants are both measurable, so the
+     * fix is to compare them and publish the per-row ceiling when they disagree.
+     * With no constraint the container's height IS its content height, the two
+     * agree, and nothing is published — square cells and the growable lane
+     * reservation are untouched. Measured with the cap cleared, so it never
+     * feeds back on itself.
+     *
+     * Month view only. The cap divides the room into WEEK_ROWS equal shares and
+     * lands as a definite `grid-template-rows` track; the week and day views
+     * carry their own taller `min-height` at higher specificity, so a definite
+     * track there would leave every cell overflowing its own row and painting
+     * over the next one. They keep the pre-cap behaviour — the var stays unset,
+     * the tracks stay `auto`.
+     */
+    private syncRowCap;
+    /** Week rows in a month grid. */
+    private static readonly WEEK_ROWS;
     /**
      * Render events as continuous stripes: one bar per (event × week row),
      * spanning the event's days in that week and chopped at week boundaries
      * with continues-left/right styling. Overlapping events stack into lanes
      * per week — earlier start first, longer event first on ties — like
-     * professional calendars.
+     * professional calendars. How many of those lanes are drawn is the week's
+     * share of the day cell's height (see laneBudget); the rest collapse into
+     * the day's "+N more" chip.
      */
     private renderEventStripes;
     goToToday(): void;
@@ -86,6 +259,15 @@ export declare class SniceCalendar extends HTMLElement implements SniceCalendarE
     private getMonthDays;
     private getWeekdays;
     handlePropertyChange(): void;
+    /** Box the stripes were last laid out against, so a resize that changes
+     *  nothing (including the one the render itself causes) is a no-op. */
+    private laidOutFor;
+    /**
+     * The lane budget comes from the cell's height, and that height follows the
+     * calendar's own box — column width in square mode, the host's height when
+     * it has one. Re-stripe when the box actually changes.
+     */
+    handleCalendarResize(entry: ResizeObserverEntry): void;
     handleWeekdayInputsChange(): void;
 }
 declare global {