@squadbase/vantage 0.6.1 → 0.6.2-dev1.31accb1

package/dist/components/index.d.ts

@@ -13,6 +13,13 @@ interface PageShellProps extends HTMLAttributes<HTMLDivElement> {
 declare const PageShell: React.ForwardRefExoticComponent<PageShellProps & React.RefAttributes<HTMLDivElement>>;
 interface PageShellHeaderProps extends HTMLAttributes<HTMLDivElement> {
 }
+/**
+ * A wrapping flex row, not a two-column grid: when the heading cannot keep its
+ * 20rem basis next to `PageShellHeaderEnd`, the end block drops below it. A
+ * `1fr auto` grid would instead hand the heading whatever the end block leaves,
+ * and a CJK title — breakable between any two characters — collapses into a
+ * one-character column.
+ */
 declare const PageShellHeader: React.ForwardRefExoticComponent<PageShellHeaderProps & React.RefAttributes<HTMLDivElement>>;
 interface PageShellHeadingProps extends HTMLAttributes<HTMLDivElement> {
 }
@@ -155,6 +162,23 @@ interface SelectOptionGroup {
 type SelectOptions = SelectOption[] | SelectOptionGroup[];
 declare function isGroupedOptions(options: SelectOptions): options is SelectOptionGroup[];
 declare function flattenOptions(options: SelectOptions): SelectOption[];
+/**
+ * A chart colour: one of the theme's series tokens (`"chart-1"`〜`"chart-5"`,
+ * which follow light/dark) or any CSS colour (`"#16a34a"`, `"var(--destructive)"`).
+ * Not a Tailwind class — the ECharts-based charts paint on a canvas.
+ */
+type ChartColor = "chart-1" | "chart-2" | "chart-3" | "chart-4" | "chart-5" | (string & {});
+/** Formats a value for tooltips, axes and labels (e.g. `(v) => \`¥${v.toLocaleString()}\``). */
+type ValueFormatter = (value: number) => string;
+/** What a typed chart reports through `onValueChange`; `null` when the selection is cleared. */
+type ChartEventPayload = {
+    /** What was clicked: a bar, a line/area point, or a donut slice. */
+    eventType: "bar" | "dot" | "slice";
+    /** The series (`categories` entry) or slice name that was clicked. */
+    categoryClicked: string;
+    /** The clicked row of `data`, spread in. */
+    [key: string]: unknown;
+} | null;
 
 interface AppShellSidebarProps {
     variant?: "sidebar";
@@ -278,6 +302,204 @@ interface EChartProps {
 }
 declare const EChart: React.ForwardRefExoticComponent<EChartProps & React.RefAttributes<HTMLDivElement>>;
 
+type CartesianStackType = "default" | "stacked" | "percent";
+type CartesianCurveType = "linear" | "smooth" | "step";
+type AreaFill = "gradient" | "solid" | "none";
+type BarLayout = "horizontal" | "vertical";
+/** Props every cartesian typed chart (Area / Bar / Line) shares. */
+interface CartesianChartBaseProps {
+    /** 行の配列。1 行 = x 軸の 1 点。数値の列は number か数値文字列(SQL の DECIMAL など)。 */
+    data: Record<string, unknown>[];
+    /** x 軸(カテゴリ軸)に使う列名。 */
+    index: string;
+    /** 系列として描く列名。並び順が凡例と配色の順になる。 */
+    categories: string[];
+    /** 系列色。`"chart-1"`〜`"chart-5"` か CSS カラー。省略時はテーマのトークン順。足りなければ繰り返す。 */
+    colors?: ChartColor[];
+    /** 軸目盛りとツールチップの数値の書式。 */
+    valueFormatter?: ValueFormatter;
+    /** 凡例を出す。既定 `true`。 */
+    showLegend?: boolean;
+    /** ホバー時のツールチップを出す。既定 `true`。 */
+    showTooltip?: boolean;
+    /** 値軸の目盛り線を出す。既定 `true`。 */
+    showGridLines?: boolean;
+    showXAxis?: boolean;
+    showYAxis?: boolean;
+    /** x 軸のラベルを最初と最後だけにする。 */
+    startEndOnly?: boolean;
+    /** y 軸ラベルの幅(px)。並べた複数グラフのプロット領域を揃えたいときに固定する。 */
+    yAxisWidth?: number;
+    minValue?: number;
+    maxValue?: number;
+    /** 値軸を 0 からではなくデータの範囲に合わせる。 */
+    autoMinValue?: boolean;
+    /** `false` で値軸の目盛りを整数に限る。 */
+    allowDecimals?: boolean;
+    xAxisLabel?: string;
+    yAxisLabel?: string;
+    /**
+     * 点(棒)のクリックで呼ばれる。クリックした行に `eventType` / `categoryClicked` を
+     * 足して渡し、同じ点をもう一度クリックすると `null`。渡すと選択以外が薄くなる。
+     */
+    onValueChange?: (value: ChartEventPayload) => void;
+    /** 高さ。数値は px。省略時は `h-80`(320px)で、`className` の高さクラスが勝つ。 */
+    height?: string | number;
+    loading?: boolean;
+    ariaLabel?: string;
+    className?: string;
+}
+type DonutVariant = "donut" | "pie";
+
+interface AreaChartProps extends CartesianChartBaseProps {
+    /** `"stacked"` は積み上げ、`"percent"` は各点の合計を 100% にした積み上げ。既定 `"default"`。 */
+    type?: CartesianStackType;
+    /** 線の形。既定 `"linear"`。 */
+    curveType?: CartesianCurveType;
+    /** 面の塗り。既定 `"gradient"`。 */
+    fill?: AreaFill;
+    /** 値の欠けた点(`null` など)をまたいで線をつなぐ。既定 `false`。 */
+    connectNulls?: boolean;
+}
+declare const AreaChart: React.ForwardRefExoticComponent<AreaChartProps & React.RefAttributes<HTMLDivElement>>;
+
+interface BarChartProps extends CartesianChartBaseProps {
+    /** `"stacked"` は積み上げ、`"percent"` は各カテゴリの合計を 100% にした積み上げ。既定 `"default"`(横並び)。 */
+    type?: CartesianStackType;
+    /**
+     * 棒の向き。既定 `"horizontal"`(カテゴリが横に並ぶ縦棒)。`"vertical"` はカテゴリを
+     * 縦に並べた横棒で、ラベルの長いランキングに向く(先頭の行が一番上)。
+     */
+    layout?: BarLayout;
+    /** カテゴリ間の隙間(`"20%"` や px)。省略時は ECharts の既定。 */
+    barCategoryGap?: string | number;
+}
+declare const BarChart: React.ForwardRefExoticComponent<BarChartProps & React.RefAttributes<HTMLDivElement>>;
+
+interface LineChartProps extends CartesianChartBaseProps {
+    /** 線の形。既定 `"linear"`。 */
+    curveType?: CartesianCurveType;
+    /** 値の欠けた点(`null` など)をまたいで線をつなぐ。既定 `false`。 */
+    connectNulls?: boolean;
+}
+declare const LineChart: React.ForwardRefExoticComponent<LineChartProps & React.RefAttributes<HTMLDivElement>>;
+
+interface DonutChartProps {
+    /** 行の配列。1 行 = 1 切片。 */
+    data: Record<string, unknown>[];
+    /** 切片の名前に使う列名。 */
+    category: string;
+    /** 切片の大きさに使う列名(number か数値文字列)。0 以下と欠損は 0 扱い。 */
+    value: string;
+    /** 切片の色(行の順)。`"chart-1"`〜`"chart-5"` か CSS カラー。省略時はトークン順で、足りなければ繰り返す。 */
+    colors?: ChartColor[];
+    /** `"donut"`(中央に穴とラベル)か `"pie"`。既定 `"donut"`。 */
+    variant?: DonutVariant;
+    /** ツールチップと中央ラベルの数値の書式。 */
+    valueFormatter?: ValueFormatter;
+    /** 中央ラベル。省略時は合計を `valueFormatter` で書いたもの。donut のみ。 */
+    label?: ReactNode;
+    /** 中央ラベルを出す。既定 `true`(donut のみ)。 */
+    showLabel?: boolean;
+    showTooltip?: boolean;
+    /** 切片のクリックで呼ばれる。同じ切片をもう一度クリックすると `null`。渡すと選択以外が薄くなる。 */
+    onValueChange?: (value: ChartEventPayload) => void;
+    loading?: boolean;
+    ariaLabel?: string;
+    /** 外枠のクラス。既定の大きさは `size-40`(160px 四方)。 */
+    className?: string;
+}
+declare const DonutChart: React.ForwardRefExoticComponent<DonutChartProps & React.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Chart helpers shared by the typed charts — colour tokens, number handling and
+ * the layout maths of the Tailwind/SVG charts (BarList, CategoryBar,
+ * ProgressCircle, Tracker). Pure and DOM-free, so it can be unit-tested; kept
+ * internal and inlined into each `vantage add ui` copy.
+ */
+
+type BarListSortOrder = "ascending" | "descending" | "none";
+
+interface BarListItem {
+    /** React の key。省略時は `name`。 */
+    key?: string;
+    /** 行のラベル(バーの上に出る)。 */
+    name: string;
+    value: number;
+    /** 渡すとラベルがリンクになる。 */
+    href?: string;
+    /** この行だけ色を変える。省略時は `color`。 */
+    color?: ChartColor;
+}
+interface BarListProps extends Omit<ComponentProps<"div">, "children"> {
+    data: BarListItem[];
+    /** 右端の数値の書式。 */
+    valueFormatter?: ValueFormatter;
+    /** 並べ順。既定 `"descending"`(大きい順)。`"none"` は渡した順。 */
+    sortOrder?: BarListSortOrder;
+    /** バーの色。`"chart-1"`〜`"chart-5"` か CSS カラー。既定 `"chart-1"`(淡く塗る)。 */
+    color?: ChartColor;
+    /** マウント時にバーを伸ばす。 */
+    showAnimation?: boolean;
+    /** 渡すと行がボタンになり、クリックした行を受け取る。 */
+    onValueChange?: (item: BarListItem) => void;
+}
+declare const BarList: React.ForwardRefExoticComponent<Omit<BarListProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+
+interface CategoryBarMarker {
+    /** マーカーの位置(`values` の合計と同じ尺度)。 */
+    value: number;
+    /** ホバーで出す説明。 */
+    tooltip?: string;
+    /** 位置の変化をアニメーションする。 */
+    showAnimation?: boolean;
+}
+interface CategoryBarProps extends Omit<ComponentProps<"div">, "children"> {
+    /** 各区間の幅(相対値)。合計が 100 である必要はない。負の値は 0 扱い。 */
+    values: number[];
+    /** 区間の色(順に対応)。`"chart-1"`〜`"chart-5"` か CSS カラー。省略時はトークン順。 */
+    colors?: ChartColor[];
+    marker?: CategoryBarMarker;
+    /** バーの上に区切りの累計値を出す。既定 `true`。 */
+    showLabels?: boolean;
+    /** 区切りの数値の書式。 */
+    valueFormatter?: ValueFormatter;
+}
+declare const CategoryBar: React.ForwardRefExoticComponent<Omit<CategoryBarProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+
+interface ProgressCircleProps extends ComponentProps<"div"> {
+    /** 現在値。`0`〜`max` に丸める。 */
+    value?: number;
+    /** 満タンの値。既定 `100`。 */
+    max?: number;
+    /** 外側の半径(px)。既定 `32`(64px 四方)。 */
+    radius?: number;
+    /** 線の太さ(px)。既定 `6`。 */
+    strokeWidth?: number;
+    /** 色。`"chart-1"`〜`"chart-5"` か CSS カラー。既定 `"chart-1"`。地のリングは同じ色を淡くしたもの。 */
+    color?: ChartColor;
+    /** マウント時と値の変化をアニメーションする。既定 `true`。 */
+    showAnimation?: boolean;
+}
+declare const ProgressCircle: React.ForwardRefExoticComponent<Omit<ProgressCircleProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+
+interface TrackerBlock {
+    /** React の key。省略時は位置。 */
+    key?: string | number;
+    /** ブロックの色。`"chart-1"`〜`"chart-5"` か CSS カラー(`"var(--destructive)"` など)。省略時は `defaultColor`。 */
+    color?: ChartColor;
+    /** ホバーで出す説明(例: `"10/12 稼働率 99.2%"`)。 */
+    tooltip?: string;
+}
+interface TrackerProps extends Omit<ComponentProps<"div">, "children"> {
+    data: TrackerBlock[];
+    /** `color` の無いブロックの色。既定は muted-foreground を淡くした灰色。 */
+    defaultColor?: ChartColor;
+    /** ホバー中のブロックを薄くする。既定 `true`。 */
+    hoverEffect?: boolean;
+}
+declare const Tracker: React.ForwardRefExoticComponent<Omit<TrackerProps, "ref"> & React.RefAttributes<HTMLDivElement>>;
+
 interface FunnelStep {
     /** ステップのラベル(例: "ページビュー") */
     label: string;
@@ -578,4 +800,4 @@ interface PlaceholderProps extends HTMLAttributes<HTMLSpanElement> {
 }
 declare const Placeholder: React.ForwardRefExoticComponent<PlaceholderProps & React.RefAttributes<HTMLSpanElement>>;
 
-export { AppShell, type AppShellHeaderProps, type AppShellProps, type AppShellSidebarProps, DashboardCard, DashboardCardAction, type DashboardCardActionProps, DashboardCardContent, type DashboardCardContentProps, DashboardCardDescription, type DashboardCardDescriptionProps, DashboardCardFooter, type DashboardCardFooterProps, DashboardCardHeader, type DashboardCardHeaderProps, DashboardCardPreset, type DashboardCardPresetProps, type DashboardCardProps, DashboardCardSkeleton, type DashboardCardSkeletonProps, DashboardCardTitle, type DashboardCardTitleProps, DataTable, DataTableColumnVisibility, type DataTableColumnVisibilityProps, DataTableContent, type DataTableContentProps, DataTablePagination, type DataTablePaginationProps, DataTablePreset, type DataTablePresetProps, type DataTableProps, DataTableToolbar, type DataTableToolbarProps, type DateRange, DateRangePicker, type DateRangePickerProps, EChart, type EChartProps, FilterBar, FilterBarActiveChips, type FilterBarActiveChipsProps, FilterBarClearButton, type FilterBarClearButtonProps, FilterBarMultiSelect, type FilterBarMultiSelectProps, FilterBarPreset, type FilterBarPresetProps, type FilterBarProps, FilterBarSelect, type FilterBarSelectProps, type FilterConfig, type FilterOption, type FilterType, type FilterValues, type FunnelStep, FunnelSteps, type FunnelStepsProps, type MetricItem, MetricUnit, type MetricUnitProps, MetricValue, type MetricValueProps, type MetricVariant, MultiSelect, type MultiSelectProps, type NavGroup, type NavItem, PageShell, PageShellActions, type PageShellActionsProps, PageShellContent, type PageShellContentProps, PageShellDescription, type PageShellDescriptionProps, PageShellHeader, PageShellHeaderEnd, type PageShellHeaderEndProps, type PageShellHeaderProps, PageShellHeading, type PageShellHeadingProps, PageShellMeta, type PageShellMetaProps, type PageShellProps, PageShellSummary, PageShellSummaryCard, type PageShellSummaryCardProps, type PageShellSummaryProps, PageShellTitle, type PageShellTitleProps, Placeholder, type PlaceholderProps, type PresetItem, SearchableSelect, type SearchableSelectProps, SectionHeader, type SectionHeaderProps, type SegmentOption, SegmentedControl, type SegmentedControlProps, type SelectOption, type SelectOptionGroup, type SelectOptions, Sparkline, type SparklineDataPoint, type SparklineProps, type SparklineVariant, StatusBadge, type StatusBadgeProps, type TrendDirection, TrendIndicator, type TrendIndicatorProps, defaultPresets, flattenOptions, funnelStepsVariants, isGroupedOptions, metricValueVariants, pageShellSummaryCardVariants, useDataTable };
+export { AppShell, type AppShellHeaderProps, type AppShellProps, type AppShellSidebarProps, AreaChart, type AreaChartProps, BarChart, type BarChartProps, BarList, type BarListItem, type BarListProps, CategoryBar, type CategoryBarMarker, type CategoryBarProps, type ChartColor, type ChartEventPayload, DashboardCard, DashboardCardAction, type DashboardCardActionProps, DashboardCardContent, type DashboardCardContentProps, DashboardCardDescription, type DashboardCardDescriptionProps, DashboardCardFooter, type DashboardCardFooterProps, DashboardCardHeader, type DashboardCardHeaderProps, DashboardCardPreset, type DashboardCardPresetProps, type DashboardCardProps, DashboardCardSkeleton, type DashboardCardSkeletonProps, DashboardCardTitle, type DashboardCardTitleProps, DataTable, DataTableColumnVisibility, type DataTableColumnVisibilityProps, DataTableContent, type DataTableContentProps, DataTablePagination, type DataTablePaginationProps, DataTablePreset, type DataTablePresetProps, type DataTableProps, DataTableToolbar, type DataTableToolbarProps, type DateRange, DateRangePicker, type DateRangePickerProps, DonutChart, type DonutChartProps, EChart, type EChartProps, FilterBar, FilterBarActiveChips, type FilterBarActiveChipsProps, FilterBarClearButton, type FilterBarClearButtonProps, FilterBarMultiSelect, type FilterBarMultiSelectProps, FilterBarPreset, type FilterBarPresetProps, type FilterBarProps, FilterBarSelect, type FilterBarSelectProps, type FilterConfig, type FilterOption, type FilterType, type FilterValues, type FunnelStep, FunnelSteps, type FunnelStepsProps, LineChart, type LineChartProps, type MetricItem, MetricUnit, type MetricUnitProps, MetricValue, type MetricValueProps, type MetricVariant, MultiSelect, type MultiSelectProps, type NavGroup, type NavItem, PageShell, PageShellActions, type PageShellActionsProps, PageShellContent, type PageShellContentProps, PageShellDescription, type PageShellDescriptionProps, PageShellHeader, PageShellHeaderEnd, type PageShellHeaderEndProps, type PageShellHeaderProps, PageShellHeading, type PageShellHeadingProps, PageShellMeta, type PageShellMetaProps, type PageShellProps, PageShellSummary, PageShellSummaryCard, type PageShellSummaryCardProps, type PageShellSummaryProps, PageShellTitle, type PageShellTitleProps, Placeholder, type PlaceholderProps, type PresetItem, ProgressCircle, type ProgressCircleProps, SearchableSelect, type SearchableSelectProps, SectionHeader, type SectionHeaderProps, type SegmentOption, SegmentedControl, type SegmentedControlProps, type SelectOption, type SelectOptionGroup, type SelectOptions, Sparkline, type SparklineDataPoint, type SparklineProps, type SparklineVariant, StatusBadge, type StatusBadgeProps, Tracker, type TrackerBlock, type TrackerProps, type TrendDirection, TrendIndicator, type TrendIndicatorProps, type ValueFormatter, defaultPresets, flattenOptions, funnelStepsVariants, isGroupedOptions, metricValueVariants, pageShellSummaryCardVariants, useDataTable };

package/dist/components/index.js

@@ -1,5 +1,6 @@
-export { AppShell, DashboardCard, DashboardCardAction, DashboardCardContent, DashboardCardDescription, DashboardCardFooter, DashboardCardHeader, DashboardCardPreset, DashboardCardSkeleton, DashboardCardTitle, DataTable, DataTableColumnVisibility, DataTableContent, DataTablePagination, DataTablePreset, DataTableToolbar, DateRangePicker, EChart, FilterBar, FilterBarActiveChips, FilterBarClearButton, FilterBarMultiSelect, FilterBarPreset, FilterBarSelect, FunnelSteps, MetricUnit, MetricValue, MultiSelect, PageShell, PageShellActions, PageShellContent, PageShellDescription, PageShellHeader, PageShellHeaderEnd, PageShellHeading, PageShellMeta, PageShellSummary, PageShellSummaryCard, PageShellTitle, Placeholder, SearchableSelect, SectionHeader, SegmentedControl, Sparkline, StatusBadge, TrendIndicator, defaultPresets, flattenOptions, funnelStepsVariants, isGroupedOptions, metricValueVariants, pageShellSummaryCardVariants, useDataTable } from '../chunk-PLST5Q7T.js';
-import '../chunk-MXI3PZFT.js';
+export { AppShell, AreaChart, BarChart, BarList, CategoryBar, DashboardCard, DashboardCardAction, DashboardCardContent, DashboardCardDescription, DashboardCardFooter, DashboardCardHeader, DashboardCardPreset, DashboardCardSkeleton, DashboardCardTitle, DataTable, DataTableColumnVisibility, DataTableContent, DataTablePagination, DataTablePreset, DataTableToolbar, DateRangePicker, DonutChart, EChart, FilterBar, FilterBarActiveChips, FilterBarClearButton, FilterBarMultiSelect, FilterBarPreset, FilterBarSelect, FunnelSteps, LineChart, MetricUnit, MetricValue, MultiSelect, PageShell, PageShellActions, PageShellContent, PageShellDescription, PageShellHeader, PageShellHeaderEnd, PageShellHeading, PageShellMeta, PageShellSummary, PageShellSummaryCard, PageShellTitle, Placeholder, ProgressCircle, SearchableSelect, SectionHeader, SegmentedControl, Sparkline, StatusBadge, Tracker, TrendIndicator, defaultPresets, flattenOptions, funnelStepsVariants, isGroupedOptions, metricValueVariants, pageShellSummaryCardVariants, useDataTable } from '../chunk-AG6RZ2RR.js';
+import '../chunk-OB6UBJXF.js';
+import '../chunk-PXRX5PEC.js';
 import '../chunk-A2UUGASH.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{dev-NZRLOQCL.js → dev-GDKATCC7.js}

@@ -1,12 +1,12 @@
-import { runDiagnostics } from './chunk-BCE22JSM.js';
-import './chunk-JGRMRXXZ.js';
-import { vantagePlugin } from './chunk-T3FLAGI6.js';
-import './chunk-EP6JHXSR.js';
-import './chunk-KLEIVDUV.js';
+import { runDiagnostics } from './chunk-P7W4LR3Z.js';
+import './chunk-JKLLFVEU.js';
+import { vantagePlugin } from './chunk-VA776YE5.js';
+import './chunk-LMUACBMA.js';
+import './chunk-CEXAQQ5W.js';
 import { scanProject, timedAsync } from './chunk-ZVANIULZ.js';
 import './chunk-46QI6GFC.js';
 import './chunk-B7LLBNLV.js';
-import { printDiagnostics, log, applyApiBaseUrlFlag, resolvePortOptions, resolveHmrOverlay, reportPortInUse } from './chunk-3G43C6OL.js';
+import { printDiagnostics, log, applyApiBaseUrlFlag, resolvePortOptions, resolveHostOptions, resolveHmrOverlay, reportPortInUse } from './chunk-QI3XQKHS.js';
 import './chunk-C2CX6GLX.js';
 import { loadEnv, createServer } from 'vite';
 
@@ -28,6 +28,11 @@ async function dev(root, args) {
     return 1;
   }
   const { port, strictPort } = ports;
+  const hosts = resolveHostOptions(args.flags);
+  if (!hosts.ok) {
+    log.error(hosts.error);
+    return 1;
+  }
   const overlay = resolveHmrOverlay(args.flags);
   const server = await timedAsync(
     "vite:createServer",
@@ -38,9 +43,15 @@ async function dev(root, args) {
       // The model was just scanned for diagnostics; hand it over so the plugin
       // does not walk the project again.
       plugins: [vantagePlugin({ root, env, model })],
-      // `hmr` is left alone unless the overlay is being turned off, so Vite's
-      // own defaults (host, port, protocol) keep applying.
-      server: { port, strictPort, ...overlay ? {} : { hmr: { overlay: false } } },
+      // `host` / `allowedHosts` are only present when asked for, and `hmr` is
+      // left alone unless the overlay is being turned off, so Vite's own
+      // defaults (host, port, protocol) keep applying.
+      server: {
+        port,
+        strictPort,
+        ...hosts.options,
+        ...overlay ? {} : { hmr: { overlay: false } }
+      },
       clearScreen: false
     })
   );
@@ -66,5 +77,5 @@ async function dev(root, args) {
 }
 
 export { dev };
-//# sourceMappingURL=dev-NZRLOQCL.js.map
-//# sourceMappingURL=dev-NZRLOQCL.js.map
+//# sourceMappingURL=dev-GDKATCC7.js.map
+//# sourceMappingURL=dev-GDKATCC7.js.map

package/dist/dev-GDKATCC7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/dev.ts"],"names":[],"mappings":"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","file":"dev-GDKATCC7.js","sourcesContent":["import { createServer, loadEnv } from \"vite\"\nimport { runDiagnostics } from \"../core/diagnostics\"\nimport { timedAsync } from \"../core/profile\"\nimport { scanProject } from \"../core/scan\"\nimport { vantagePlugin } from \"../vite/index\"\nimport {\n  applyApiBaseUrlFlag,\n  log,\n  printDiagnostics,\n  reportPortInUse,\n  resolveHmrOverlay,\n  resolveHostOptions,\n  resolvePortOptions,\n  type ParsedArgs,\n} from \"./util\"\n\n/** `vantage dev` — start the dev server with HMR and the optional API server. */\nexport async function dev(root: string, args: ParsedArgs): Promise<number> {\n  const model = scanProject(root)\n  const errors = runDiagnostics(root, model).filter((d) => d.severity === \"error\")\n  if (errors.length) {\n    printDiagnostics(errors)\n    log.error(\"Fix the errors above before starting the dev server.\")\n    return 1\n  }\n\n  const mode = \"development\"\n  applyApiBaseUrlFlag(args)\n  const env = { ...process.env, ...loadEnv(mode, root, \"\") }\n  const ports = resolvePortOptions(args.flags, 5173)\n  if (!ports.ok) {\n    log.error(ports.error)\n    return 1\n  }\n  const { port, strictPort } = ports\n  const hosts = resolveHostOptions(args.flags)\n  if (!hosts.ok) {\n    log.error(hosts.error)\n    return 1\n  }\n  const overlay = resolveHmrOverlay(args.flags)\n\n  const server = await timedAsync(\"vite:createServer\", () =>\n    createServer({\n      configFile: false,\n      root,\n      mode,\n      // The model was just scanned for diagnostics; hand it over so the plugin\n      // does not walk the project again.\n      plugins: [vantagePlugin({ root, env, model })],\n      // `host` / `allowedHosts` are only present when asked for, and `hmr` is\n      // left alone unless the overlay is being turned off, so Vite's own\n      // defaults (host, port, protocol) keep applying.\n      server: {\n        port,\n        strictPort,\n        ...hosts.options,\n        ...(overlay ? {} : { hmr: { overlay: false } }),\n      },\n      clearScreen: false,\n    }),\n  )\n\n  try {\n    await timedAsync(\"vite:listen\", () => server.listen())\n  } catch (err) {\n    await server.close().catch(() => {})\n    if (reportPortInUse(err, port, strictPort)) return 1\n    throw err\n  }\n  log.brand(\"dev server ready\")\n  server.printUrls()\n  if (model.hasServer) log.info(\"  \" + \"server/api enabled\")\n\n  const shutdown = async () => {\n    await server.close()\n    process.exit(0)\n  }\n  process.on(\"SIGINT\", shutdown)\n  process.on(\"SIGTERM\", shutdown)\n\n  // Keep the process alive; the listening server owns the lifecycle.\n  return new Promise<number>(() => {})\n}\n"]}

package/dist/doc/index.d.ts

@@ -33,6 +33,10 @@ interface DocumentProps extends HTMLAttributes<HTMLElement> {
  * the `[data-slot="document"]` rules in theme.css, so the page body needs no
  * classes. Those rules sit in `@layer components`, below Tailwind utilities, so
  * a `className` on any element still wins.
+ *
+ * It also carries its own way out: a button that opens the print dialog, where
+ * "Save as PDF" is the download. The print rules in theme.css leave only the
+ * document on paper.
  */
 declare const Document: React.ForwardRefExoticComponent<DocumentProps & React.RefAttributes<HTMLElement>>;
 

package/dist/doc/index.js

@@ -1,8 +1,80 @@
-import { forwardRef } from 'react';
-import { jsx } from 'react/jsx-runtime';
+import { Button } from '../chunk-PXRX5PEC.js';
+import '../chunk-A2UUGASH.js';
+import { forwardRef, useEffect } from 'react';
+import { PrinterIcon } from 'lucide-react';
+import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
 
 // @squadbase/vantage — generated build. Do not edit.
 
+// src/doc/print.ts
+var DARK_CLASS = "dark";
+var THEME_ATTR = "data-theme";
+var restore = null;
+function forceLight() {
+  if (restore) return;
+  const undo = [];
+  for (const el of [document.documentElement, document.body]) {
+    if (!el) continue;
+    if (el.classList.contains(DARK_CLASS)) {
+      el.classList.remove(DARK_CLASS);
+      undo.push(() => el.classList.add(DARK_CLASS));
+    }
+    if (el.getAttribute(THEME_ATTR) === "dark") {
+      el.setAttribute(THEME_ATTR, "light");
+      undo.push(() => el.setAttribute(THEME_ATTR, "dark"));
+    }
+  }
+  restore = () => {
+    for (const fn of undo) fn();
+  };
+}
+function restoreTheme() {
+  restore?.();
+  restore = null;
+}
+function nextFrame() {
+  return new Promise((resolve) => {
+    let settled = false;
+    const settle = () => {
+      if (settled) return;
+      settled = true;
+      resolve();
+    };
+    requestAnimationFrame(settle);
+    setTimeout(settle, 50);
+  });
+}
+var REPAINT_FRAMES = 4;
+var CHART_TIMEOUT_MS = 3e3;
+async function waitForCharts() {
+  const deadline = performance.now() + CHART_TIMEOUT_MS;
+  while (performance.now() < deadline) {
+    if (!document.querySelector('[data-slot="echart-canvas"][data-rendering]')) return;
+    await nextFrame();
+  }
+}
+async function printDocument() {
+  const wasForced = restore !== null;
+  forceLight();
+  try {
+    if (!wasForced && restore) {
+      for (let i = 0; i < REPAINT_FRAMES; i++) await nextFrame();
+    }
+    await waitForCharts();
+    window.print();
+  } catch (error) {
+    restoreTheme();
+    throw error;
+  }
+}
+function watchPrintEvents() {
+  window.addEventListener("beforeprint", forceLight);
+  window.addEventListener("afterprint", restoreTheme);
+  return () => {
+    window.removeEventListener("beforeprint", forceLight);
+    window.removeEventListener("afterprint", restoreTheme);
+  };
+}
 function themeToCssVars(theme) {
   if (!theme) return void 0;
   const vars = {};
@@ -19,17 +91,41 @@ function themeToCssVars(theme) {
   if (theme.maxWidth) vars["--doc-max-width"] = theme.maxWidth;
   return Object.keys(vars).length > 0 ? vars : void 0;
 }
+var PRINT_PAGE_CSS = "@media print { @page { margin: 0 } }";
+function printLabel() {
+  return navigator.language.toLowerCase().startsWith("ja") ? "PDF \u3068\u3057\u3066\u4FDD\u5B58" : "Save as PDF";
+}
 var Document = forwardRef(function Document2({ theme, style, ...props }, ref) {
   const themeVars = themeToCssVars(theme);
-  return /* @__PURE__ */ jsx(
-    "article",
-    {
-      ref,
-      "data-slot": "document",
-      style: themeVars || style ? { ...themeVars, ...style } : void 0,
-      ...props
-    }
-  );
+  const label = printLabel();
+  useEffect(() => watchPrintEvents(), []);
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(
+      "article",
+      {
+        ref,
+        "data-slot": "document",
+        style: themeVars || style ? { ...themeVars, ...style } : void 0,
+        ...props
+      }
+    ),
+    /* @__PURE__ */ jsx("style", { children: PRINT_PAGE_CSS }),
+    /* @__PURE__ */ jsxs(
+      Button,
+      {
+        "data-slot": "document-print",
+        variant: "outline",
+        size: "sm",
+        className: "fixed right-4 bottom-4 z-10 shadow-sm",
+        onClick: () => void printDocument(),
+        title: label,
+        children: [
+          /* @__PURE__ */ jsx(PrinterIcon, { "aria-hidden": "true" }),
+          label
+        ]
+      }
+    )
+  ] });
 });
 Document.displayName = "Document";
 

