@lionad/cx-comps-tanstack-charts 0.1.0-alpha.29 → 0.1.0-alpha.31

package/dist/index.mjs

@@ -404,9 +404,9 @@ function translateAxis(spec, fallbackKind) {
 //#region src/shared/translate/geometry.ts
 /**
 * 占位几何检测：LLM 在数据集缺席时可能产出 geometry 为占位字符串的示意 spec
-* （如 "…（命名数据集）…"）。翻译层与渲染层对缺失数据容错回退空数组，占位字符串
-* 则被库静默忽略——两者都渲染为空壳 svg 且无任何反馈。本模块提供「数据集整体
-* 不可渲染」的判定与翻译期警告，让空壳显式化为空态反馈。
+* （如 "…（命名数据集）…"），或只引用不提供数据集（resolveMarkData 回退空数组）。
+* 翻译层与渲染层对这些形态容错回退，占位字符串则被库静默忽略——都渲染为空壳
+* svg 且无任何反馈。本模块提供「渲染必然空壳」的判定与翻译期警告，让空壳显式化。
 *
 * 流式安全性：占位字符串只可能出现在完整闭合的 JSON 中（流式截断停在字符层，
 * 截断帧不可解析即不会产出 spec），检测不存在流式中间态误报面。
@@ -428,16 +428,31 @@ function isPlaceholderGeometryDataset(rows) {
 	});
 }
 /**
-* 组件层空态判定：数据集表中存在 GeoJSON 形态数据集，且全部占位。
-* 存在任一可用数据集时返回 false（部分数据仍可渲染）。
+* 组件层空态判定：整图渲染必然空壳时为 true。
+*
+* 判定范围收敛在纯 geoShape 图（全部 marks 均为 geoShape）：geoShape 无独立于数据
+* 的渲染力（数据不可用即零图元），而其余 mark 类型总有独立形状；复合图只要存在
+* 一个非 geoShape mark 或一个可用 geo 数据集就返回 false，防「部分可渲染却整体
+* 空态」的误杀。覆盖三种不可用形态：
+* - 命名数据集占位（geometry 占位字符串/全 null）
+* - 命名数据集缺失（只引用不提供，resolveMarkData 回退空数组）
+* - mark 内联 data 数组本身占位（不占命名数据集表的形态）
 */
-function hasOnlyPlaceholderGeometry(datasets) {
-	if (!datasets) return false;
-	const geoSets = Object.values(datasets).filter((arr) => arr !== void 0 && isFeatureArray(arr));
-	return geoSets.length > 0 && geoSets.every((arr) => isPlaceholderGeometryDataset(arr));
+function isPlaceholderChartRender(spec, datasets) {
+	const marks = spec?.marks;
+	if (!marks?.length) return false;
+	if (marks.some((mark) => mark.type !== "geoShape")) return false;
+	return marks.every((mark) => {
+		const rows = typeof mark.data === "string" ? datasets?.[mark.data] : mark.data;
+		if (rows === void 0 || rows === null) return true;
+		if (!Array.isArray(rows)) return false;
+		if (rows.length === 0) return true;
+		return isPlaceholderGeometryDataset(rows);
+	});
 }
-/** 翻译期警告去重：同数组引用只警告一次（Vue computed 重算与多 mark 共享数据集会重复调用） */
-const warned = /* @__PURE__ */ new WeakSet();
+/** 翻译期警告去重：数组引用（占位）与数据集名（缺失）各自只警告一次 */
+const warnedRows = /* @__PURE__ */ new WeakSet();
+const warnedMissing = /* @__PURE__ */ new Set();
 /**
 * 翻译期占位几何警告：数据集整体占位时 console.warn 指出空壳根因与修复方向。
 * 只挂在 geoShape（占位字符串的高发地——示意 spec 的外部轮廓数据集）；普通 mark
@@ -445,10 +460,20 @@ const warned = /* @__PURE__ */ new WeakSet();
 * （新引用）视为新数据集重新警告。
 */
 function warnPlaceholderGeometry(rows, datasetName, markType) {
-	if (!isPlaceholderGeometryDataset(rows) || warned.has(rows)) return;
-	warned.add(rows);
+	if (!isPlaceholderGeometryDataset(rows) || warnedRows.has(rows)) return;
+	warnedRows.add(rows);
 	console.warn(`[cx-charts] ${markType} 数据集${datasetName ? ` "${datasetName}"` : ""} 的 geometry 全部缺失或为占位字符串，渲染为空壳——须以真实 GeoJSON 数据集整体替换示意占位（技能侧见「数据供给」表）。`);
 }
+/**
+* 翻译期数据集缺失警告：geoShape 按名引用了数据集表中不存在的键——与占位字符串
+* 同为「渲染空壳无反馈」的事故形态，区别只在根因（未提供 vs 提供了占位）。
+* 按名去重（缺失数据集无内容引用可作 WeakSet 键），命名数据集到达后不再命中。
+*/
+function warnMissingGeometryDataset(datasetName, markType) {
+	if (warnedMissing.has(datasetName)) return;
+	warnedMissing.add(datasetName);
+	console.warn(`[cx-charts] ${markType} 引用的数据集 "${datasetName}" 不存在，渲染为空壳——数据集须随物料 data 顶层提供（GenUI 数据顶层化契约）。`);
+}
 //#endregion
 //#region src/shared/translate/transforms.ts
 /**
@@ -1282,7 +1307,9 @@ const GEO_PROJECTION_FACTORIES = {
 /** geoShape：projection 名称枚举 → descriptor {type, fit, inset}；fit:'data' 由库拟合数据本体，{data:'<name>'} 拟合另一命名数据集 */
 function translateGeoShape(spec, datasets) {
 	const rows = resolveMarkData(spec.data, datasets);
-	warnPlaceholderGeometry(rows, typeof spec.data === "string" ? spec.data : void 0, "geoShape");
+	const datasetName = typeof spec.data === "string" ? spec.data : void 0;
+	if (datasetName && rows.length === 0 && !datasets?.[datasetName]) warnMissingGeometryDataset(datasetName, "geoShape");
+	else warnPlaceholderGeometry(rows, datasetName, "geoShape");
 	const projectionName = spec.projection ?? "mercator";
 	if (typeof projectionName === "object") throw new Error("translateGeoShape: projection {$by} 仅允许出现在 facet chart 子模板内");
 	const factory = GEO_PROJECTION_FACTORIES[projectionName];
@@ -1732,7 +1759,8 @@ const _sfc_main$5 = /*@__PURE__*/ defineComponent({
 		const { spec, datasets, hostProps, ariaLabel } = useChartProps(attrs);
 		const definition = computed(() => translateChartSpec(spec.value, datasets.value));
 		const isStreaming = computed(() => streamingFields(attrs).includes("definition"));
-		const hasPlaceholderGeometry = computed(() => hasOnlyPlaceholderGeometry(datasets.value));
+		const hasStreamingFields = computed(() => streamingFields(attrs).length > 0);
+		const hasPlaceholderGeometry = computed(() => !hasStreamingFields.value && isPlaceholderChartRender(spec.value, datasets.value));
 		const skeletonHeight = computed(() => {
 			const h = Number(attrs.height);
 			return Number.isFinite(h) && h > 0 ? h : 320;
@@ -2556,4 +2584,4 @@ const CxTanstackChartsBundle = {
 	materials: [...CxTanstackCharts]
 };
 //#endregion
-export { COMPOSITE_TYPES, CX_CHART_CURVE_NAMES, CxTanstackCharts, area_default as CxTanstackChartsArea, bar_default as CxTanstackChartsBar, CxTanstackChartsBundle, chart_default as CxTanstackChartsChart, dot_default as CxTanstackChartsDot, line_default as CxTanstackChartsLine, pie_default as CxTanstackChartsPie, POLAR_FAMILY_TYPES, TANSTACK_CHARTS_STREAM_TRIGGERS, applyTransforms, createTanstackChartsTriggerRegistry, hasOnlyPlaceholderGeometry, isPlaceholderGeometryDataset, mainArrayOf, resolveMarkData, resolveRScaleOption, translateAxis, translateChartSpec, translateCompositeMark, translateCurve, translateMark, translateOutputs, translatePie, translatePolar, translateReduce, translateScale, translateTransform, warnPlaceholderGeometry };
+export { COMPOSITE_TYPES, CX_CHART_CURVE_NAMES, CxTanstackCharts, area_default as CxTanstackChartsArea, bar_default as CxTanstackChartsBar, CxTanstackChartsBundle, chart_default as CxTanstackChartsChart, dot_default as CxTanstackChartsDot, line_default as CxTanstackChartsLine, pie_default as CxTanstackChartsPie, POLAR_FAMILY_TYPES, TANSTACK_CHARTS_STREAM_TRIGGERS, applyTransforms, createTanstackChartsTriggerRegistry, isPlaceholderChartRender, isPlaceholderGeometryDataset, mainArrayOf, resolveMarkData, resolveRScaleOption, translateAxis, translateChartSpec, translateCompositeMark, translateCurve, translateMark, translateOutputs, translatePie, translatePolar, translateReduce, translateScale, translateTransform, warnMissingGeometryDataset, warnPlaceholderGeometry };

package/dist/shared/translate/geometry.d.ts

@@ -1,4 +1,4 @@
-import type { CxChartDatasets } from './types';
+import type { CxChartDatasets, CxChartSpec } from './types';
 /**
  * 单数据集整体不可渲染判定：Feature 数组且全部条目几何缺失或为占位字符串。
  * 混合场景（部分真实几何）不算——部分数据仍可渲染，整体空态会误杀；
@@ -6,10 +6,17 @@ import type { CxChartDatasets } from './types';
  */
 export declare function isPlaceholderGeometryDataset(rows: readonly unknown[]): boolean;
 /**
- * 组件层空态判定：数据集表中存在 GeoJSON 形态数据集，且全部占位。
- * 存在任一可用数据集时返回 false（部分数据仍可渲染）。
+ * 组件层空态判定：整图渲染必然空壳时为 true。
+ *
+ * 判定范围收敛在纯 geoShape 图（全部 marks 均为 geoShape）：geoShape 无独立于数据
+ * 的渲染力（数据不可用即零图元），而其余 mark 类型总有独立形状；复合图只要存在
+ * 一个非 geoShape mark 或一个可用 geo 数据集就返回 false，防「部分可渲染却整体
+ * 空态」的误杀。覆盖三种不可用形态：
+ * - 命名数据集占位（geometry 占位字符串/全 null）
+ * - 命名数据集缺失（只引用不提供，resolveMarkData 回退空数组）
+ * - mark 内联 data 数组本身占位（不占命名数据集表的形态）
  */
-export declare function hasOnlyPlaceholderGeometry(datasets: CxChartDatasets): boolean;
+export declare function isPlaceholderChartRender(spec: CxChartSpec | undefined, datasets: CxChartDatasets | undefined): boolean;
 /**
  * 翻译期占位几何警告：数据集整体占位时 console.warn 指出空壳根因与修复方向。
  * 只挂在 geoShape（占位字符串的高发地——示意 spec 的外部轮廓数据集）；普通 mark
@@ -17,3 +24,9 @@ export declare function hasOnlyPlaceholderGeometry(datasets: CxChartDatasets): b
  * （新引用）视为新数据集重新警告。
  */
 export declare function warnPlaceholderGeometry(rows: readonly unknown[], datasetName: string | undefined, markType: string): void;
+/**
+ * 翻译期数据集缺失警告：geoShape 按名引用了数据集表中不存在的键——与占位字符串
+ * 同为「渲染空壳无反馈」的事故形态，区别只在根因（未提供 vs 提供了占位）。
+ * 按名去重（缺失数据集无内容引用可作 WeakSet 键），命名数据集到达后不再命中。
+ */
+export declare function warnMissingGeometryDataset(datasetName: string, markType: string): void;

package/dist/shared/translate/index.d.ts

@@ -8,7 +8,7 @@ export type { CxChartAxisSpec, CxChartCurveName, CxChartDatasets, CxChartForceSp
 export { CX_CHART_CURVE_NAMES, translateCurve } from './curve';
 export { translateScale } from './scale';
 export { translateAxis } from './axis';
-export { hasOnlyPlaceholderGeometry, isPlaceholderGeometryDataset, warnPlaceholderGeometry } from './geometry';
+export { isPlaceholderChartRender, isPlaceholderGeometryDataset, warnMissingGeometryDataset, warnPlaceholderGeometry, } from './geometry';
 export { resolveMarkData, resolveRScaleOption, translateMark } from './mark';
 export { applyTransforms, translateOutputs, translateReduce, translateTransform } from './transforms';
 export { POLAR_FAMILY_TYPES, translatePie, translatePolar } from './polar';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lionad/cx-comps-tanstack-charts",
-  "version": "0.1.0-alpha.29",
+  "version": "0.1.0-alpha.31",
   "description": "cx material components wrapping TanStack Charts (@tanstack/charts/vue)",
   "keywords": [
     "charts",
@@ -34,14 +34,10 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "vp pack && vue-tsc -p tsconfig.build.json",
-    "typecheck": "vue-tsgo --tsdk ../../node_modules/.pnpm/typescript@7.0.2/node_modules/typescript --noEmit"
-  },
   "dependencies": {
-    "@lionad/cx-definition": "workspace:*",
-    "@lionad/cx-stream": "workspace:*",
-    "@lionad/cx-vue": "workspace:*",
+    "@lionad/cx-definition": "0.1.0-alpha.10",
+    "@lionad/cx-stream": "0.1.0-alpha.14",
+    "@lionad/cx-vue": "0.1.0-alpha.11",
     "d3-geo": "^3.1.1",
     "d3-scale": "^4.0.2",
     "d3-shape": "^3.2.0"
@@ -60,5 +56,9 @@
     "@tanstack/charts": "^0.14.0",
     "@vueuse/core": "^13.0.0 || ^14.0.0",
     "vue": "^3.5.0"
+  },
+  "scripts": {
+    "build": "vp pack && vue-tsc -p tsconfig.build.json",
+    "typecheck": "vue-tsgo --tsdk ../../node_modules/.pnpm/typescript@7.0.2/node_modules/typescript --noEmit"
   }
-}
+}