@cj-tech-master/excelts 9.4.2 → 9.5.0

package/dist/cjs/modules/excel/chart/index.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * Public entry for the excelts chart module.
+ *
+ * Two complementary usage styles are supported:
+ *
+ * 1. **Functional, zero-side-effect** — tree-shakeable access to
+ *    chart builders, renderers, presets and parsers:
+ *    ```ts
+ *    import { buildChartModel, renderChartSvg } from "@cj-tech-master/excelts/chart";
+ *    const model = buildChartModel(options);
+ *    const svg   = renderChartSvg(model);
+ *    ```
+ *    Bundlers drop everything the consumer does not reference.
+ *
+ * 2. **Support installation** — enables `worksheet.addChart()`,
+ *    `workbook.xlsx.writeFile()` chart-cache population, and chart
+ *    reconstruction during XLSX load:
+ *    ```ts
+ *    import { installChartSupport } from "@cj-tech-master/excelts/chart";
+ *    installChartSupport();                    // once, at startup
+ *    worksheet.addChart(options, "A1:D20");    // now works
+ *    ```
+ *
+ * Chart support is **never installed implicitly** — consumers pay for
+ * what they ask for. The package's root `sideEffects: false` contract
+ * stays intact, so bundles that only use the functional API include
+ * exactly the code paths reachable from the exports they reference.
+ *
+ * `installChartSupport` lives in a separate module (`./install.ts`) so
+ * its host-registry wiring and the full chart builder/renderer pipeline
+ * don't get pulled in by consumers who only import one or two
+ * functional helpers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setSpPrFill = exports.buildTxPr = exports.buildSpPr = exports.getTxPrColor = exports.getTxPrFontSize = exports.getSpPrPattern = exports.getSpPrGradient = exports.getSpPrLine = exports.getSpPrFillColor = exports.parseTxPr = exports.parseSpPr = exports.resolveTopologyObject = exports.renderChartSvg = exports.renderChartPng = exports.drawChartPdf = exports.buildEffectFilter = exports.buildChartScene = exports.applyAxisTransform = exports.seriesFromColumns = exports.chartOptionsFromTable = exports.chartOptionsFromRows = exports.chartExOptionsFromTable = exports.chartExOptionsFromRows = exports.EXCEL_CHART_PRESETS = exports.EXCEL_CHART_EX_PRESETS = exports.CHART_PRESETS = exports.CHART_EX_PRESETS = exports.applyChartPreset = exports.applyChartExPreset = exports.VECTOR_PDF_CHART_EX_LAYOUT_IDS = exports.renderChartExSvg = exports.renderChartExPng = exports.renderChartEx = exports.drawChartExPdf = exports.canRenderChartExAsVectorPdf = exports.parseChartEx = exports.buildChartExModel = exports.buildChartStyle = exports.parseChartStyle = exports.buildChartColors = exports.parseChartColors = exports.fillStrRef = exports.fillNumRef = exports.fillChartExCaches = exports.fillChartCaches = exports.buildComboChartModel = exports.buildChartModel = exports.Chart = exports.uninstallChartSupport = exports.installChartSupport = void 0;
+exports.setSpPrLine = void 0;
+var install_1 = require("./install");
+Object.defineProperty(exports, "installChartSupport", { enumerable: true, get: function () { return install_1.installChartSupport; } });
+Object.defineProperty(exports, "uninstallChartSupport", { enumerable: true, get: function () { return install_1.uninstallChartSupport; } });
+var chart_1 = require("./chart");
+Object.defineProperty(exports, "Chart", { enumerable: true, get: function () { return chart_1.Chart; } });
+Object.defineProperty(exports, "buildChartModel", { enumerable: true, get: function () { return chart_1.buildChartModel; } });
+var chart_builder_1 = require("./chart-builder");
+Object.defineProperty(exports, "buildComboChartModel", { enumerable: true, get: function () { return chart_builder_1.buildComboChartModel; } });
+var cache_populator_1 = require("./cache-populator");
+Object.defineProperty(exports, "fillChartCaches", { enumerable: true, get: function () { return cache_populator_1.fillChartCaches; } });
+Object.defineProperty(exports, "fillChartExCaches", { enumerable: true, get: function () { return cache_populator_1.fillChartExCaches; } });
+Object.defineProperty(exports, "fillNumRef", { enumerable: true, get: function () { return cache_populator_1.fillNumRef; } });
+Object.defineProperty(exports, "fillStrRef", { enumerable: true, get: function () { return cache_populator_1.fillStrRef; } });
+var chart_sidecar_1 = require("./chart-sidecar");
+Object.defineProperty(exports, "parseChartColors", { enumerable: true, get: function () { return chart_sidecar_1.parseChartColors; } });
+Object.defineProperty(exports, "buildChartColors", { enumerable: true, get: function () { return chart_sidecar_1.buildChartColors; } });
+Object.defineProperty(exports, "parseChartStyle", { enumerable: true, get: function () { return chart_sidecar_1.parseChartStyle; } });
+Object.defineProperty(exports, "buildChartStyle", { enumerable: true, get: function () { return chart_sidecar_1.buildChartStyle; } });
+var chart_ex_builder_1 = require("./chart-ex-builder");
+Object.defineProperty(exports, "buildChartExModel", { enumerable: true, get: function () { return chart_ex_builder_1.buildChartExModel; } });
+var chart_ex_parser_1 = require("./chart-ex-parser");
+Object.defineProperty(exports, "parseChartEx", { enumerable: true, get: function () { return chart_ex_parser_1.parseChartEx; } });
+var chart_ex_renderer_1 = require("./chart-ex-renderer");
+Object.defineProperty(exports, "canRenderChartExAsVectorPdf", { enumerable: true, get: function () { return chart_ex_renderer_1.canRenderChartExAsVectorPdf; } });
+Object.defineProperty(exports, "drawChartExPdf", { enumerable: true, get: function () { return chart_ex_renderer_1.drawChartExPdf; } });
+Object.defineProperty(exports, "renderChartEx", { enumerable: true, get: function () { return chart_ex_renderer_1.renderChartEx; } });
+Object.defineProperty(exports, "renderChartExPng", { enumerable: true, get: function () { return chart_ex_renderer_1.renderChartExPng; } });
+Object.defineProperty(exports, "renderChartExSvg", { enumerable: true, get: function () { return chart_ex_renderer_1.renderChartExSvg; } });
+Object.defineProperty(exports, "VECTOR_PDF_CHART_EX_LAYOUT_IDS", { enumerable: true, get: function () { return chart_ex_renderer_1.VECTOR_PDF_CHART_EX_LAYOUT_IDS; } });
+var chart_presets_1 = require("./chart-presets");
+Object.defineProperty(exports, "applyChartExPreset", { enumerable: true, get: function () { return chart_presets_1.applyChartExPreset; } });
+Object.defineProperty(exports, "applyChartPreset", { enumerable: true, get: function () { return chart_presets_1.applyChartPreset; } });
+Object.defineProperty(exports, "CHART_EX_PRESETS", { enumerable: true, get: function () { return chart_presets_1.CHART_EX_PRESETS; } });
+Object.defineProperty(exports, "CHART_PRESETS", { enumerable: true, get: function () { return chart_presets_1.CHART_PRESETS; } });
+Object.defineProperty(exports, "EXCEL_CHART_EX_PRESETS", { enumerable: true, get: function () { return chart_presets_1.EXCEL_CHART_EX_PRESETS; } });
+Object.defineProperty(exports, "EXCEL_CHART_PRESETS", { enumerable: true, get: function () { return chart_presets_1.EXCEL_CHART_PRESETS; } });
+var chart_api_1 = require("./chart-api");
+Object.defineProperty(exports, "chartExOptionsFromRows", { enumerable: true, get: function () { return chart_api_1.chartExOptionsFromRows; } });
+Object.defineProperty(exports, "chartExOptionsFromTable", { enumerable: true, get: function () { return chart_api_1.chartExOptionsFromTable; } });
+Object.defineProperty(exports, "chartOptionsFromRows", { enumerable: true, get: function () { return chart_api_1.chartOptionsFromRows; } });
+Object.defineProperty(exports, "chartOptionsFromTable", { enumerable: true, get: function () { return chart_api_1.chartOptionsFromTable; } });
+Object.defineProperty(exports, "seriesFromColumns", { enumerable: true, get: function () { return chart_api_1.seriesFromColumns; } });
+var chart_renderer_1 = require("./chart-renderer");
+Object.defineProperty(exports, "applyAxisTransform", { enumerable: true, get: function () { return chart_renderer_1.applyAxisTransform; } });
+Object.defineProperty(exports, "buildChartScene", { enumerable: true, get: function () { return chart_renderer_1.buildChartScene; } });
+Object.defineProperty(exports, "buildEffectFilter", { enumerable: true, get: function () { return chart_renderer_1.buildEffectFilter; } });
+Object.defineProperty(exports, "drawChartPdf", { enumerable: true, get: function () { return chart_renderer_1.drawChartPdf; } });
+Object.defineProperty(exports, "renderChartPng", { enumerable: true, get: function () { return chart_renderer_1.renderChartPng; } });
+Object.defineProperty(exports, "renderChartSvg", { enumerable: true, get: function () { return chart_renderer_1.renderChartSvg; } });
+var topojson_1 = require("./topojson");
+Object.defineProperty(exports, "resolveTopologyObject", { enumerable: true, get: function () { return topojson_1.resolveTopologyObject; } });
+var shape_properties_1 = require("./shape-properties");
+Object.defineProperty(exports, "parseSpPr", { enumerable: true, get: function () { return shape_properties_1.parseSpPr; } });
+Object.defineProperty(exports, "parseTxPr", { enumerable: true, get: function () { return shape_properties_1.parseTxPr; } });
+Object.defineProperty(exports, "getSpPrFillColor", { enumerable: true, get: function () { return shape_properties_1.getSpPrFillColor; } });
+Object.defineProperty(exports, "getSpPrLine", { enumerable: true, get: function () { return shape_properties_1.getSpPrLine; } });
+Object.defineProperty(exports, "getSpPrGradient", { enumerable: true, get: function () { return shape_properties_1.getSpPrGradient; } });
+Object.defineProperty(exports, "getSpPrPattern", { enumerable: true, get: function () { return shape_properties_1.getSpPrPattern; } });
+Object.defineProperty(exports, "getTxPrFontSize", { enumerable: true, get: function () { return shape_properties_1.getTxPrFontSize; } });
+Object.defineProperty(exports, "getTxPrColor", { enumerable: true, get: function () { return shape_properties_1.getTxPrColor; } });
+Object.defineProperty(exports, "buildSpPr", { enumerable: true, get: function () { return shape_properties_1.buildSpPr; } });
+Object.defineProperty(exports, "buildTxPr", { enumerable: true, get: function () { return shape_properties_1.buildTxPr; } });
+Object.defineProperty(exports, "setSpPrFill", { enumerable: true, get: function () { return shape_properties_1.setSpPrFill; } });
+Object.defineProperty(exports, "setSpPrLine", { enumerable: true, get: function () { return shape_properties_1.setSpPrLine; } });