package/dist/doc/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/doc/document.tsx"],"names":["Document"],"mappings":";;;;;AAeA,SAAS,eAAe,KAAA,EAA6D;AACnF,EAAA,IAAI,CAAC,OAAO,OAAO,MAAA;AACnB,EAAA,MAAM,OAA+B,EAAC;AACtC,EAAA,IAAI,KAAA,CAAM,EAAA,EAAI,IAAA,CAAK,UAAU,IAAI,KAAA,CAAM,EAAA;AACvC,EAAA,IAAI,KAAA,CAAM,KAAA,EAAO,IAAA,CAAK,aAAa,IAAI,KAAA,CAAM,KAAA;AAC7C,EAAA,IAAI,KAAA,CAAM,MAAA,EAAQ,IAAA,CAAK,cAAc,IAAI,KAAA,CAAM,MAAA;AAC/C,EAAA,IAAI,KAAA,CAAM,MAAA,EAAQ,IAAA,CAAK,cAAc,IAAI,KAAA,CAAM,MAAA;AAC/C,EAAA,IAAI,KAAA,CAAM,MAAA,EAAQ,IAAA,CAAK,cAAc,IAAI,KAAA,CAAM,MAAA;AAC/C,EAAA,IAAI,KAAA,CAAM,QAAA,EAAU,IAAA,CAAK,iBAAiB,IAAI,KAAA,CAAM,QAAA;AACpD,EAAA,IAAI,KAAA,CAAM,WAAA,EAAa,IAAA,CAAK,oBAAoB,IAAI,KAAA,CAAM,WAAA;AAC1D,EAAA,IAAI,KAAA,CAAM,QAAA,EAAU,IAAA,CAAK,iBAAiB,IAAI,KAAA,CAAM,QAAA;AACpD,EAAA,IAAI,KAAA,CAAM,QAAA,EAAU,IAAA,CAAK,iBAAiB,IAAI,KAAA,CAAM,QAAA;AACpD,EAAA,IAAI,KAAA,CAAM,UAAA,EAAY,IAAA,CAAK,mBAAmB,IAAI,KAAA,CAAM,UAAA;AACxD,EAAA,IAAI,KAAA,CAAM,QAAA,EAAU,IAAA,CAAK,iBAAiB,IAAI,KAAA,CAAM,QAAA;AACpD,EAAA,OAAO,OAAO,IAAA,CAAK,IAAI,CAAA,CAAE,MAAA,GAAS,IAAK,IAAA,GAAyB,MAAA;AAClE;AASO,IAAM,QAAA,GAAW,UAAA,CAAuC,SAASA,SAAAA,CACtE,EAAE,OAAO,KAAA,EAAO,GAAG,KAAA,EAAM,EACzB,GAAA,EACA;AACA,EAAA,MAAM,SAAA,GAAY,eAAe,KAAK,CAAA;AACtC,EAAA,uBACE,GAAA;AAAA,IAAC,SAAA;AAAA,IAAA;AAAA,MACC,GAAA;AAAA,MACA,WAAA,EAAU,UAAA;AAAA,MACV,KAAA,EAAO,aAAa,KAAA,GAAQ,EAAE,GAAG,SAAA,EAAW,GAAG,OAAM,GAAI,MAAA;AAAA,MACxD,GAAG;AAAA;AAAA,GACN;AAEJ,CAAC;AACD,QAAA,CAAS,WAAA,GAAc,UAAA","file":"index.js","sourcesContent":["import { forwardRef } from \"react\"\nimport type { CSSProperties, HTMLAttributes } from \"react\"\n\nimport type { DocumentTheme } from \"./types\"\n\nexport interface DocumentProps extends HTMLAttributes<HTMLElement> {\n  /** Token overrides for this document; anything omitted follows the app's theme. */\n  theme?: DocumentTheme\n}\n\n/**\n * Only the keys the document set are emitted — the rest resolve up the\n * cascade to `--doc-*` in theme.css. Writing defaults here would freeze every\n * document to light.\n */\nfunction themeToCssVars(theme: DocumentTheme | undefined): CSSProperties | undefined {\n  if (!theme) return undefined\n  const vars: Record<string, string> = {}\n  if (theme.fg) vars[\"--doc-fg\"] = theme.fg\n  if (theme.muted) vars[\"--doc-muted\"] = theme.muted\n  if (theme.accent) vars[\"--doc-accent\"] = theme.accent\n  if (theme.border) vars[\"--doc-border\"] = theme.border\n  if (theme.subtle) vars[\"--doc-subtle\"] = theme.subtle\n  if (theme.fontBody) vars[\"--doc-font-body\"] = theme.fontBody\n  if (theme.fontHeading) vars[\"--doc-font-heading\"] = theme.fontHeading\n  if (theme.fontMono) vars[\"--doc-font-mono\"] = theme.fontMono\n  if (theme.sizeBody) vars[\"--doc-size-body\"] = theme.sizeBody\n  if (theme.lineHeight) vars[\"--doc-line-height\"] = theme.lineHeight\n  if (theme.maxWidth) vars[\"--doc-max-width\"] = theme.maxWidth\n  return Object.keys(vars).length > 0 ? (vars as CSSProperties) : undefined\n}\n\n/**\n * The container of a document page. Plain elements written inside it —\n * headings, paragraphs, lists, tables, quotes, code, figures — are typeset by\n * the `[data-slot=\"document\"]` rules in theme.css, so the page body needs no\n * classes. Those rules sit in `@layer components`, below Tailwind utilities, so\n * a `className` on any element still wins.\n */\nexport const Document = forwardRef<HTMLElement, DocumentProps>(function Document(\n  { theme, style, ...props },\n  ref,\n) {\n  const themeVars = themeToCssVars(theme)\n  return (\n    <article\n      ref={ref}\n      data-slot=\"document\"\n      style={themeVars || style ? { ...themeVars, ...style } : undefined}\n      {...props}\n    />\n  )\n})\nDocument.displayName = \"Document\"\n"]}
+{"version":3,"sources":["../../src/doc/print.ts","../../src/doc/document.tsx"],"names":["Document"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Printing a document — the browser's own print dialog, where \"Save as PDF\"\n * is the download. Paper is white and backgrounds are dropped by default, so a\n * dark theme would print pale text on nothing: the page is switched to light\n * for the duration and put back afterwards.\n */\n\nconst DARK_CLASS = \"dark\"\nconst THEME_ATTR = \"data-theme\"\n\ntype Restore = () => void\n\nlet restore: Restore | null = null\n\n/** Drop every dark marker on `<html>`/`<body>`, remembering exactly what was there. */\nfunction forceLight(): void {\n  if (restore) return\n  const undo: Restore[] = []\n  for (const el of [document.documentElement, document.body]) {\n    if (!el) continue\n    if (el.classList.contains(DARK_CLASS)) {\n      el.classList.remove(DARK_CLASS)\n      undo.push(() => el.classList.add(DARK_CLASS))\n    }\n    if (el.getAttribute(THEME_ATTR) === \"dark\") {\n      el.setAttribute(THEME_ATTR, \"light\")\n      undo.push(() => el.setAttribute(THEME_ATTR, \"dark\"))\n    }\n  }\n  restore = () => {\n    for (const fn of undo) fn()\n  }\n}\n\nfunction restoreTheme(): void {\n  restore?.()\n  restore = null\n}\n\nfunction nextFrame(): Promise<void> {\n  return new Promise((resolve) => {\n    let settled = false\n    const settle = () => {\n      if (settled) return\n      settled = true\n      resolve()\n    }\n    requestAnimationFrame(settle)\n    setTimeout(settle, 50)\n  })\n}\n\n/**\n * Canvas charts keep the colours they were painted with, and a CSS switch at\n * print time does not repaint them. Their tokens are re-read a frame after the\n * theme flips, then React re-inits the chart, which animates in from empty —\n * printed mid-way, the bars are missing. So wait a few frames for the re-init\n * to start, then for every chart to report its paint done.\n */\nconst REPAINT_FRAMES = 4\nconst CHART_TIMEOUT_MS = 3000\n\nasync function waitForCharts(): Promise<void> {\n  const deadline = performance.now() + CHART_TIMEOUT_MS\n  while (performance.now() < deadline) {\n    if (!document.querySelector('[data-slot=\"echart-canvas\"][data-rendering]')) return\n    await nextFrame()\n  }\n}\n\n/**\n * The theme comes back on `afterprint` (see `watchPrintEvents`), not after\n * `window.print()` returns — not every browser blocks on the dialog.\n */\nexport async function printDocument(): Promise<void> {\n  const wasForced = restore !== null\n  forceLight()\n  try {\n    if (!wasForced && restore) {\n      for (let i = 0; i < REPAINT_FRAMES; i++) await nextFrame()\n    }\n    await waitForCharts()\n    window.print()\n  } catch (error) {\n    restoreTheme()\n    throw error\n  }\n}\n\n/**\n * Must be mounted while a document is on screen. It also covers the browser's\n * own Print command, which skips the button: flipping the theme in\n * `beforeprint` still gets the text and rules right, though canvas charts\n * cannot repaint in time on that path.\n */\nexport function watchPrintEvents(): () => void {\n  window.addEventListener(\"beforeprint\", forceLight)\n  window.addEventListener(\"afterprint\", restoreTheme)\n  return () => {\n    window.removeEventListener(\"beforeprint\", forceLight)\n    window.removeEventListener(\"afterprint\", restoreTheme)\n  }\n}\n","import { forwardRef, useEffect } from \"react\"\nimport type { CSSProperties, HTMLAttributes } from \"react\"\nimport { PrinterIcon } from \"lucide-react\"\n\nimport { Button } from \"../ui/button\"\nimport { printDocument, watchPrintEvents } from \"./print\"\nimport type { DocumentTheme } from \"./types\"\n\nexport interface DocumentProps extends HTMLAttributes<HTMLElement> {\n  /** Token overrides for this document; anything omitted follows the app's theme. */\n  theme?: DocumentTheme\n}\n\n/**\n * Only the keys the document set are emitted — the rest resolve up the\n * cascade to `--doc-*` in theme.css. Writing defaults here would freeze every\n * document to light.\n */\nfunction themeToCssVars(theme: DocumentTheme | undefined): CSSProperties | undefined {\n  if (!theme) return undefined\n  const vars: Record<string, string> = {}\n  if (theme.fg) vars[\"--doc-fg\"] = theme.fg\n  if (theme.muted) vars[\"--doc-muted\"] = theme.muted\n  if (theme.accent) vars[\"--doc-accent\"] = theme.accent\n  if (theme.border) vars[\"--doc-border\"] = theme.border\n  if (theme.subtle) vars[\"--doc-subtle\"] = theme.subtle\n  if (theme.fontBody) vars[\"--doc-font-body\"] = theme.fontBody\n  if (theme.fontHeading) vars[\"--doc-font-heading\"] = theme.fontHeading\n  if (theme.fontMono) vars[\"--doc-font-mono\"] = theme.fontMono\n  if (theme.sizeBody) vars[\"--doc-size-body\"] = theme.sizeBody\n  if (theme.lineHeight) vars[\"--doc-line-height\"] = theme.lineHeight\n  if (theme.maxWidth) vars[\"--doc-max-width\"] = theme.maxWidth\n  return Object.keys(vars).length > 0 ? (vars as CSSProperties) : undefined\n}\n\n/**\n * With no page margin the browser has nowhere to print its date / URL header\n * and footer. Rendered by `<Document>` rather than put in theme.css because an\n * `@page` rule cannot be scoped — there it would reach every dashboard too.\n */\nconst PRINT_PAGE_CSS = \"@media print { @page { margin: 0 } }\"\n\n/** The one piece of chrome a document shows: English, Japanese for a Japanese browser. */\nfunction printLabel(): string {\n  return navigator.language.toLowerCase().startsWith(\"ja\") ? \"PDF として保存\" : \"Save as PDF\"\n}\n\n/**\n * The container of a document page. Plain elements written inside it —\n * headings, paragraphs, lists, tables, quotes, code, figures — are typeset by\n * the `[data-slot=\"document\"]` rules in theme.css, so the page body needs no\n * classes. Those rules sit in `@layer components`, below Tailwind utilities, so\n * a `className` on any element still wins.\n *\n * It also carries its own way out: a button that opens the print dialog, where\n * \"Save as PDF\" is the download. The print rules in theme.css leave only the\n * document on paper.\n */\nexport const Document = forwardRef<HTMLElement, DocumentProps>(function Document(\n  { theme, style, ...props },\n  ref,\n) {\n  const themeVars = themeToCssVars(theme)\n  const label = printLabel()\n  useEffect(() => watchPrintEvents(), [])\n  return (\n    <>\n      <article\n        ref={ref}\n        data-slot=\"document\"\n        style={themeVars || style ? { ...themeVars, ...style } : undefined}\n        {...props}\n      />\n      <style>{PRINT_PAGE_CSS}</style>\n      <Button\n        data-slot=\"document-print\"\n        variant=\"outline\"\n        size=\"sm\"\n        className=\"fixed right-4 bottom-4 z-10 shadow-sm\"\n        onClick={() => void printDocument()}\n        title={label}\n      >\n        <PrinterIcon aria-hidden=\"true\" />\n        {label}\n      </Button>\n    </>\n  )\n})\nDocument.displayName = \"Document\"\n"]}

package/dist/{docs-ZGDJUHJI.js → docs-EJJ3BECT.js}

@@ -1,5 +1,5 @@
 import { loadCatalog, isDocLang, DOC_LANGS, DEFAULT_DOC_LANG, docsForLang, readDoc, resolveDoc, groupBySection } from './chunk-2KRCGXBY.js';
-import { log, printJson } from './chunk-3G43C6OL.js';
+import { log, printJson } from './chunk-QI3XQKHS.js';
 import './chunk-C2CX6GLX.js';
 import pc from 'picocolors';
 
@@ -110,5 +110,5 @@ async function docs(_root, args) {
 }
 
 export { docs };
-//# sourceMappingURL=docs-ZGDJUHJI.js.map
-//# sourceMappingURL=docs-ZGDJUHJI.js.map
+//# sourceMappingURL=docs-EJJ3BECT.js.map
+//# sourceMappingURL=docs-EJJ3BECT.js.map

package/dist/{docs-ZGDJUHJI.js.map → docs-EJJ3BECT.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/docs.ts"],"names":["content"],"mappings":"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","file":"docs-ZGDJUHJI.js","sourcesContent":["import pc from \"picocolors\"\nimport {\n  DEFAULT_DOC_LANG,\n  DOC_LANGS,\n  docsForLang,\n  groupBySection,\n  isDocLang,\n  loadCatalog,\n  readDoc,\n  resolveDoc,\n  type DocEntry,\n  type DocLang,\n} from \"./docs-catalog\"\nimport { log, printJson, type ParsedArgs } from \"./util\"\n\n/** Highlight Markdown for a terminal. Piped output stays untouched. */\nfunction paint(markdown: string): string {\n  if (!process.stdout.isTTY) return markdown\n  let inFence = false\n  return markdown\n    .split(\"\\n\")\n    .map((line) => {\n      if (/^\\s*(```|~~~)/.test(line)) {\n        inFence = !inFence\n        return pc.dim(line)\n      }\n      if (inFence) return line\n      if (/^#{1,6}\\s/.test(line)) return pc.bold(pc.magenta(line))\n      if (/^>\\s?/.test(line)) return pc.dim(line)\n      return line\n    })\n    .join(\"\\n\")\n}\n\nfunction printList(entries: DocEntry[]): void {\n  const width = Math.max(...entries.map((doc) => doc.slug.length), 0)\n  for (const group of groupBySection(entries)) {\n    console.log(\"\")\n    console.log(pc.bold(group.title))\n    for (const doc of group.docs) {\n      const slug = doc.slug.padEnd(width)\n      console.log(`  ${pc.cyan(slug)}  ${doc.description || doc.title}`)\n    }\n  }\n  console.log(\"\")\n  console.log(pc.dim(\"vantage docs <name>   show one page      --json   machine-readable\"))\n  console.log(pc.dim(\"vantage docs --all    show every page    --lang   ja | en\"))\n}\n\nfunction toJson(doc: DocEntry, content: string) {\n  return {\n    slug: doc.slug,\n    lang: doc.lang,\n    title: doc.title,\n    description: doc.description,\n    section: doc.section,\n    sectionTitle: doc.sectionTitle,\n    content,\n  }\n}\n\n/** `vantage docs [name] [--list] [--all] [--json] [--lang ja|en]` */\nexport async function docs(_root: string, args: ParsedArgs): Promise<number> {\n  const catalog = loadCatalog()\n  if (!catalog) {\n    log.error(\"The bundled documentation is missing. Reinstall @squadbase/vantage, or run `pnpm build` in the framework repo.\")\n    return 1\n  }\n\n  const langFlag = args.flags.lang\n  if (langFlag !== undefined && !isDocLang(langFlag)) {\n    log.error(`Unknown --lang \"${String(langFlag)}\". Available: ${DOC_LANGS.join(\", \")}`)\n    return 1\n  }\n  const lang: DocLang = isDocLang(langFlag) ? langFlag : DEFAULT_DOC_LANG\n\n  const entries = docsForLang(catalog, lang)\n  if (entries.length === 0) {\n    log.error(`No documentation bundled for \"${lang}\".`)\n    return 1\n  }\n\n  const json = Boolean(args.flags.json)\n  const name = args.positionals[1]\n\n  if (args.flags.all) {\n    const pages = entries.map((doc) => ({ doc, content: readDoc(doc) }))\n    if (json) {\n      printJson({ lang, docs: pages.map(({ doc, content }) => toJson(doc, content)) })\n      return 0\n    }\n    process.stdout.write(pages.map(({ content }) => content.trimEnd()).join(\"\\n\\n---\\n\\n\") + \"\\n\")\n    return 0\n  }\n\n  if (!name || args.flags.list) {\n    if (json) {\n      printJson({\n        lang,\n        docs: entries.map(({ slug, title, description, section, sectionTitle }) => ({\n          slug,\n          title,\n          description,\n          section,\n          sectionTitle,\n        })),\n      })\n      return 0\n    }\n    printList(entries)\n    return 0\n  }\n\n  const found = resolveDoc(entries, name)\n  if (found.kind === \"ambiguous\") {\n    log.error(`\"${name}\" matches several pages: ${found.matches.map((d) => d.slug).join(\", \")}`)\n    return 1\n  }\n  if (found.kind === \"missing\") {\n    const suggestions = found.suggestions.map((d) => d.slug)\n    log.error(\n      suggestions.length\n        ? `No page named \"${name}\". Did you mean: ${suggestions.slice(0, 8).join(\", \")}?`\n        : `No page named \"${name}\". Run \\`vantage docs\\` to list every page.`,\n    )\n    return 1\n  }\n\n  const content = readDoc(found.doc)\n  if (json) {\n    printJson(toJson(found.doc, content))\n    return 0\n  }\n  process.stdout.write(paint(content.trimEnd()) + \"\\n\")\n  return 0\n}\n"]}
+{"version":3,"sources":["../src/cli/docs.ts"],"names":["content"],"mappings":"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","file":"docs-EJJ3BECT.js","sourcesContent":["import pc from \"picocolors\"\nimport {\n  DEFAULT_DOC_LANG,\n  DOC_LANGS,\n  docsForLang,\n  groupBySection,\n  isDocLang,\n  loadCatalog,\n  readDoc,\n  resolveDoc,\n  type DocEntry,\n  type DocLang,\n} from \"./docs-catalog\"\nimport { log, printJson, type ParsedArgs } from \"./util\"\n\n/** Highlight Markdown for a terminal. Piped output stays untouched. */\nfunction paint(markdown: string): string {\n  if (!process.stdout.isTTY) return markdown\n  let inFence = false\n  return markdown\n    .split(\"\\n\")\n    .map((line) => {\n      if (/^\\s*(```|~~~)/.test(line)) {\n        inFence = !inFence\n        return pc.dim(line)\n      }\n      if (inFence) return line\n      if (/^#{1,6}\\s/.test(line)) return pc.bold(pc.magenta(line))\n      if (/^>\\s?/.test(line)) return pc.dim(line)\n      return line\n    })\n    .join(\"\\n\")\n}\n\nfunction printList(entries: DocEntry[]): void {\n  const width = Math.max(...entries.map((doc) => doc.slug.length), 0)\n  for (const group of groupBySection(entries)) {\n    console.log(\"\")\n    console.log(pc.bold(group.title))\n    for (const doc of group.docs) {\n      const slug = doc.slug.padEnd(width)\n      console.log(`  ${pc.cyan(slug)}  ${doc.description || doc.title}`)\n    }\n  }\n  console.log(\"\")\n  console.log(pc.dim(\"vantage docs <name>   show one page      --json   machine-readable\"))\n  console.log(pc.dim(\"vantage docs --all    show every page    --lang   ja | en\"))\n}\n\nfunction toJson(doc: DocEntry, content: string) {\n  return {\n    slug: doc.slug,\n    lang: doc.lang,\n    title: doc.title,\n    description: doc.description,\n    section: doc.section,\n    sectionTitle: doc.sectionTitle,\n    content,\n  }\n}\n\n/** `vantage docs [name] [--list] [--all] [--json] [--lang ja|en]` */\nexport async function docs(_root: string, args: ParsedArgs): Promise<number> {\n  const catalog = loadCatalog()\n  if (!catalog) {\n    log.error(\"The bundled documentation is missing. Reinstall @squadbase/vantage, or run `pnpm build` in the framework repo.\")\n    return 1\n  }\n\n  const langFlag = args.flags.lang\n  if (langFlag !== undefined && !isDocLang(langFlag)) {\n    log.error(`Unknown --lang \"${String(langFlag)}\". Available: ${DOC_LANGS.join(\", \")}`)\n    return 1\n  }\n  const lang: DocLang = isDocLang(langFlag) ? langFlag : DEFAULT_DOC_LANG\n\n  const entries = docsForLang(catalog, lang)\n  if (entries.length === 0) {\n    log.error(`No documentation bundled for \"${lang}\".`)\n    return 1\n  }\n\n  const json = Boolean(args.flags.json)\n  const name = args.positionals[1]\n\n  if (args.flags.all) {\n    const pages = entries.map((doc) => ({ doc, content: readDoc(doc) }))\n    if (json) {\n      printJson({ lang, docs: pages.map(({ doc, content }) => toJson(doc, content)) })\n      return 0\n    }\n    process.stdout.write(pages.map(({ content }) => content.trimEnd()).join(\"\\n\\n---\\n\\n\") + \"\\n\")\n    return 0\n  }\n\n  if (!name || args.flags.list) {\n    if (json) {\n      printJson({\n        lang,\n        docs: entries.map(({ slug, title, description, section, sectionTitle }) => ({\n          slug,\n          title,\n          description,\n          section,\n          sectionTitle,\n        })),\n      })\n      return 0\n    }\n    printList(entries)\n    return 0\n  }\n\n  const found = resolveDoc(entries, name)\n  if (found.kind === \"ambiguous\") {\n    log.error(`\"${name}\" matches several pages: ${found.matches.map((d) => d.slug).join(\", \")}`)\n    return 1\n  }\n  if (found.kind === \"missing\") {\n    const suggestions = found.suggestions.map((d) => d.slug)\n    log.error(\n      suggestions.length\n        ? `No page named \"${name}\". Did you mean: ${suggestions.slice(0, 8).join(\", \")}?`\n        : `No page named \"${name}\". Run \\`vantage docs\\` to list every page.`,\n    )\n    return 1\n  }\n\n  const content = readDoc(found.doc)\n  if (json) {\n    printJson(toJson(found.doc, content))\n    return 0\n  }\n  process.stdout.write(paint(content.trimEnd()) + \"\\n\")\n  return 0\n}\n"]}

