terminoir 0.4.0 → 0.5.1

package/dist/utils/calendar.js

@@ -0,0 +1,105 @@
+/** Wall-clock calendar helpers (local time zone) for week and month views. */
+export const MINUTES_PER_DAY = 24 * 60;
+const MIN_EVENT_MINUTES = 15;
+const MONTH_GRID_DAYS = 42;
+export function startOfDay(d) {
+    const x = new Date(d);
+    x.setHours(0, 0, 0, 0);
+    return x;
+}
+/** Monday of the week containing `d`. */
+export function startOfWeek(d) {
+    const x = startOfDay(d);
+    const day = x.getDay();
+    x.setDate(x.getDate() + (day === 0 ? -6 : 1 - day));
+    return x;
+}
+export function addDays(d, n) {
+    const x = new Date(d);
+    x.setDate(x.getDate() + n);
+    return x;
+}
+export function sameDay(a, b) {
+    return startOfDay(a).getTime() === startOfDay(b).getTime();
+}
+/** Visible range `[start, end)` around `anchor`: a Monday-start week or a calendar month. */
+export function calendarRange(anchor, mode) {
+    if (mode === 'week') {
+        const start = startOfWeek(anchor);
+        return { start, end: addDays(start, 7) };
+    }
+    return {
+        start: new Date(anchor.getFullYear(), anchor.getMonth(), 1),
+        end: new Date(anchor.getFullYear(), anchor.getMonth() + 1, 1),
+    };
+}
+/** Move the anchor by `delta` weeks or months. */
+export function shiftCalendar(anchor, mode, delta) {
+    if (mode === 'week')
+        return addDays(anchor, 7 * delta);
+    const x = new Date(anchor);
+    x.setMonth(x.getMonth() + delta);
+    return x;
+}
+/** Six Monday-start weeks covering the month of `monthStart`. */
+export function monthGrid(monthStart) {
+    const first = startOfWeek(monthStart);
+    return Array.from({ length: MONTH_GRID_DAYS }, (_, i) => addDays(first, i));
+}
+/** Whether `event` shows on `day`: timed events on their start day, all-day events on every day they span. */
+function occursOn(event, day) {
+    if (!event.allDay)
+        return sameDay(event.start, day);
+    const dayStart = startOfDay(day).getTime();
+    const end = Math.max(event.end.getTime(), addDays(startOfDay(event.start), 1).getTime());
+    return startOfDay(event.start).getTime() <= dayStart && dayStart < end;
+}
+/** Events showing on `day` (multi-day all-day events on each day), all-day first, then by start time. */
+export function eventsOn(events, day) {
+    return events
+        .filter((e) => occursOn(e, day))
+        .sort((a, b) => Number(b.allDay) - Number(a.allDay) || a.start.getTime() - b.start.getTime());
+}
+/** Vertical position of a timed event in a day column, as percentages of the day. */
+export function dayLayout(event) {
+    const minutes = (event.start.getTime() - startOfDay(event.start).getTime()) / 60000;
+    const duration = Math.max(MIN_EVENT_MINUTES, (event.end.getTime() - event.start.getTime()) / 60000);
+    const top = (minutes / MINUTES_PER_DAY) * 100;
+    return { top, height: Math.min((duration / MINUTES_PER_DAY) * 100, 100 - top) };
+}
+const COMPACT_MAX_MINUTES = 30;
+/** Lay out a day's timed events so overlapping ones sit side by side instead of on top of each other. */
+export function layoutDay(events) {
+    const sorted = [...events].sort((a, b) => a.start.getTime() - b.start.getTime() || b.end.getTime() - a.end.getTime());
+    const placed = [];
+    let group = [];
+    let laneEnds = [];
+    let groupEnd = -Infinity;
+    const closeGroup = () => {
+        for (const item of group)
+            item.lanes = laneEnds.length;
+        group = [];
+        laneEnds = [];
+    };
+    for (const event of sorted) {
+        const start = event.start.getTime();
+        const end = Math.max(event.end.getTime(), start + MIN_EVENT_MINUTES * 60000);
+        if (start >= groupEnd)
+            closeGroup();
+        let lane = laneEnds.findIndex((laneEnd) => laneEnd <= start);
+        if (lane === -1) {
+            lane = laneEnds.length;
+            laneEnds.push(end);
+        }
+        else {
+            laneEnds[lane] = end;
+        }
+        groupEnd = Math.max(groupEnd, end);
+        const minutes = (event.end.getTime() - start) / 60000;
+        const item = { event, ...dayLayout(event), lane, lanes: 1, compact: minutes <= COMPACT_MAX_MINUTES };
+        group.push(item);
+        placed.push(item);
+    }
+    closeGroup();
+    return placed;
+}

