@squadbase/vantage 0.6.2-dev1.0017a4d → 0.6.2-dev1.02aab78

package/dist/components/index.d.ts

@@ -2121,7 +2121,9 @@ interface KpiCardProps extends Omit<ComponentProps<"div">, "children"> {
     provisional?: boolean | {
         label?: string;
     };
-    /** Whether a rise is good. Default `"higher-is-better"`. `"neutral"` never colours the change and skips the target and record logic. */
+    /** Which direction is good: `"up"` (default) or `"down"` (churn, error rate). Wins over `polarity`. */
+    betterWhen?: "up" | "down";
+    /** @deprecated Older name of `betterWhen` (`"higher-is-better"` / `"lower-is-better"`). `"neutral"` (never colours the change, skips the target and record logic) is only reachable here. `betterWhen` wins if both are given. */
     polarity?: Polarity;
     /** `"relative"` ("+12.4%"), `"points"` ("-0.5pt") or `"difference"` ("+¥530万", in `format`). Default: points for a `percent` format, else relative. */
     change?: ChangeDisplay;
@@ -2134,7 +2136,7 @@ interface KpiCardProps extends Omit<ComponentProps<"div">, "children"> {
     /**
      * Target for the current period. Under the value it adds a 6px bar (actual, the pace
      * projection, a tick at the target) and one line "目標の 49%・このペースなら 98%"
-     * (the projection only while `period` is in progress). With `polarity="lower-is-better"`
+     * (the projection only while `period` is in progress). With `betterWhen="down"`
      * or a rate target (points) there is no bar: "目標 … まであと …" in the footer.
      */
     target?: number;
@@ -2197,7 +2199,7 @@ interface KpiCardProps extends Omit<ComponentProps<"div">, "children"> {
  */
 declare function fillKpiTemplate(template: string, values: Readonly<Record<string, string | null | undefined>>): string;
 declare function fillKpiTemplate(template: string, values: Readonly<Record<string, string | null | undefined>>, fallback: string | null): string | null;
-declare function KpiCard({ label, value, format, locale, comparison: comparisonProp, comparisons, provisional, polarity, change, neutralBand, showPrevious, summary, target, targetLabel, targetDisplay, period, history, historyGrain, showHistory, source, updatedAt, updatedAtDisplay, timeZone, now, isLoading, size, className, ...props }: KpiCardProps): React.JSX.Element;
+declare function KpiCard({ label, value, format, locale, comparison: comparisonProp, comparisons, provisional, betterWhen, polarity: polarityProp, change, neutralBand, showPrevious, summary, target, targetLabel, targetDisplay, period, history, historyGrain, showHistory, source, updatedAt, updatedAtDisplay, timeZone, now, isLoading, size, className, ...props }: KpiCardProps): React.JSX.Element;
 
 declare const deltaVariants: (props?: ({
     variant?: "inline" | "badge" | null | undefined;
@@ -2208,7 +2210,9 @@ interface DeltaProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children">,
     value: number | null | undefined;
     /** What the value is compared against. Required so the delta always carries its label. */
     comparison: Comparison;
-    /** Whether a rise is good. Default `"higher-is-better"`. */
+    /** Which direction is good: `"up"` (default) or `"down"` (churn, error rate). Wins over `polarity`. */
+    betterWhen?: "up" | "down";
+    /** @deprecated Older name of `betterWhen` (`"higher-is-better"` / `"lower-is-better"`); `"neutral"` is only reachable here. `betterWhen` wins if both are given. */
     polarity?: Polarity;
     /** Absolute ratio below which the change reads as flat (0.01 = 1%). Default 0.01. */
     neutralBand?: number;

package/dist/components/index.js

@@ -1,4 +1,4 @@
-export { AppShell, AreaChart, BarChart, BarList, COMPARISON_LABELS, CategoryBar, ChartFrame, DEFAULT_SAMPLE_LABEL, DELTA_NOT_COMPARABLE, DashboardCard, DashboardCardAction, DashboardCardContent, DashboardCardDescription, DashboardCardFooter, DashboardCardHeader, DashboardCardPreset, DashboardCardSkeleton, DashboardCardTitle, DataTable, DataTableColumnVisibility, DataTableContent, DataTableExport, DataTablePagination, DataTablePreset, DataTableToolbar, DateRangePicker, Delta, DonutChart, FilterBar, FilterBarActiveChips, FilterBarClearButton, FilterBarMultiSelect, FilterBarPreset, FilterBarSelect, FunnelSteps, Heatmap, KpiCard, Legend, LineChart, MetricUnit, MetricValue, MultiSelect, PageShell, PageShellActions, PageShellContent, PageShellDescription, PageShellHeader, PageShellHeaderEnd, PageShellHeading, PageShellMeta, PageShellSummary, PageShellSummaryCard, PageShellTitle, Placeholder, ProgressCircle, RECORD_MIN_POINTS, SampleBadge, SampleClaim, SampleData, ScatterChart, SearchableSelect, SectionHeader, SegmentedControl, StatusBadge, Tracker, TrendIndicator, UpdatedAt, WaterfallChart, comparisonBaseline, comparisonLabel, computeComparison, computeTargetProgress, defaultChangeDisplay, defaultPresets, deltaVariants, detectRecord, fillKpiTemplate, flattenOptions, formatChange, formatChangeAmount, formatRelativeTime, funnelStepsVariants, inferPeriodGrain, isGroupedOptions, metricValueVariants, pageShellSummaryCardVariants, tableToCsv, toCsv, toneForValue, useDataTable, useSampleMark } from '../chunk-RU6WKEOG.js';
+export { AppShell, AreaChart, BarChart, BarList, COMPARISON_LABELS, CategoryBar, ChartFrame, DEFAULT_SAMPLE_LABEL, DELTA_NOT_COMPARABLE, DashboardCard, DashboardCardAction, DashboardCardContent, DashboardCardDescription, DashboardCardFooter, DashboardCardHeader, DashboardCardPreset, DashboardCardSkeleton, DashboardCardTitle, DataTable, DataTableColumnVisibility, DataTableContent, DataTableExport, DataTablePagination, DataTablePreset, DataTableToolbar, DateRangePicker, Delta, DonutChart, FilterBar, FilterBarActiveChips, FilterBarClearButton, FilterBarMultiSelect, FilterBarPreset, FilterBarSelect, FunnelSteps, Heatmap, KpiCard, Legend, LineChart, MetricUnit, MetricValue, MultiSelect, PageShell, PageShellActions, PageShellContent, PageShellDescription, PageShellHeader, PageShellHeaderEnd, PageShellHeading, PageShellMeta, PageShellSummary, PageShellSummaryCard, PageShellTitle, Placeholder, ProgressCircle, RECORD_MIN_POINTS, SampleBadge, SampleClaim, SampleData, ScatterChart, SearchableSelect, SectionHeader, SegmentedControl, StatusBadge, Tracker, TrendIndicator, UpdatedAt, WaterfallChart, comparisonBaseline, comparisonLabel, computeComparison, computeTargetProgress, defaultChangeDisplay, defaultPresets, deltaVariants, detectRecord, fillKpiTemplate, flattenOptions, formatChange, formatChangeAmount, formatRelativeTime, funnelStepsVariants, inferPeriodGrain, isGroupedOptions, metricValueVariants, pageShellSummaryCardVariants, tableToCsv, toCsv, toneForValue, useDataTable, useSampleMark } from '../chunk-QOXXOFGL.js';
 export { EChart, useResolvedChartColors } from '../chunk-JXFCSF3K.js';
 export { Sparkline } from '../chunk-2IAPIOPS.js';
 export { DEFAULT_LOCALE, EMPTY_VALUE, MINUS_SIGN, formatDate, formatDateRange, formatDatesInText, formatDelta, formatKind, formatPoints, formatValue, toValueFormatter } from '../chunk-57GHR5LN.js';

package/dist/delta-text-CvwBGJ95.d.ts

@@ -0,0 +1,15 @@
+import * as React from 'react';
+import { V as ValueFormat } from './format-U0cQl069.js';
+
+interface DeltaTextProps {
+    /** The change itself; its direction comes from the sign. `null` shows "—". */
+    value: number | null;
+    format?: ValueFormat;
+    /** Which way is good. Default `"up"`. */
+    betterWhen?: "up" | "down";
+    /** Name of the comparison, e.g. "前月比". Printed before the change; omit to print only the change. */
+    comparisonLabel?: string;
+}
+declare function DeltaText({ value, format, betterWhen, comparisonLabel }: DeltaTextProps): React.JSX.Element;
+
+export { DeltaText as D, type DeltaTextProps as a };

package/dist/{dev-4XEDTELV.js → dev-GUKQT6U6.js}

@@ -1,8 +1,8 @@
-import { runDiagnostics } from './chunk-7DZGJQ3P.js';
-import './chunk-JKLLFVEU.js';
-import { vantagePlugin } from './chunk-2ICNHUG6.js';
-import './chunk-WAMZWZJB.js';
-import './chunk-CEXAQQ5W.js';
+import { runDiagnostics } from './chunk-5C2SEDPH.js';
+import './chunk-UWSQUHX6.js';
+import { vantagePlugin } from './chunk-7652CGJJ.js';
+import './chunk-R6MTJAHX.js';
+import './chunk-S5MDTHH7.js';
 import { scanProject, timedAsync } from './chunk-RNTDBX6S.js';
 import './chunk-46QI6GFC.js';
 import './chunk-B7LLBNLV.js';
@@ -77,5 +77,5 @@ async function dev(root, args) {
 }
 
 export { dev };
-//# sourceMappingURL=dev-4XEDTELV.js.map
-//# sourceMappingURL=dev-4XEDTELV.js.map
+//# sourceMappingURL=dev-GUKQT6U6.js.map
+//# sourceMappingURL=dev-GUKQT6U6.js.map

package/dist/{dev-4XEDTELV.js.map → dev-GUKQT6U6.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/dev.ts"],"names":[],"mappings":"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","file":"dev-4XEDTELV.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  resolveDraftPreview,\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, draftPreview: resolveDraftPreview(args.flags) })],\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"]}
+{"version":3,"sources":["../src/cli/dev.ts"],"names":[],"mappings":"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","file":"dev-GUKQT6U6.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  resolveDraftPreview,\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, draftPreview: resolveDraftPreview(args.flags) })],\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

@@ -1,6 +1,7 @@
 import * as React from 'react';
 import { HTMLAttributes, ReactNode } from 'react';
 import { V as ValueFormat } from '../format-U0cQl069.js';
+export { D as DeltaText, a as DeltaTextProps } from '../delta-text-CvwBGJ95.js';
 
 /**
  * Per-document token overrides. Anything left out falls through to `--doc-*`
@@ -232,4 +233,24 @@ interface DocReportHeaderProps {
 }
 declare function DocReportHeader({ title, subtitle, period, asOf, author, source }: DocReportHeaderProps): React.JSX.Element;
 
-export { type DocActionItem, DocActionItems, type DocActionItemsProps, type DocActionPriority, DocCallout, type DocCalloutKind, type DocCalloutProps, DocDataTable, type DocDataTableProps, DocExecutiveSummary, type DocExecutiveSummaryProps, DocFigure, type DocFigureProps, type DocFinding, type DocFindingMetric, DocKeyFindings, type DocKeyFindingsProps, DocKpiScorecard, type DocKpiScorecardProps, DocReportHeader, type DocReportHeaderProps, type DocScorecardMetric, type DocSummaryMetric, type DocTableCell, type DocTableColumn, type DocTableRow, Document, type DocumentProps, type DocumentTheme };
+interface DocDefinition {
+    term: string;
+    description: ReactNode;
+}
+interface DocSource {
+    name: string;
+    /** Data as-of date, e.g. "2026-10-03". */
+    asOf?: string;
+}
+interface DocNotesAndSourcesProps {
+    /** Heading text. Default "注記・出典". */
+    title?: string;
+    /** `2` directly under the document, `3` inside another section. Default 2. */
+    headingLevel?: 2 | 3;
+    notes?: ReactNode[];
+    definitions?: DocDefinition[];
+    sources?: DocSource[];
+}
+declare function DocNotesAndSources({ title, headingLevel, notes, definitions, sources }: DocNotesAndSourcesProps): React.JSX.Element | null;
+
+export { type DocActionItem, DocActionItems, type DocActionItemsProps, type DocActionPriority, DocCallout, type DocCalloutKind, type DocCalloutProps, DocDataTable, type DocDataTableProps, type DocDefinition, DocExecutiveSummary, type DocExecutiveSummaryProps, DocFigure, type DocFigureProps, type DocFinding, type DocFindingMetric, DocKeyFindings, type DocKeyFindingsProps, DocKpiScorecard, type DocKpiScorecardProps, DocNotesAndSources, type DocNotesAndSourcesProps, DocReportHeader, type DocReportHeaderProps, type DocScorecardMetric, type DocSource, type DocSummaryMetric, type DocTableCell, type DocTableColumn, type DocTableRow, Document, type DocumentProps, type DocumentTheme };

package/dist/doc/index.js

@@ -1,5 +1,7 @@
+import { DeltaText } from '../chunk-6OTTGAPO.js';
+export { DeltaText } from '../chunk-6OTTGAPO.js';
 import { Sparkline } from '../chunk-2IAPIOPS.js';
-import { formatValue, formatDelta } from '../chunk-57GHR5LN.js';
+import { formatValue } from '../chunk-57GHR5LN.js';
 import { Button } from '../chunk-PDOBHMUQ.js';
 import '../chunk-U736PVHY.js';
 import { forwardRef, useEffect, useId } from 'react';
@@ -107,7 +109,14 @@ var Document = forwardRef(function Document2({ theme, style, ...props }, ref) {
       {
         ref,
         "data-slot": "document",
-        style: { width: "100%", ...themeVars, ...style },
+        style: {
+          width: "100%",
+          // Phrase-aware Japanese line breaks (no-op unless <html lang> is CJK / unsupported browsers drop it).
+          wordBreak: "auto-phrase",
+          lineBreak: "strict",
+          ...themeVars,
+          ...style
+        },
         ...props
       }
     ),
@@ -220,28 +229,6 @@ function DocDataTable({ title, unit, columns, rows, total, highlightRows, footno
     ] }) : null
   ] });
 }