package/dist/{doctor-VFKEMR54.js → doctor-WQXPXP6K.js}

@@ -1,8 +1,8 @@
-import { runDiagnostics } from './chunk-BCE22JSM.js';
-import './chunk-JGRMRXXZ.js';
-import './chunk-KLEIVDUV.js';
+import { runDiagnostics } from './chunk-P7W4LR3Z.js';
+import './chunk-JKLLFVEU.js';
+import './chunk-CEXAQQ5W.js';
 import { scanProject } from './chunk-ZVANIULZ.js';
-import { printJson, frameworkVersion, log } from './chunk-3G43C6OL.js';
+import { printJson, frameworkVersion, log } from './chunk-QI3XQKHS.js';
 import './chunk-C2CX6GLX.js';
 import fs from 'fs';
 import path from 'path';
@@ -19,7 +19,7 @@ async function doctor(root, args) {
   });
   const pkgPath = path.join(root, "package.json");
   facets.push({ name: "package.json", ok: fs.existsSync(pkgPath), detail: fs.existsSync(pkgPath) ? "found" : "missing" });
-  const lockfiles = ["pnpm-lock.yaml", "package-lock.json", "yarn.lock"];
+  const lockfiles = ["bun.lock", "bun.lockb", "pnpm-lock.yaml", "package-lock.json", "yarn.lock"];
   const lock = lockfiles.find((f) => fs.existsSync(path.join(root, f)) || fs.existsSync(path.join(root, "..", f)) || fs.existsSync(path.join(root, "..", "..", f)));
   facets.push({ name: "lockfile", ok: Boolean(lock), detail: lock ?? "none found" });
   let installedVantage = "not installed";
