@signalflare-ai/ui 0.5.0 → 1.0.0

package/dist/src/blocks/dashboard-grid/dashboard-grid.d.ts

@@ -0,0 +1,48 @@
+import { HTMLAttributes, ReactNode } from 'react';
+/** Column span within a 12-column `DashboardGrid`. */
+export type DashboardCellSpan = 2 | 3 | 4 | 6 | 8 | 12;
+/** Props for `DashboardGrid`. */
+export interface DashboardGridProps extends HTMLAttributes<HTMLDivElement> {
+    /** Children cells / rows. */
+    children?: ReactNode;
+    /** Additional CSS classes merged via `cn()`. */
+    className?: string;
+}
+/**
+ * DashboardGrid — opinionated 12-column responsive grid for composing BI
+ * dashboards from KPI cards, charts, and tables.
+ *
+ * Cells stack to a single column below `md` and fall into 12-column slots
+ * at `md` and above.
+ *
+ * @example
+ * ```tsx
+ * <DashboardGrid>
+ *   <DashboardGrid.Cell span={3}><StatCard ... /></DashboardGrid.Cell>
+ *   <DashboardGrid.Cell span={3}><StatCard ... /></DashboardGrid.Cell>
+ *   <DashboardGrid.Cell span={6}><TimeseriesChart ... /></DashboardGrid.Cell>
+ * </DashboardGrid>
+ * ```
+ */
+export declare function DashboardGrid({ children, className, ...props }: DashboardGridProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace DashboardGrid {
+    var Row: ({ children, className, ...props }: DashboardGridRowProps) => import("react/jsx-runtime").JSX.Element;
+    var Cell: ({ span, children, className, ...props }: DashboardGridCellProps) => import("react/jsx-runtime").JSX.Element;
+}
+/** Props for `DashboardGrid.Row`. */
+export interface DashboardGridRowProps extends HTMLAttributes<HTMLDivElement> {
+    /** Row children (cells). */
+    children?: ReactNode;
+    /** Additional CSS classes merged via `cn()`. */
+    className?: string;
+}
+/** Props for `DashboardGrid.Cell`. */
+export interface DashboardGridCellProps extends HTMLAttributes<HTMLDivElement> {
+    /** Number of 12-column columns this cell spans at `md` and up. */
+    span?: DashboardCellSpan;
+    /** Cell content. */
+    children?: ReactNode;
+    /** Additional CSS classes merged via `cn()`. */
+    className?: string;
+}
+//# sourceMappingURL=dashboard-grid.d.ts.map

package/dist/src/blocks/dashboard-grid/dashboard-grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-grid.d.ts","sourceRoot":"","sources":["../../../../src/blocks/dashboard-grid/dashboard-grid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvD,sDAAsD;AACtD,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;AAWvD,iCAAiC;AACjC,MAAM,WAAW,kBAAmB,SAAQ,cAAc,CAAC,cAAc,CAAC;IACxE,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,SAAS,EACT,GAAG,KAAK,EACT,EAAE,kBAAkB,2CAYpB;yBAhBe,aAAa;iDA+BmB,qBAAqB;wDA6BlE,sBAAsB;;AA1CzB,qCAAqC;AACrC,MAAM,WAAW,qBAAsB,SAAQ,cAAc,CAAC,cAAc,CAAC;IAC3E,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAqBD,sCAAsC;AACtC,MAAM,WAAW,sBAAuB,SAAQ,cAAc,CAAC,cAAc,CAAC;IAC5E,kEAAkE;IAClE,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/src/blocks/dashboard-grid/dashboard-grid.stories.tsx

@@ -0,0 +1,19 @@
+import type { Meta, StoryObj } from "@storybook/react";
+
+import { DashboardGridDemo as Demo_DashboardGridDemo } from "../../../../docs/src/components/demos/DashboardGridDemo";
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const meta: Meta<any> = {
+  title: "Blocks/DashboardGrid",
+  parameters: {
+    layout: "padded",
+  },
+};
+
+export default meta;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type Story = StoryObj<any>;
+
+export const Default: Story = {
+  render: () => <Demo_DashboardGridDemo />,
+};

package/dist/src/blocks/dashboard-grid/dashboard-grid.tsx

@@ -0,0 +1,110 @@
+import type { HTMLAttributes, ReactNode } from "react";
+
+import { cn } from "../../utils/cn";
+
+/** Column span within a 12-column `DashboardGrid`. */
+export type DashboardCellSpan = 2 | 3 | 4 | 6 | 8 | 12;
+
+const SPAN_CLASSES: Record<DashboardCellSpan, string> = {
+  2: "md:col-span-2",
+  3: "md:col-span-3",
+  4: "md:col-span-4",
+  6: "md:col-span-6",
+  8: "md:col-span-8",
+  12: "md:col-span-12",
+};
+
+/** Props for `DashboardGrid`. */
+export interface DashboardGridProps extends HTMLAttributes<HTMLDivElement> {
+  /** Children cells / rows. */
+  children?: ReactNode;
+  /** Additional CSS classes merged via `cn()`. */
+  className?: string;
+}
+
+/**
+ * DashboardGrid — opinionated 12-column responsive grid for composing BI
+ * dashboards from KPI cards, charts, and tables.
+ *
+ * Cells stack to a single column below `md` and fall into 12-column slots
+ * at `md` and above.
+ *
+ * @example
+ * ```tsx
+ * <DashboardGrid>
+ *   <DashboardGrid.Cell span={3}><StatCard ... /></DashboardGrid.Cell>
+ *   <DashboardGrid.Cell span={3}><StatCard ... /></DashboardGrid.Cell>
+ *   <DashboardGrid.Cell span={6}><TimeseriesChart ... /></DashboardGrid.Cell>
+ * </DashboardGrid>
+ * ```
+ */
+export function DashboardGrid({
+  children,
+  className,
+  ...props
+}: DashboardGridProps) {
+  return (
+    <div
+      {...props}
+      className={cn(
+        "grid grid-cols-1 gap-4 md:grid-cols-12 md:gap-6",
+        className
+      )}
+    >
+      {children}
+    </div>
+  );
+}
+
+/** Props for `DashboardGrid.Row`. */
+export interface DashboardGridRowProps extends HTMLAttributes<HTMLDivElement> {
+  /** Row children (cells). */
+  children?: ReactNode;
+  /** Additional CSS classes merged via `cn()`. */
+  className?: string;
+}
+
+/**
+ * Row — optional wrapper that breaks its children onto a new grid row by
+ * spanning all 12 columns and re-creating an inner 12-col grid. Useful when
+ * you want to force a visual row boundary.
+ */
+function Row({ children, className, ...props }: DashboardGridRowProps) {
+  return (
+    <div
+      {...props}
+      className={cn(
+        "col-span-1 grid grid-cols-1 gap-4 md:col-span-12 md:grid-cols-12 md:gap-6",
+        className
+      )}
+    >
+      {children}
+    </div>
+  );
+}
+
+/** Props for `DashboardGrid.Cell`. */
+export interface DashboardGridCellProps extends HTMLAttributes<HTMLDivElement> {
+  /** Number of 12-column columns this cell spans at `md` and up. */
+  span?: DashboardCellSpan;
+  /** Cell content. */
+  children?: ReactNode;
+  /** Additional CSS classes merged via `cn()`. */
+  className?: string;
+}
+
+function Cell({
+  span = 4,
+  children,
+  className,
+  ...props
+}: DashboardGridCellProps) {
+  return (
+    <div {...props} className={cn("col-span-1", SPAN_CLASSES[span], className)}>
+      {children}
+    </div>
+  );
+}
+
+DashboardGrid.Row = Row;
+DashboardGrid.Cell = Cell;

package/dist/src/blocks/dashboard-grid/index.d.ts

@@ -0,0 +1,2 @@
+export { DashboardGrid, type DashboardGridProps, type DashboardGridRowProps, type DashboardGridCellProps, type DashboardCellSpan, } from './dashboard-grid';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/blocks/dashboard-grid/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/blocks/dashboard-grid/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC"}

package/dist/src/blocks/delete-resource/delete-resource.stories.tsx

@@ -0,0 +1,31 @@
+import type { Meta, StoryObj } from "@storybook/react";
+
+import {
+  DeleteResourceBasicDemo as Demo_DeleteResourceBasicDemo,
+  DeleteResourceWorkerDemo as Demo_DeleteResourceWorkerDemo,
+  DeleteResourceErrorDemo as Demo_DeleteResourceErrorDemo,
+} from "../../../../docs/src/components/demos/DeleteResourceDemo";
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const meta: Meta<any> = {
+  title: "Blocks/DeleteResource",
+  parameters: {
+    layout: "padded",
+  },
+};
+
+export default meta;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type Story = StoryObj<any>;
+
+export const Basic: Story = {
+  render: () => <Demo_DeleteResourceBasicDemo />,
+};
+
+export const Worker: Story = {
+  render: () => <Demo_DeleteResourceWorkerDemo />,
+};
+
+export const Error: Story = {
+  render: () => <Demo_DeleteResourceErrorDemo />,
+};

package/dist/src/blocks/map-block/map-block.stories.tsx

@@ -0,0 +1,41 @@
+import type { Meta, StoryObj } from "@storybook/react";
+
+import {
+  MapBasicDemo as Demo_MapBasicDemo,
+  MapLegendDemo as Demo_MapLegendDemo,
+  MapH3Demo as Demo_MapH3Demo,
+  MapFiltersDemo as Demo_MapFiltersDemo,
+  MapClickDemo as Demo_MapClickDemo,
+} from "../../../../docs/src/components/demos/MapBlockDemo";
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const meta: Meta<any> = {
+  title: "Blocks/MapBlock",
+  parameters: {
+    layout: "padded",
+  },
+};
+
+export default meta;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type Story = StoryObj<any>;
+
+export const MapBasic: Story = {
+  render: () => <Demo_MapBasicDemo />,
+};
+
+export const MapLegend: Story = {
+  render: () => <Demo_MapLegendDemo />,
+};
+
+export const MapH3: Story = {
+  render: () => <Demo_MapH3Demo />,
+};
+
+export const MapFilters: Story = {
+  render: () => <Demo_MapFiltersDemo />,
+};
+
+export const MapClick: Story = {
+  render: () => <Demo_MapClickDemo />,
+};

package/dist/src/blocks/metrics-overview/index.d.ts

@@ -0,0 +1,2 @@
+export { MetricsOverview, type MetricsOverviewProps, type MetricsOverviewKpi, } from './metrics-overview';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/blocks/metrics-overview/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/blocks/metrics-overview/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,GACxB,MAAM,oBAAoB,CAAC"}

package/dist/src/blocks/metrics-overview/metrics-overview.d.ts

@@ -0,0 +1,67 @@
+import { ReactNode } from 'react';
+import { StatCardDelta } from '../../components/stat-card';
+import { DashboardCellSpan } from '../dashboard-grid/dashboard-grid';
+/** A single KPI tile displayed in the overview strip. */
+export interface MetricsOverviewKpi {
+    /** Stable key for React list rendering. */
+    id: string;
+    /** KPI label (e.g. `"Active users"`). */
+    label: ReactNode;
+    /** Primary value (pre-formatted). */
+    value: ReactNode;
+    /** Optional delta indicator. */
+    delta?: StatCardDelta;
+    /** Optional secondary hint shown beneath the value. */
+    hint?: ReactNode;
+    /** Optional trend slot — typically a `<Sparkline />`. */
+    trend?: ReactNode;
+    /**
+     * Column span at `md` breakpoint and above within the internal 12-col grid.
+     * Defaults to an even split based on the number of KPIs.
+     */
+    span?: DashboardCellSpan;
+}
+/** Props for `MetricsOverview`. */
+export interface MetricsOverviewProps {
+    /** Heading rendered in the top-left of the header row. */
+    title?: ReactNode;
+    /** Optional description or subtitle shown under the title. */
+    description?: ReactNode;
+    /** Right-aligned slot for timeframe toggles, filters, or actions. */
+    actions?: ReactNode;
+    /** KPI tiles displayed in the strip under the header. */
+    kpis: MetricsOverviewKpi[];
+    /**
+     * Primary chart slot. Typically a `<TimeseriesChart />` or `<BarChart />`
+     * configured by the consumer.
+     */
+    chart?: ReactNode;
+    /** When `true`, renders skeleton placeholders on KPI tiles. */
+    loading?: boolean;
+    /**
+     * When `kpis` is empty and no chart is provided, this node is rendered in
+     * place of the overview.
+     */
+    emptyState?: ReactNode;
+    /** Additional CSS classes merged via `cn()`. */
+    className?: string;
+}
+/**
+ * MetricsOverview — composed block that assembles a dashboard header, a strip
+ * of KPI tiles, and a primary chart area into one reusable layout.
+ *
+ * @example
+ * ```tsx
+ * <MetricsOverview
+ *   title="Revenue overview"
+ *   actions={<TimeframeToggle ... />}
+ *   kpis={[
+ *     { id: "mrr", label: "MRR", value: "$128,420", delta: { value: 0.12, label: "vs last month" } },
+ *     { id: "arpu", label: "ARPU", value: "$42.10" },
+ *   ]}
+ *   chart={<TimeseriesChart echarts={echarts} data={series} />}
+ * />
+ * ```
+ */
+export declare function MetricsOverview({ title, description, actions, kpis, chart, loading, emptyState, className, }: MetricsOverviewProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=metrics-overview.d.ts.map

package/dist/src/blocks/metrics-overview/metrics-overview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-overview.d.ts","sourceRoot":"","sources":["../../../../src/blocks/metrics-overview/metrics-overview.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE1E,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,kCAAkC,CAAC;AAE1C,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,KAAK,EAAE,SAAS,CAAC;IACjB,qCAAqC;IACrC,KAAK,EAAE,SAAS,CAAC;IACjB,gCAAgC;IAChC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,uDAAuD;IACvD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,yDAAyD;IACzD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AAED,mCAAmC;AACnC,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,qEAAqE;IACrE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,yDAAyD;IACzD,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC3B;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AASD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,WAAW,EACX,OAAO,EACP,IAAI,EACJ,KAAK,EACL,OAAO,EACP,UAAU,EACV,SAAS,GACV,EAAE,oBAAoB,2CAiDtB"}

package/dist/src/blocks/metrics-overview/metrics-overview.stories.tsx

@@ -0,0 +1,26 @@
+import type { Meta, StoryObj } from "@storybook/react";
+
+import {
+  MetricsOverviewDemo as Demo_MetricsOverviewDemo,
+  MetricsOverviewLoadingDemo as Demo_MetricsOverviewLoadingDemo,
+} from "../../../../docs/src/components/demos/MetricsOverviewDemo";
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const meta: Meta<any> = {
+  title: "Blocks/MetricsOverview",
+  parameters: {
+    layout: "padded",
+  },
+};
+
+export default meta;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type Story = StoryObj<any>;
+
+export const Default: Story = {
+  render: () => <Demo_MetricsOverviewDemo />,
+};
+
+export const Loading: Story = {
+  render: () => <Demo_MetricsOverviewLoadingDemo />,
+};

package/dist/src/blocks/metrics-overview/metrics-overview.tsx

@@ -0,0 +1,139 @@
+import type { ReactNode } from "react";
+
+import { StatCard, type StatCardDelta } from "../../components/stat-card";
+import { cn } from "../../utils/cn";
+import {
+  DashboardGrid,
+  type DashboardCellSpan,
+} from "../dashboard-grid/dashboard-grid";
+
+/** A single KPI tile displayed in the overview strip. */
+export interface MetricsOverviewKpi {
+  /** Stable key for React list rendering. */
+  id: string;
+  /** KPI label (e.g. `"Active users"`). */
+  label: ReactNode;
+  /** Primary value (pre-formatted). */
+  value: ReactNode;
+  /** Optional delta indicator. */
+  delta?: StatCardDelta;
+  /** Optional secondary hint shown beneath the value. */
+  hint?: ReactNode;
+  /** Optional trend slot — typically a `<Sparkline />`. */
+  trend?: ReactNode;
+  /**
+   * Column span at `md` breakpoint and above within the internal 12-col grid.
+   * Defaults to an even split based on the number of KPIs.
+   */
+  span?: DashboardCellSpan;
+}
+
+/** Props for `MetricsOverview`. */
+export interface MetricsOverviewProps {
+  /** Heading rendered in the top-left of the header row. */
+  title?: ReactNode;
+  /** Optional description or subtitle shown under the title. */
+  description?: ReactNode;
+  /** Right-aligned slot for timeframe toggles, filters, or actions. */
+  actions?: ReactNode;
+  /** KPI tiles displayed in the strip under the header. */
+  kpis: MetricsOverviewKpi[];
+  /**
+   * Primary chart slot. Typically a `<TimeseriesChart />` or `<BarChart />`
+   * configured by the consumer.
+   */
+  chart?: ReactNode;
+  /** When `true`, renders skeleton placeholders on KPI tiles. */
+  loading?: boolean;
+  /**
+   * When `kpis` is empty and no chart is provided, this node is rendered in
+   * place of the overview.
+   */
+  emptyState?: ReactNode;
+  /** Additional CSS classes merged via `cn()`. */
+  className?: string;
+}
+
+function inferSpan(kpiCount: number): DashboardCellSpan {
+  if (kpiCount <= 1) return 12;
+  if (kpiCount === 2) return 6;
+  if (kpiCount === 3) return 4;
+  return 3;
+}
+
+/**
+ * MetricsOverview — composed block that assembles a dashboard header, a strip
+ * of KPI tiles, and a primary chart area into one reusable layout.
+ *
+ * @example
+ * ```tsx
+ * <MetricsOverview
+ *   title="Revenue overview"
+ *   actions={<TimeframeToggle ... />}
+ *   kpis={[
+ *     { id: "mrr", label: "MRR", value: "$128,420", delta: { value: 0.12, label: "vs last month" } },
+ *     { id: "arpu", label: "ARPU", value: "$42.10" },
+ *   ]}
+ *   chart={<TimeseriesChart echarts={echarts} data={series} />}
+ * />
+ * ```
+ */
+export function MetricsOverview({
+  title,
+  description,
+  actions,
+  kpis,
+  chart,
+  loading,
+  emptyState,
+  className,
+}: MetricsOverviewProps) {
+  const hasContent = kpis.length > 0 || chart !== undefined;
+
+  if (!hasContent && emptyState !== undefined) {
+    return <div className={className}>{emptyState}</div>;
+  }
+
+  const defaultSpan = inferSpan(kpis.length);
+
+  return (
+    <section className={cn("flex flex-col gap-4", className)}>
+      {(title || description || actions) && (
+        <header className="flex flex-wrap items-start justify-between gap-3">
+          <div className="flex flex-col gap-1">
+            {title ? (
+              <h2 className="text-lg font-semibold text-sf-strong">{title}</h2>
+            ) : null}
+            {description ? (
+              <p className="text-sm text-sf-subtle">{description}</p>
+            ) : null}
+          </div>
+          {actions ? (
+            <div className="flex shrink-0 items-center gap-2">{actions}</div>
+          ) : null}
+        </header>
+      )}
+
+      {kpis.length > 0 ? (
+        <DashboardGrid>
+          {kpis.map((kpi) => (
+            <DashboardGrid.Cell key={kpi.id} span={kpi.span ?? defaultSpan}>
+              <StatCard
+                label={kpi.label}
+                value={kpi.value}
+                delta={kpi.delta}
+                hint={kpi.hint}
+                trend={kpi.trend}
+                loading={loading}
+              />
+            </DashboardGrid.Cell>
+          ))}
+        </DashboardGrid>
+      ) : null}
+
+      {chart ? (
+        <div className="rounded-lg bg-sf-elevated p-4">{chart}</div>
+      ) : null}
+    </section>
+  );
+}

package/dist/src/blocks/page-header/page-header.stories.tsx

@@ -0,0 +1,56 @@
+import type { Meta, StoryObj } from "@storybook/react";
+
+import {
+  PageHeaderHeroDemo as Demo_PageHeaderHeroDemo,
+  PageHeaderBasicDemo as Demo_PageHeaderBasicDemo,
+  PageHeaderWithIconsDemo as Demo_PageHeaderWithIconsDemo,
+  PageHeaderWithTabsDemo as Demo_PageHeaderWithTabsDemo,
+  PageHeaderWithActionsDemo as Demo_PageHeaderWithActionsDemo,
+  PageHeaderWithTitleDemo as Demo_PageHeaderWithTitleDemo,
+  PageHeaderWithTitleDescriptionDemo as Demo_PageHeaderWithTitleDescriptionDemo,
+  PageHeaderCompleteDemo as Demo_PageHeaderCompleteDemo,
+} from "../../../../docs/src/components/demos/PageHeaderDemo";
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const meta: Meta<any> = {
+  title: "Blocks/PageHeader",
+  parameters: {
+    layout: "padded",
+  },
+};
+
+export default meta;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type Story = StoryObj<any>;
+
+export const Hero: Story = {
+  render: () => <Demo_PageHeaderHeroDemo />,
+};
+
+export const Basic: Story = {
+  render: () => <Demo_PageHeaderBasicDemo />,
+};
+
+export const WithIcons: Story = {
+  render: () => <Demo_PageHeaderWithIconsDemo />,
+};
+
+export const WithTabs: Story = {
+  render: () => <Demo_PageHeaderWithTabsDemo />,
+};
+
+export const WithActions: Story = {
+  render: () => <Demo_PageHeaderWithActionsDemo />,
+};
+
+export const WithTitle: Story = {
+  render: () => <Demo_PageHeaderWithTitleDemo />,
+};
+
+export const WithTitleDescription: Story = {
+  render: () => <Demo_PageHeaderWithTitleDescriptionDemo />,
+};
+
+export const Complete: Story = {
+  render: () => <Demo_PageHeaderCompleteDemo />,
+};

package/dist/src/blocks/resource-list/resource-list.stories.tsx

@@ -0,0 +1,31 @@
+import type { Meta, StoryObj } from "@storybook/react";
+
+import {
+  ResourceListBasicDemo as Demo_ResourceListBasicDemo,
+  ResourceListWithUsageDemo as Demo_ResourceListWithUsageDemo,
+  ResourceListCompleteDemo as Demo_ResourceListCompleteDemo,
+} from "../../../../docs/src/components/demos/ResourceListDemo";
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const meta: Meta<any> = {
+  title: "Blocks/ResourceList",
+  parameters: {
+    layout: "padded",
+  },
+};
+
+export default meta;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type Story = StoryObj<any>;
+
+export const Basic: Story = {
+  render: () => <Demo_ResourceListBasicDemo />,
+};
+
+export const WithUsage: Story = {
+  render: () => <Demo_ResourceListWithUsageDemo />,
+};
+
+export const Complete: Story = {
+  render: () => <Demo_ResourceListCompleteDemo />,
+};

package/dist/src/catalog/catalog.d.ts

@@ -39,7 +39,7 @@ interface SchemasModule {
  */
 export declare function loadSchemas(): Promise<SchemasModule>;
 /**
- * Create a SF catalog for runtime validation.
+ * Create a SignalFlare catalog for runtime validation.
  *
  * The catalog:
  * - Uses auto-generated Zod schemas from component-registry.json

package/dist/src/catalog/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * SF Catalog Module — json-render integration
+ * SignalFlare Catalog Module — json-render integration
  *
  * Provides SignalFlare AI component definitions and renderers for use with
  * the json-render generative UI framework.

package/dist/src/catalog/types.d.ts

@@ -1,5 +1,5 @@
 /**
- * Runtime types for SF catalog module.
+ * Runtime types for SignalFlare catalog module.
  *
  * These types extend the registry types with runtime capabilities
  * like visibility conditions, actions, and data binding.

package/dist/src/command-line/build-cli.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env bun
 /**
- * Build script for the SF CLI.
+ * Build script for the SignalFlare CLI.
  * Bundles the single public CLI entrypoint to dist/command-line/cli.js.
  */
 export {};

package/dist/src/command-line/cli.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * SF CLI - Component registry and blocks distribution
+ * SignalFlare CLI - Component registry and blocks distribution
  *
  * Usage:
  *   sf init                 Initialize sf.json configuration

package/dist/src/command-line/commands/add.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * Add a SF block to the project
+ * Add a SignalFlare block to the project
  * Usage: sf add <block-name>
  */
 /**

package/dist/src/command-line/commands/add.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../../src/command-line/commands/add.ts"],"names":[],"mappings":";AACA;;;GAGG;AAkGH;;GAEG;AACH,wBAAsB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAkJtE"}
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../../src/command-line/commands/add.ts"],"names":[],"mappings":";AACA;;;GAGG;AAiGH;;GAEG;AACH,wBAAsB,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAoJtE"}

package/dist/src/command-line/commands/ai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../../../src/command-line/commands/ai.ts"],"names":[],"mappings":";AACA;;;GAGG;AAMH;;GAEG;AACH,wBAAgB,EAAE,IAAI,IAAI,CAczB"}
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../../../src/command-line/commands/ai.ts"],"names":[],"mappings":";AACA;;;GAGG;AAKH;;GAEG;AACH,wBAAgB,EAAE,IAAI,IAAI,CAczB"}

package/dist/src/command-line/commands/blocks.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * List all SF blocks available for CLI installation
+ * List all SignalFlare blocks available for CLI installation
  * Usage: sf blocks
  */
 /**