-function ChangeText({ delta, format, betterWhen = "up" }) {
-  const { value } = delta;
-  const dir = value > 0 ? "up" : value < 0 ? "down" : "flat";
-  const mark = dir === "up" ? "\u25B2" : dir === "down" ? "\u25BC" : "\u2192";
-  const word = dir === "up" ? "\u5897" : dir === "down" ? "\u6E1B" : "\u6A2A\u3070\u3044";
-  const good = dir === "flat" ? void 0 : dir === "up" === (betterWhen === "up");
-  const tone = good === void 0 ? void 0 : good ? "text-positive" : "text-negative";
-  const text = formatDelta(value, delta.format ?? format);
-  return /* @__PURE__ */ jsxs(
-    "span",
-    {
-      className: tone,
-      style: tone ? void 0 : { color: "var(--doc-muted)" },
-      "aria-label": `${word}\u3001${text}${good === void 0 ? "" : good ? "\u3001\u6539\u5584" : "\u3001\u60AA\u5316"}`,
-      children: [
-        mark,
-        " ",
-        text
-      ]
-    }
-  );
-}
 function DocExecutiveSummary({
   title = "\u8981\u65E8",
   headingLevel = 2,
@@ -268,7 +255,7 @@ function DocExecutiveSummary({
               m.comparisonLabel ?? "\u524D\u671F\u6BD4",
               " "
             ] }),
-            /* @__PURE__ */ jsx(ChangeText, { delta: m.delta, format: m.format, betterWhen: m.betterWhen })
+            /* @__PURE__ */ jsx(DeltaText, { value: m.delta.value, format: m.delta.format ?? m.format, betterWhen: m.betterWhen })
           ] }) : null
         ]
       },