@@ -54,5 +54,5 @@ async function doctor(root, args) {
 }
 
 export { doctor };
-//# sourceMappingURL=doctor-VFKEMR54.js.map
-//# sourceMappingURL=doctor-VFKEMR54.js.map
+//# sourceMappingURL=doctor-WQXPXP6K.js.map
+//# sourceMappingURL=doctor-WQXPXP6K.js.map

package/dist/doctor-WQXPXP6K.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/doctor.ts"],"names":["require"],"mappings":"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","file":"doctor-WQXPXP6K.js","sourcesContent":["import fs from \"node:fs\"\nimport path from \"node:path\"\nimport { createRequire } from \"node:module\"\nimport { runDiagnostics } from \"../core/diagnostics\"\nimport { scanProject } from \"../core/scan\"\nimport { frameworkVersion, log, printJson, type ParsedArgs } from \"./util\"\n\ninterface Facet {\n  name: string\n  ok: boolean\n  detail: string\n}\n\n/** `vantage doctor` — environment and installation health checks. */\nexport async function doctor(root: string, args: ParsedArgs): Promise<number> {\n  const facets: Facet[] = []\n\n  const nodeMajor = Number(process.versions.node.split(\".\")[0])\n  facets.push({\n    name: \"node\",\n    ok: nodeMajor >= 20,\n    detail: `v${process.versions.node}${nodeMajor >= 20 ? \"\" : \" (requires >= 20)\"}`,\n  })\n\n  const pkgPath = path.join(root, \"package.json\")\n  facets.push({ name: \"package.json\", ok: fs.existsSync(pkgPath), detail: fs.existsSync(pkgPath) ? \"found\" : \"missing\" })\n\n  const lockfiles = [\"bun.lock\", \"bun.lockb\", \"pnpm-lock.yaml\", \"package-lock.json\", \"yarn.lock\"]\n  const lock = lockfiles.find((f) => fs.existsSync(path.join(root, f)) || fs.existsSync(path.join(root, \"..\", f)) || fs.existsSync(path.join(root, \"..\", \"..\", f)))\n  facets.push({ name: \"lockfile\", ok: Boolean(lock), detail: lock ?? \"none found\" })\n\n  let installedVantage = \"not installed\"\n  let vantageOk = false\n  try {\n    const require = createRequire(path.join(root, \"noop.js\"))\n    const p = require.resolve(\"@squadbase/vantage/package.json\")\n    installedVantage = (JSON.parse(fs.readFileSync(p, \"utf8\")) as { version: string }).version\n    vantageOk = true\n  } catch {\n    /* not resolvable */\n  }\n  facets.push({ name: \"@squadbase/vantage\", ok: vantageOk, detail: installedVantage })\n\n  const model = scanProject(root)\n  const errors = runDiagnostics(root, model).filter((d) => d.severity === \"error\")\n  facets.push({\n    name: \"project\",\n    ok: errors.length === 0,\n    detail: errors.length === 0 ? \"no blocking errors\" : `${errors.length} error(s) (run \\`vantage check\\`)`,\n  })\n\n  const allOk = facets.every((f) => f.ok)\n\n  if (args.flags.json) {\n    printJson({ ok: allOk, cli: frameworkVersion(), facets })\n    return allOk ? 0 : 1\n  }\n\n  log.brand(`doctor (cli v${frameworkVersion()})`)\n  for (const f of facets) {\n    const line = `${f.name.padEnd(22)} ${f.detail}`\n    if (f.ok) log.ok(line)\n    else log.error(line)\n  }\n  return allOk ? 0 : 1\n}\n"]}