package/dist/cjs/modules/excel/chart/install.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Opt-in chart-support installer.
+ *
+ * This file carries the static imports that wire the concrete chart
+ * implementation (cache populator, chart builder, ChartEx builder,
+ * preset engine, sidecar serialisers, `Chart` class and chart-api
+ * helpers) into the excel host. Keep these imports isolated in a
+ * separate module so callers who import only the types, the SVG/PNG
+ * renderers, or the parser from `./index` do not trigger the entire
+ * builder pipeline at bundle time.
+ *
+ * A single process-wide slot is populated:
+ *
+ * - The chart-support slot (`@excel/chart-host-registry`) — enables
+ *   `worksheet.addChart()`, `worksheet.addLineChart()`, chart cache
+ *   population during `workbook.xlsx.writeFile()`, and `Chart`
+ *   reconstruction during XLSX load.
+ *
+ * The slot accepts `null` to uninstall. See
+ * {@link uninstallChartSupport} for tests that need to exercise the
+ * "no chart support" error path.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installChartSupport = installChartSupport;
+exports.uninstallChartSupport = uninstallChartSupport;
+const chart_host_registry_1 = require("../chart-host-registry");
+const chart_space_xform_1 = require("../xlsx/xform/chart/chart-space-xform");
+const cache_populator_1 = require("./cache-populator");
+const chart_1 = require("./chart");
+const chart_api_1 = require("./chart-api");
+const chart_builder_1 = require("./chart-builder");
+const chart_ex_builder_1 = require("./chart-ex-builder");
+const chart_ex_parser_1 = require("./chart-ex-parser");
+const chart_ex_renderer_1 = require("./chart-ex-renderer");
+const chart_images_1 = require("./chart-images");
+const chart_presets_1 = require("./chart-presets");
+const chart_renderer_1 = require("./chart-renderer");
+const chart_sidecar_1 = require("./chart-sidecar");
+const chart_utils_1 = require("./chart-utils");
+/**
+ * Install the chart runtime into the excel host.
+ *
+ * After calling this once, chart-manipulating APIs on `Worksheet`,
+ * `Workbook` and `Chartsheet` run the full chart builder and renderer
+ * pipeline instead of throwing. Subsequently-loaded workbooks also
+ * reconstruct `Chart` instances for their existing charts so consumer
+ * code can inspect / mutate them.
+ *
+ * Safe to call more than once — the registry accepts the last
+ * registration. Calling is idempotent and cheap; no shared state is
+ * mutated beyond the host-registry slot.
+ */
+function installChartSupport() {
+    const support = {
+        buildChartModel: chart_builder_1.buildChartModel,
+        buildComboChartModel: chart_builder_1.buildComboChartModel,
+        buildChartExModel: chart_ex_builder_1.buildChartExModel,
+        applyChartPreset: chart_presets_1.applyChartPreset,
+        applyChartExPreset: chart_presets_1.applyChartExPreset,
+        fillChartCaches: cache_populator_1.fillChartCaches,
+        fillChartExCaches: cache_populator_1.fillChartExCaches,
+        resolvePendingChartImages: chart_images_1.resolvePendingChartImages,
+        buildChartStyle: chart_sidecar_1.buildChartStyle,
+        buildChartColors: chart_sidecar_1.buildChartColors,
+        createChart: (worksheet, ids, range) => new chart_1.Chart(worksheet, ids, range),
+        chartOptionsFromTable: chart_api_1.chartOptionsFromTable,
+        chartOptionsFromRows: chart_api_1.chartOptionsFromRows,
+        chartExOptionsFromTable: chart_api_1.chartExOptionsFromTable,
+        chartExOptionsFromRows: chart_api_1.chartExOptionsFromRows,
+        seriesFromColumns: chart_api_1.seriesFromColumns,
+        parseChartEx: chart_ex_parser_1.parseChartEx,
+        renderChartEx: chart_ex_renderer_1.renderChartEx,
+        renderChartExLegendXml: chart_ex_renderer_1.renderChartExLegendXml,
+        rewriteChartExDataRefsToDefinedNames: chart_ex_renderer_1.rewriteChartExDataRefsToDefinedNames,
+        themeIndexToName: chart_utils_1.themeIndexToName,
+        createChartSpaceXform: () => new chart_space_xform_1.ChartSpaceXform(),
+        drawChartPdf: chart_renderer_1.drawChartPdf,
+        drawChartExPdf: chart_ex_renderer_1.drawChartExPdf,
+        renderChartPng: chart_renderer_1.renderChartPng,
+        renderChartExPng: chart_ex_renderer_1.renderChartExPng,
+        canRenderChartExAsVectorPdf: chart_ex_renderer_1.canRenderChartExAsVectorPdf
+    };
+    (0, chart_host_registry_1.registerChartSupport)(support);
+}
+/**
+ * Uninstall the chart runtime, restoring the cold-start state where
+ * chart-manipulating APIs throw. Mainly useful for tests that exercise
+ * the "no chart support" error path. In production, calling this is
+ * rarely necessary — subsequent `installChartSupport()` calls simply
+ * overwrite the previous registration.
+ */
+function uninstallChartSupport() {
+    (0, chart_host_registry_1.registerChartSupport)(null);
+}