@@ -294,28 +281,6 @@ function DocFigure({ title, unit, number, source, asOf, notes, children }) {
     ] }) : null
   ] });
 }
-function ChangeText2({ delta, format, betterWhen = "up" }) {
-  const { value } = delta;
-  const dir = value > 0 ? "up" : value < 0 ? "down" : "flat";
-  const mark = dir === "up" ? "\u25B2" : dir === "down" ? "\u25BC" : "\u2192";
-  const word = dir === "up" ? "\u5897" : dir === "down" ? "\u6E1B" : "\u6A2A\u3070\u3044";
-  const good = dir === "flat" ? void 0 : dir === "up" === (betterWhen === "up");
-  const tone = good === void 0 ? void 0 : good ? "text-positive" : "text-negative";
-  const text = formatDelta(value, delta.format ?? format);
-  return /* @__PURE__ */ jsxs(
-    "span",
-    {
-      className: tone,
-      style: tone ? void 0 : { color: "var(--doc-muted)" },
-      "aria-label": `${word}\u3001${text}${good === void 0 ? "" : good ? "\u3001\u6539\u5584" : "\u3001\u60AA\u5316"}`,
-      children: [
-        mark,
-        " ",
-        text
-      ]
-    }
-  );
-}
 function DocKeyFindings({ title = "\u4E3B\u8981\u306A\u767A\u898B", headingLevel = 2, findings }) {
   const Heading = headingLevel === 3 ? "h3" : "h2";
   const Item = headingLevel === 3 ? "h4" : "h3";
@@ -337,7 +302,7 @@ function DocKeyFindings({ title = "\u4E3B\u8981\u306A\u767A\u898B", headingLevel
               f.metric.comparisonLabel ?? "\u524D\u671F\u6BD4",
               " "
             ] }),
