@close-by/clay 0.2.3 → 0.2.5

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "@close-by/clay",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "NiceGUI-like ui.* facade for Clay apps",
   "license": "MIT",
   "type": "module",
   "main": "src/index.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": "./src/index.ts",
+    "./page-tsconfig": "./page-tsconfig.json"
   },
   "files": [
     "src",
+    "page-tsconfig.json",
     "README.md",
     "LICENSE",
     "!src/**/*.test.ts",
@@ -25,9 +27,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@close-by/clay-core": "0.2.3",
-    "@close-by/clay-components": "0.2.3",
-    "@close-by/clay-server": "0.2.3",
+    "@close-by/clay-compiler": "0.2.5",
+    "@close-by/clay-core": "0.2.5",
+    "@close-by/clay-components": "0.2.5",
+    "@close-by/clay-server": "0.2.5",
     "@tailwindcss/cli": "^4.3.3",
     "tailwindcss": "^4.3.3"
   }

package/page-tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "compilerOptions": {
+    "lib": ["ESNext"],
+    "types": ["bun-types"],
+    "target": "ESNext",
+    "module": "Preserve",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "verbatimModuleSyntax": true
+  }
+}

package/src/index.ts

@@ -9,6 +9,9 @@ import {
   radioGroup as radioGroupFactory,
   combobox as comboboxFactory,
   date as dateFactory,
+  dateRange as dateRangeFactory,
+  timeline as timelineFactory,
+  stepper as stepperFactory,
   tooltip as tooltipFactory,
   avatar as avatarFactory,
   skeleton as skeletonFactory,
@@ -22,6 +25,8 @@ import {
   progress as progressFactory,
   separator as separatorFactory,
   icon as iconFactory,
+  iconText as iconTextFactory,
+  statusDot as statusDotFactory,
   stat as statFactory,
   dataTable as dataTableFactory,
   areaChart as areaChartFactory,
@@ -32,6 +37,7 @@ import {
   radialChart as radialChartFactory,
   scatterChart as scatterChartFactory,
   composedChart as composedChartFactory,
+  sparkline as sparklineFactory,
   row as rowFactory,
   column as columnFactory,
   container as containerFactory,
@@ -99,6 +105,14 @@ import {
   type RadioGroupProps,
   type ComboboxProps,
   type DateProps,
+  type DateRangeProps,
+  type DateRangePreset,
+  type TimelineProps,
+  type TimelineItem,
+  type TimelineItemStatus,
+  type StepperProps,
+  type StepperStepOptions,
+  type StepperStepStatus,
   type TooltipProps,
   type AvatarProps,
   type SkeletonProps,
@@ -111,6 +125,10 @@ import {
   type ProgressProps,
   type SeparatorProps,
   type IconProps,
+  type IconTextProps,
+  type IconSlotProps,
+  type StatusDotProps,
+  type StatusDotColor,
   type StatItem,
   type DataTableProps,
   type DataTableAction,
@@ -146,6 +164,11 @@ import {
   type ComposedSeriesType,
   type CartesianChartProps,
   type ChartSeries,
+  type ChartHeadline,
+  type ChartPeriod,
+  type ChartReferenceLine,
+  type ChartReferenceArea,
+  type SparklineProps,
   type CardProps,
   type DialogProps,
   type DialogStackProps,
@@ -312,6 +335,7 @@ import {
   TableBuilder,
   DialogElement,
   DialogStackElement,
+  StepperElement,
   AlertDialogElement,
   DropdownMenuElement,
   ContextMenuElement,
@@ -440,6 +464,14 @@ export type {
   DialogProps,
   DialogStackProps,
   DialogStackStepOptions,
+  StepperProps,
+  StepperStepOptions,
+  StepperStepStatus,
+  TimelineProps,
+  TimelineItem,
+  TimelineItemStatus,
+  DateRangeProps,
+  DateRangePreset,
   AlertDialogProps,
   DropdownMenuProps,
   DropdownItemOptions,
@@ -594,6 +626,7 @@ export {
   TableBuilder,
   DialogElement,
   DialogStackElement,
+  StepperElement,
   AlertDialogElement,
   DropdownMenuElement,
   SheetElement,
@@ -624,7 +657,10 @@ export function label(text?: string | (() => string), props?: Omit<LabelProps, '
 }
 
 /** Clickable button. Prefer `ui.button`. See {@link ButtonProps}. */
-export function button(text?: string, props?: Omit<ButtonProps, 'text'>): Element {
+export function button(
+  text?: string | (() => string),
+  props?: Omit<ButtonProps, 'text'>,
+): Element {
   return buttonFactory(text, props);
 }
 
@@ -671,6 +707,29 @@ export function date(props?: DateProps): Element {
   return dateFactory(props);
 }
 
+/** Date range picker with presets. Prefer `ui.dateRange`. See {@link DateRangeProps}. */
+export function dateRange(props?: DateRangeProps): Element {
+  return dateRangeFactory(props);
+}
+
+/** Chronological events for feeds and deploy logs. See {@link TimelineProps}. */
+export function timeline(props: TimelineProps): Element {
+  return timelineFactory(props);
+}
+
+/** Inline multi-step flow with step panels. See {@link StepperProps}. */
+export function stepper(
+  fn: (s: StepperElement) => void,
+  props?: StepperProps,
+): StepperElement;
+export function stepper(
+  props: StepperProps,
+  fn: (s: StepperElement) => void,
+): StepperElement;
+export function stepper(a: any, b?: any): StepperElement {
+  return stepperFactory(a, b);
+}
+
 /** Tooltip around content (`fn` or props-first). Prefer `ui.tooltip`. See {@link TooltipProps}. */
 export function tooltip(fn: () => void, props: TooltipProps): Element;
 export function tooltip(props: TooltipProps, fn: () => void): Element;
@@ -713,8 +772,11 @@ export function externalLink(
 }
 
 /** Small status badge. Prefer `ui.badge`. See {@link BadgeProps}. */
-export function badge(text?: string, props?: Omit<BadgeProps, 'text'>): Element {
-  return badgeFactory(text, props);
+export function badge(
+  text?: string | (() => string) | BadgeProps,
+  props?: Omit<BadgeProps, 'text'>,
+): Element {
+  return badgeFactory(text as Parameters<typeof badgeFactory>[0], props);
 }
 
 /**
@@ -766,6 +828,19 @@ export function icon(name: string, props?: Omit<IconProps, 'name'>): Element {
   return iconFactory(name, props);
 }
 
+/** Inline icon + text (replaces manual `ui.row` + `ui.icon` + `ui.label`). See {@link IconTextProps}. */
+export function iconText(
+  text?: string | (() => string),
+  props?: Omit<IconTextProps, 'text'>,
+): Element {
+  return iconTextFactory(text, props);
+}
+
+/** Status dot (or icon) + label for feeds and tables. See {@link StatusDotProps}. */
+export function statusDot(props?: StatusDotProps): Element {
+  return statusDotFactory(props);
+}
+
 /** Render markdown to HTML. Prefer `ui.markdown`. See {@link MarkdownProps}. */
 export function markdown(text?: string, props?: MarkdownProps): Element {
   return markdownFactory(text, props);
@@ -945,6 +1020,11 @@ export function composedChart(props: ComposedChartProps): Element {
   return composedChartFactory(props);
 }
 
+/** KPI card with inline sparkline. Prefer `ui.sparkline`. See {@link SparklineProps}. */
+export function sparkline(props: SparklineProps): Element {
+  return sparklineFactory(props);
+}
+
 /** Horizontal flex row (`fn` or props-first). Prefer `ui.row`. */
 export function row(fn: () => void, props?: Parameters<typeof rowFactory>[1]): Element;
 export function row(props: Parameters<typeof rowFactory>[0], fn: () => void): Element;
@@ -1497,6 +1577,9 @@ export const ui = {
   radioGroup,
   combobox,
   date,
+  dateRange,
+  timeline,
+  stepper,
   tooltip,
   avatar,
   skeleton,
@@ -1543,6 +1626,7 @@ export const ui = {
   radialChart,
   scatterChart,
   composedChart,
+  sparkline,
   row,
   column,
   container,

package/src/pages.ts

@@ -1,10 +1,12 @@
 import { fileURLToPath, pathToFileURL } from 'url';
 import { join } from 'path';
+import { readFile } from 'fs/promises';
 import {
   clearPages,
   getRegisteredPaths,
   type PageFn,
 } from '@close-by/clay-core';
+import { warnClayPageIssues } from '@close-by/clay-compiler';
 import type { AppNavItem } from '@close-by/clay-components';
 
 /**
@@ -26,6 +28,15 @@ export async function importFresh(absPath: string): Promise<unknown> {
   return import(href);
 }
 
+async function warnPageModuleIfNeeded(absPath: string): Promise<void> {
+  try {
+    const text = await readFile(absPath, 'utf8');
+    warnClayPageIssues(text, absPath);
+  } catch {
+    // unreadable — import will surface the error
+  }
+}
+
 /**
  * Optional metadata for a registered page — used by `navFromPages` / `loadPages`.
  * Export as `pageMeta` from a page module, or pass via `attachPageMeta`.
@@ -108,6 +119,7 @@ export async function loadPages(dir: string | URL): Promise<string[]> {
   for (const relative of files) {
     const fullPath = join(absDir, relative);
     const pathsBefore = new Set(getRegisteredPaths());
+    await warnPageModuleIfNeeded(fullPath);
     const mod = (await importFresh(fullPath)) as { pageMeta?: PageMeta };
     const added = getRegisteredPaths().filter((p) => !pathsBefore.has(p));
     if (added.length === 1 && mod.pageMeta) {