@astryxdesign/lab 0.0.0-bootstrap.0 → 0.1.2-canary.04e71b2

package/dist/Schedule/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @file types.ts
+ * @input Public Schedule API concepts
+ * @output Event, view, date, loader, and context types for Schedule
+ * @position Public type surface; consumed by Schedule implementation and exports
+ */
+import type { ReactNode } from 'react';
+import type { PlainDate } from '@astryxdesign/core/utils';
+import type { CalendarEvent } from './CalendarEvent';
+import type { ZonedDateTime, ZonedDateTimeRange } from './zonedDateTime';
+export type { PlainDate } from '@astryxdesign/core/utils';
+export type { CalendarDayEvent, CalendarEvent, CalendarEventBase, CalendarInstantEvent, ScheduleCategory, ScheduleEventColor, } from './CalendarEvent';
+export type { ZonedDateTime, ZonedDateTimeRange } from './zonedDateTime';
+/** Unix epoch milliseconds. */
+export type Instant = number;
+export type ScheduleEventSource = ReadonlyArray<CalendarEvent> | ((start: Instant, end: Instant) => Promise<ReadonlyArray<CalendarEvent>>);
+export type ScheduleDate = Instant;
+export interface ScheduleRange {
+    startDate: PlainDate;
+    endDate: PlainDate;
+    start: Instant;
+    end: Instant;
+}
+export type ScheduleViewOptions = object;
+export interface ScheduleViewComponentProps<Options extends ScheduleViewOptions = ScheduleViewOptions> {
+    options: Options;
+}
+export interface ScheduleNavigationRange {
+    label: string;
+    range: ZonedDateTimeRange;
+}
+export type ScheduleViewComponent<Options extends ScheduleViewOptions = ScheduleViewOptions> = (props: ScheduleViewComponentProps<Options>) => ReactNode;
+export interface ScheduleViewBase {
+    getDateRange: (date: ZonedDateTime) => ZonedDateTimeRange;
+    getPreviousDateRange: (date: ZonedDateTime) => ScheduleNavigationRange;
+    getNextDateRange: (date: ZonedDateTime) => ScheduleNavigationRange;
+}
+export interface ScheduleView<Options extends ScheduleViewOptions = ScheduleViewOptions> extends ScheduleViewBase {
+    component: ScheduleViewComponent<Options>;
+    options: Options;
+}
+export interface ScheduleHeaderContent {
+    startContent: ReactNode;
+    centerContent: ReactNode;
+    endContent: ReactNode;
+}
+export type SchedulePluginPosition = 'start' | 'end';
+export interface SchedulePlugin {
+    renderHeader?: (startContent: ReactNode, centerContent: ReactNode, endContent: ReactNode) => ScheduleHeaderContent;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/Schedule/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/Schedule/types.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AACrC,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAC,aAAa,EAAE,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAEvE,YAAY,EAAC,SAAS,EAAC,MAAM,0BAA0B,CAAC;AACxD,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAC,aAAa,EAAE,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAEvE,+BAA+B;AAC/B,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,MAAM,MAAM,mBAAmB,GAC3B,aAAa,CAAC,aAAa,CAAC,GAC5B,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;AAE9E,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC;AAEnC,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,SAAS,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEzC,MAAM,WAAW,0BAA0B,CACzC,OAAO,SAAS,mBAAmB,GAAG,mBAAmB;IAEzD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAED,MAAM,MAAM,qBAAqB,CAC/B,OAAO,SAAS,mBAAmB,GAAG,mBAAmB,IACvD,CAAC,KAAK,EAAE,0BAA0B,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,kBAAkB,CAAC;IAC1D,oBAAoB,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,uBAAuB,CAAC;IACvE,gBAAgB,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,uBAAuB,CAAC;CACpE;AAED,MAAM,WAAW,YAAY,CAC3B,OAAO,SAAS,mBAAmB,GAAG,mBAAmB,CACzD,SAAQ,gBAAgB;IACxB,SAAS,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,EAAE,SAAS,CAAC;IACxB,aAAa,EAAE,SAAS,CAAC;IACzB,UAAU,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,KAAK,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,CACb,YAAY,EAAE,SAAS,EACvB,aAAa,EAAE,SAAS,EACxB,UAAU,EAAE,SAAS,KAClB,qBAAqB,CAAC;CAC5B"}

package/dist/Schedule/types.js

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

package/dist/Schedule/useCurrentTime.d.ts

@@ -0,0 +1,3 @@
+import type { Instant } from './types';
+export declare function useCurrentTime(): Instant;
+//# sourceMappingURL=useCurrentTime.d.ts.map

package/dist/Schedule/useCurrentTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCurrentTime.d.ts","sourceRoot":"","sources":["../../src/Schedule/useCurrentTime.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,SAAS,CAAC;AAmCrC,wBAAgB,cAAc,IAAI,OAAO,CAExC"}

package/dist/Schedule/useCurrentTime.js

@@ -0,0 +1,43 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file useCurrentTime.ts
+ * @input Browser clock
+ * @output A shared ticking Instant value for schedule current-time affordances
+ * @position Internal hook consumed by schedule views
+ */
+import { useSyncExternalStore } from 'react';
+const UPDATE_INTERVAL_MS = 60 * 1000;
+const listeners = new Set();
+let interval = null;
+let currentTime = Date.now();
+function getSnapshot() {
+  return currentTime;
+}
+
+// SSR returns 0 because current time only drives client-side affordances
+// (now-indicator line, past-event dimming) that are acceptable to hydrate.
+function getServerSnapshot() {
+  return 0;
+}
+function subscribe(listener) {
+  listeners.add(listener);
+  if (interval == null) {
+    interval = setInterval(() => {
+      currentTime = Date.now();
+      listeners.forEach(activeListener => activeListener());
+    }, UPDATE_INTERVAL_MS);
+  }
+  return () => {
+    listeners.delete(listener);
+    if (listeners.size === 0 && interval != null) {
+      clearInterval(interval);
+      interval = null;
+    }
+  };
+}
+export function useCurrentTime() {
+  return useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+}

package/dist/Schedule/zonedDateTime.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @file zonedDateTime.ts
+ * @input Instant epoch milliseconds and IANA timezone IDs
+ * @output Lightweight ZonedDateTime helpers used by Schedule views
+ * @position Internal timezone-aware date bridge between schedule shell and views
+ */
+import { type PlainDate } from '@astryxdesign/core/utils';
+import type { Instant, ScheduleRange, ScheduleDate } from './types';
+export interface ZonedDateTime {
+    instant: Instant;
+    timezoneID: string;
+    toPlainDate: () => PlainDate;
+    addDays: (days: number) => ZonedDateTime;
+    startOfDay: () => ZonedDateTime;
+}
+export type ZonedDateTimeRange = [ZonedDateTime, ZonedDateTime];
+export declare function createZonedDateTime(date: ScheduleDate, timezoneID: string): ZonedDateTime;
+export declare function zonedDateTimeFromInstant(instant: Instant, timezoneID: string): ZonedDateTime;
+export declare function scheduleRangeToZonedDateTimeRange(range: ScheduleRange, timezoneID: string): ZonedDateTimeRange;
+//# sourceMappingURL=zonedDateTime.d.ts.map

package/dist/Schedule/zonedDateTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zonedDateTime.d.ts","sourceRoot":"","sources":["../../src/Schedule/zonedDateTime.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAC,MAAM,SAAS,CAAC;AAElE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,SAAS,CAAC;IAC7B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,CAAC;IACzC,UAAU,EAAE,MAAM,aAAa,CAAC;CACjC;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AAEhE,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,YAAY,EAClB,UAAU,EAAE,MAAM,GACjB,aAAa,CAEf;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GACjB,aAAa,CAuBf;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,aAAa,EACpB,UAAU,EAAE,MAAM,GACjB,kBAAkB,CAKpB"}

package/dist/Schedule/zonedDateTime.js

@@ -0,0 +1,31 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file zonedDateTime.ts
+ * @input Instant epoch milliseconds and IANA timezone IDs
+ * @output Lightweight ZonedDateTime helpers used by Schedule views
+ * @position Internal timezone-aware date bridge between schedule shell and views
+ */
+
+import { plainDateAddDays, plainDateFromInstant, plainDateToInstant } from '@astryxdesign/core/utils';
+export function createZonedDateTime(date, timezoneID) {
+  return zonedDateTimeFromInstant(date, timezoneID);
+}
+export function zonedDateTimeFromInstant(instant, timezoneID) {
+  return {
+    instant,
+    timezoneID,
+    toPlainDate: () => plainDateFromInstant(instant, timezoneID),
+    addDays: days => {
+      const date = plainDateAddDays(plainDateFromInstant(instant, timezoneID), days);
+      return zonedDateTimeFromInstant(plainDateToInstant(date, timezoneID), timezoneID);
+    },
+    startOfDay: () => {
+      const date = plainDateFromInstant(instant, timezoneID);
+      return zonedDateTimeFromInstant(plainDateToInstant(date, timezoneID), timezoneID);
+    }
+  };
+}
+export function scheduleRangeToZonedDateTimeRange(range, timezoneID) {
+  return [zonedDateTimeFromInstant(range.start, timezoneID), zonedDateTimeFromInstant(range.end, timezoneID)];
+}

package/dist/Stepper/Step.d.ts

@@ -0,0 +1,120 @@
+/**
+ * @file Step.tsx
+ * @input Uses React, stylex, theme tokens, StepperContext
+ * @output Exports Step component and StepProps
+ * @position Individual step item; used inside Stepper
+ *
+ * SYNC: When modified, update these files to stay in sync:
+ * - /packages/lab/src/Stepper/Stepper.doc.mjs
+ * - /packages/lab/src/Stepper/Stepper.test.tsx
+ * - /packages/lab/src/Stepper/index.ts
+ * - /apps/storybook/stories/Stepper.stories.tsx
+ * - /packages/cli/templates/blocks/components/Stepper/ (showcase blocks)
+ */
+import { type ReactNode } from 'react';
+import type { BaseProps } from '@astryxdesign/core';
+import type { StepStatus } from './StepStatus';
+/**
+ * Built-in indicator presets. Anything other than these strings passed to
+ * `indicator` is treated as a custom ReactNode (e.g. an `<Icon />`).
+ * - 'auto': numbered badge for not-yet-reached steps, a check once completed
+ *   (default)
+ * - 'number': always a numbered badge
+ * - 'none': no indicator — just the progress bar and label
+ */
+export type StepIndicatorPreset = 'auto' | 'number' | 'none';
+export type StepDensity = 'compact' | 'balanced' | 'spacious';
+export interface StepProps extends BaseProps<HTMLLIElement> {
+    /** Ref forwarded to the root element */
+    ref?: React.Ref<HTMLLIElement>;
+    /**
+     * Zero-based index of this step. Used to derive progress (completed /
+     * active / not-started) relative to the parent's `activeStep`.
+     */
+    step: number;
+    /**
+     * Step label text.
+     */
+    label: string;
+    /**
+     * Optional description shown below the label.
+     */
+    description?: string;
+    /**
+     * Content rendered below the label and description. Useful in vertical
+     * steppers to show form fields or detailed content for each step.
+     */
+    children?: ReactNode;
+    /**
+     * Custom icon rendered inside the indicator. Accepts any ReactNode (for
+     * example an `<Icon />`). Equivalent to passing the node directly to
+     * `indicator`; takes precedence over the built-in number/check.
+     */
+    icon?: ReactNode;
+    /**
+     * Semantic color for the step. Controls **color only** and maps to the
+     * global Astryx semantic tokens (`accent`, `success`, `warning`, `error`).
+     * Leave unset to use the progress-derived default coloring.
+     */
+    status?: StepStatus;
+    /**
+     * Disable interaction for this step.
+     * @default false
+     */
+    isDisabled?: boolean;
+    /**
+     * Marks the step as optional, appending an "Optional" affordance after the
+     * label.
+     * @default false
+     */
+    isOptional?: boolean;
+    /**
+     * Trailing content rendered at the end of the label row (e.g. a timestamp
+     * or status chip).
+     */
+    endContent?: ReactNode;
+    /**
+     * What to show as the step indicator. Accepts a preset string or any
+     * ReactNode:
+     * - 'auto': numbered badge until completed, then a check (default)
+     * - 'number': always a numbered badge
+     * - 'none': no indicator, just the bar + label
+     * - ReactNode: any custom icon or element to render as the indicator
+     * @default 'auto'
+     */
+    indicator?: StepIndicatorPreset | ReactNode;
+    /**
+     * Controls vertical padding of the step. Falls back to the stepper-level
+     * density when unset.
+     * - 'compact': minimal padding (4px block)
+     * - 'balanced': default (8px block)
+     * - 'spacious': generous (12px block, 12px inline)
+     */
+    density?: StepDensity;
+}
+/**
+ * An individual step within an Stepper. Renders a 4px progress-bar segment,
+ * an indicator (numbered badge, check, or any custom icon), a label with
+ * optional description, and an optional content slot.
+ *
+ * Progress (completed / active / not-started) is derived from the parent's
+ * `activeStep` and this step's `step` prop. The optional `status` prop layers a
+ * semantic color (`accent` / `success` / `warning` / `error`) on top — color
+ * only; it does not change layout or iconography.
+ *
+ * @example
+ * ```
+ * <Step step={0} label="Account details" description="Enter your email" />
+ * ```
+ *
+ * @example
+ * ```
+ * // Generic icon + semantic color
+ * <Step step={1} label="Payment" status="error" icon={<Icon icon="warning" />} />
+ * ```
+ */
+export declare function Step({ step, label, description, children, icon, status, isDisabled, isOptional, endContent, indicator: indicatorProp, density: densityProp, xstyle, className, style, ref, 'data-testid': dataTestId, ...rest }: StepProps): import("react").JSX.Element;
+export declare namespace Step {
+    var displayName: string;
+}
+//# sourceMappingURL=Step.d.ts.map

package/dist/Stepper/Step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Step.d.ts","sourceRoot":"","sources":["../../src/Stepper/Step.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAC,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAarC,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAGlD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC7D,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAE9D,MAAM,WAAW,SAAU,SAAQ,SAAS,CAAC,aAAa,CAAC;IACzD,wCAAwC;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC/B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC5C;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AA6SD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,IAAI,CAAC,EACnB,IAAI,EACJ,KAAK,EACL,WAAW,EACX,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,UAAkB,EAClB,UAAkB,EAClB,UAAU,EACV,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,WAAW,EACpB,MAAM,EACN,SAAS,EACT,KAAK,EACL,GAAG,EACH,aAAa,EAAE,UAAU,EACzB,GAAG,IAAI,EACR,EAAE,SAAS,+BA2SX;yBA7Te,IAAI"}