-            /* @__PURE__ */ jsx(ChangeText2, { delta: f.metric.delta, format: f.metric.format, betterWhen: f.metric.betterWhen })
+            /* @__PURE__ */ jsx(DeltaText, { value: f.metric.delta.value, format: f.metric.delta.format ?? f.metric.format, betterWhen: f.metric.betterWhen })
           ] }) : null
         ] }) : null
       ] })
@@ -346,31 +311,9 @@ function DocKeyFindings({ title = "\u4E3B\u8981\u306A\u767A\u898B", headingLevel
 }
 var MUTED2 = { color: "var(--doc-muted)" };
 var ACHIEVEMENT = { type: "percent", digits: 1 };
-function ChangeText3({ delta, format, betterWhen = "up" }) {
-  const { value } = delta;
-  const dir = value > 0 ? "up" : value < 0 ? "down" : "flat";
-  const mark = dir === "up" ? "\u25B2" : dir === "down" ? "\u25BC" : "\u2192";
-  const word = dir === "up" ? "\u5897" : dir === "down" ? "\u6E1B" : "\u6A2A\u3070\u3044";
-  const good = dir === "flat" ? void 0 : dir === "up" === (betterWhen === "up");
-  const tone = good === void 0 ? void 0 : good ? "text-positive" : "text-negative";
-  const text = formatDelta(value, delta.format ?? format);
-  return /* @__PURE__ */ jsxs(
-    "span",
-    {
-      className: tone,
-      style: tone ? void 0 : { color: "var(--doc-muted)" },
-      "aria-label": `${word}\u3001${text}${good === void 0 ? "" : good ? "\u3001\u6539\u5584" : "\u3001\u60AA\u5316"}`,
-      children: [
-        mark,
-        " ",
-        text
-      ]
-    }
-  );
-}
 var shown = (m) => m.display ?? formatValue(m.value, m.format);
 var achievement = (m) => m.target === void 0 || m.target === 0 || m.value === null ? "\u2014" : formatValue(m.value / m.target, ACHIEVEMENT);
-var change = (m) => m.delta ? /* @__PURE__ */ jsx(ChangeText3, { delta: m.delta, format: m.format, betterWhen: m.betterWhen }) : "\u2014";
+var change = (m) => m.delta ? /* @__PURE__ */ jsx(DeltaText, { value: m.delta.value, format: m.delta.format ?? m.format, betterWhen: m.betterWhen }) : "\u2014";
 var trendOf = (m) => (m.trend ?? []).map(({ y }) => ({ value: y }));
 function DocKpiScorecard({
   title = "\u4E3B\u8981\u6307\u6A19",
@@ -459,7 +402,37 @@ function DocReportHeader({ title, subtitle, period, asOf, author, source }) {
     ) : null
   ] });
 }