package/dist/utils/commands.d.ts

@@ -0,0 +1,22 @@
+export type CommandItem = {
+    id: string;
+    label: string;
+    /** Secondary text on the right, e.g. a type name or shortcut. */
+    hint?: string;
+    /** Extra words that match the query but are not shown. */
+    keywords?: string;
+    /** Rows with the same group are listed together under that heading. */
+    group?: string;
+    /** NavIcon name shown before the label. */
+    icon?: string;
+    iconColor?: string;
+    onSelect?: () => void;
+};
+export type CommandGroup = {
+    group: string | undefined;
+    items: CommandItem[];
+};
+/** Case-insensitive substring match on label + keywords; an empty query keeps everything. */
+export declare function filterCommands(items: CommandItem[], query: string): CommandItem[];
+/** Group rows by `group`, keeping first-seen group order and row order within groups. */
+export declare function groupCommands(items: CommandItem[]): CommandGroup[];

package/dist/utils/commands.js

@@ -0,0 +1,17 @@
+/** Case-insensitive substring match on label + keywords; an empty query keeps everything. */
+export function filterCommands(items, query) {
+    const needle = query.trim().toLowerCase();
+    if (!needle)
+        return items;
+    return items.filter((item) => `${item.label} ${item.keywords ?? ''}`.toLowerCase().includes(needle));
+}
+/** Group rows by `group`, keeping first-seen group order and row order within groups. */
+export function groupCommands(items) {
+    const groups = new Map();
+    for (const item of items) {
+        const rows = groups.get(item.group) ?? [];
+        rows.push(item);
+        groups.set(item.group, rows);
+    }
+    return [...groups].map(([group, rows]) => ({ group, items: rows }));
+}

package/dist/utils/componentTypes.d.ts

@@ -0,0 +1,41 @@
+export type DataColumn = {
+    key: string;
+    label: string;
+    /** CSS width, e.g. `8rem` or `30%`. */
+    width?: string;
+    align?: 'start' | 'end';
+    /** Hide below 700px so phone tables keep their key columns. */
+    hideOnMobile?: boolean;
+};
+export type PickerOption = {
+    id: string;
+    label: string;
+    description?: string;
+    /** NavIcon name. */
+    icon?: string;
+    iconColor?: string;
+};
+export type RadioCardOption = {
+    value: string;
+    label: string;
+    description?: string;
+};
+export type SegmentOption = {
+    value: string;
+    label: string;
+};
+export type DescriptionItem = {
+    term: string;
+    detail: string | number;
+    tone?: 'default' | 'danger' | 'success';
+};
+export type ViewerMark = {
+    id: string;
+    /** Position and size as fractions (0–1) of the page. */
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    color?: string;
+    label?: string;
+};

package/dist/utils/componentTypes.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/listNav.d.ts

@@ -0,0 +1,2 @@
+/** Move a highlighted row by `delta`, wrapping around a list of `length` rows (-1 when empty). */
+export declare function moveIndex(current: number, delta: number, length: number): number;

package/dist/utils/listNav.js

@@ -0,0 +1,8 @@
+/** Move a highlighted row by `delta`, wrapping around a list of `length` rows (-1 when empty). */
+export function moveIndex(current, delta, length) {
+    if (length <= 0)
+        return -1;
+    if (current < 0)
+        return delta > 0 ? 0 : length - 1;
+    return (((current + delta) % length) + length) % length;
+}

package/dist/utils/menu.d.ts

@@ -0,0 +1,10 @@
+export type MenuItem = {
+    id: string;
+    label: string;
+    /** NavIcon name. */
+    icon?: string;
+    /** `danger` for destructive actions (delete, revoke). */
+    tone?: 'default' | 'danger';
+    disabled?: boolean;
+    onSelect?: () => void;
+};

package/dist/utils/menu.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "terminoir",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Terminoir \u2014 Liquid Glass design tokens and Svelte 5 UI components.",
   "license": "Apache-2.0",
   "type": "module",
@@ -55,11 +55,12 @@
     "test": "vitest run",
     "demo:dev": "pnpm --dir demo dev",
     "demo:build": "pnpm --dir demo build",
-    "prepublishOnly": "pnpm build && pnpm test"
+    "prepublishOnly": "pnpm check && pnpm build && pnpm test",
+    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --threshold error"
   },
   "peerDependencies": {
     "react": ">=18 <20",
-    "svelte": "^5.0.0"
+    "svelte": "^5.20.0"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -96,6 +97,7 @@
     "publint": "^0.3.8",
     "react": "^19.0.0",
     "svelte": "^5.20.2",
+    "svelte-check": "^4.7.8",
     "tsup": "^8.3.5",
     "typescript": "^5.7.3",
     "vitest": "^3.0.5"