+function DocNotesAndSources({ title = "\u6CE8\u8A18\u30FB\u51FA\u5178", headingLevel = 2, notes = [], definitions = [], sources = [] }) {
+  if (notes.length === 0 && definitions.length === 0 && sources.length === 0) return null;
+  const Heading = headingLevel === 3 ? "h3" : "h2";
+  const Sub = headingLevel === 3 ? "h4" : "h3";
+  return /* @__PURE__ */ jsxs("section", { "data-slot": "doc-notes-and-sources", children: [
+    /* @__PURE__ */ jsx(Heading, { children: title }),
+    notes.length > 0 ? /* @__PURE__ */ jsxs("div", { className: "break-inside-avoid", children: [
+      /* @__PURE__ */ jsx(Sub, { children: "\u6CE8\u8A18" }),
+      /* @__PURE__ */ jsx("ol", { children: notes.map((n, i) => /* @__PURE__ */ jsx("li", { children: n }, i)) })
+    ] }) : null,
+    definitions.length > 0 ? /* @__PURE__ */ jsxs("div", { className: "break-inside-avoid", children: [
+      /* @__PURE__ */ jsx(Sub, { children: "\u7528\u8A9E\u306E\u5B9A\u7FA9" }),
+      /* @__PURE__ */ jsx("dl", { className: "m-0", children: definitions.map((d, i) => /* @__PURE__ */ jsxs("div", { className: "break-inside-avoid", children: [
+        /* @__PURE__ */ jsx("dt", { className: "font-semibold", children: d.term }),
+        /* @__PURE__ */ jsx("dd", { className: "m-0", children: d.description })
+      ] }, i)) })
+    ] }) : null,
+    sources.length > 0 ? /* @__PURE__ */ jsxs("div", { className: "break-inside-avoid", children: [
+      /* @__PURE__ */ jsx(Sub, { children: "\u51FA\u5178" }),
+      /* @__PURE__ */ jsx("ul", { children: sources.map((s, i) => /* @__PURE__ */ jsxs("li", { children: [
+        s.name,
+        s.asOf ? /* @__PURE__ */ jsxs("span", { style: { color: "var(--doc-muted)" }, children: [
+          "\uFF08\u30C7\u30FC\u30BF\u6642\u70B9 ",
+          s.asOf,
+          "\uFF09"
+        ] }) : null
+      ] }, i)) })
+    ] }) : null
+  ] });
+}
 
-export { DocActionItems, DocCallout, DocDataTable, DocExecutiveSummary, DocFigure, DocKeyFindings, DocKpiScorecard, DocReportHeader, Document };
+export { DocActionItems, DocCallout, DocDataTable, DocExecutiveSummary, DocFigure, DocKeyFindings, DocKpiScorecard, DocNotesAndSources, DocReportHeader, Document };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map