@buildcanada/charts 0.3.7 → 0.3.8

package/dist/components/reactUtil.d.ts

@@ -0,0 +1,2 @@
+export declare const reactRenderToStringClientOnly: (element: React.ReactElement) => string;
+//# sourceMappingURL=reactUtil.d.ts.map

package/dist/components/reactUtil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactUtil.d.ts","sourceRoot":"","sources":["../../src/components/reactUtil.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,6BAA6B,GACtC,SAAS,KAAK,CAAC,YAAY,KAC5B,MAcF,CAAA"}

package/dist/components/reactUtil.js

@@ -0,0 +1,18 @@
+import { createRoot } from "react-dom/client";
+import { flushSync } from "react-dom";
+const reactRenderToStringClientOnly = (element) => {
+  if (typeof document === "undefined") {
+    throw new Error(
+      "reactRenderToStringClientOnly can only be used in a browser environment"
+    );
+  }
+  const div = document.createElement("div");
+  const root = createRoot(div);
+  flushSync(() => root.render(element));
+  const html = div.innerHTML;
+  root.unmount();
+  return html;
+};
+export {
+  reactRenderToStringClientOnly
+};

package/dist/components/reactUtil.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/components/reactUtil.ts"],
+  "sourcesContent": ["import { createRoot } from \"react-dom/client\"\nimport { flushSync } from \"react-dom\"\n\nexport const reactRenderToStringClientOnly = (\n    element: React.ReactElement\n): string => {\n    if (typeof document === \"undefined\") {\n        throw new Error(\n            \"reactRenderToStringClientOnly can only be used in a browser environment\"\n        )\n    }\n\n    // This is the React-recommended way of rendering a component to HTML on the client-side, see https://react.dev/reference/react-dom/server/renderToString#removing-rendertostring-from-the-client-code\n    const div = document.createElement(\"div\")\n    const root = createRoot(div)\n    flushSync(() => root.render(element))\n    const html = div.innerHTML\n    root.unmount()\n    return html\n}\n"],
+  "mappings": "AAAA,SAAS,kBAAkB;AAC3B,SAAS,iBAAiB;AAEnB,MAAM,gCAAgC,CACzC,YACS;AACT,MAAI,OAAO,aAAa,aAAa;AACjC,UAAM,IAAI;AAAA,MACN;AAAA,IACJ;AAAA,EACJ;AAGA,QAAM,MAAM,SAAS,cAAc,KAAK;AACxC,QAAM,OAAO,WAAW,GAAG;AAC3B,YAAU,MAAM,KAAK,OAAO,OAAO,CAAC;AACpC,QAAM,OAAO,IAAI;AACjB,OAAK,QAAQ;AACb,SAAO;AACX;",
+  "names": []
+}

package/dist/components/stubs/CodeSnippet.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Stub component for CodeSnippet.
+ * This is a placeholder - the consuming application should provide
+ * its own implementation if code snippet functionality is needed.
+ */
+import React from "react";
+export interface CodeSnippetProps {
+    code: string;
+    language?: string;
+}
+export declare function CodeSnippet({ code }: CodeSnippetProps): React.ReactElement;
+//# sourceMappingURL=CodeSnippet.d.ts.map

package/dist/components/stubs/CodeSnippet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeSnippet.d.ts","sourceRoot":"","sources":["../../../src/components/stubs/CodeSnippet.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,gBAAgB,GAAG,KAAK,CAAC,YAAY,CAM1E"}

package/dist/components/stubs/CodeSnippet.js

@@ -0,0 +1,7 @@
+import React from "react";
+function CodeSnippet({ code }) {
+  return /* @__PURE__ */ React.createElement("pre", { style: { background: "#f5f5f5", padding: "1rem", overflow: "auto" } }, /* @__PURE__ */ React.createElement("code", null, code));
+}
+export {
+  CodeSnippet
+};

package/dist/components/stubs/CodeSnippet.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/components/stubs/CodeSnippet.tsx"],
+  "sourcesContent": ["/**\n * Stub component for CodeSnippet.\n * This is a placeholder - the consuming application should provide\n * its own implementation if code snippet functionality is needed.\n */\nimport React from \"react\"\n\nexport interface CodeSnippetProps {\n    code: string\n    language?: string\n}\n\nexport function CodeSnippet({ code }: CodeSnippetProps): React.ReactElement {\n    return (\n        <pre style={{ background: \"#f5f5f5\", padding: \"1rem\", overflow: \"auto\" }}>\n            <code>{code}</code>\n        </pre>\n    )\n}\n"],
+  "mappings": "AAKA,OAAO,WAAW;AAOX,SAAS,YAAY,EAAE,KAAK,GAAyC;AACxE,SACI,oCAAC,SAAI,OAAO,EAAE,YAAY,WAAW,SAAS,QAAQ,UAAU,OAAO,KACnE,oCAAC,cAAM,IAAK,CAChB;AAER;",
+  "names": []
+}

package/dist/components/stubs/DataCitation.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Stub component for DataCitation.
+ * This is a placeholder for data page functionality.
+ */
+import React from "react";
+export interface DataCitationProps {
+    citation?: string;
+    citationShort?: string;
+    citationLong?: string;
+    [key: string]: unknown;
+}
+export declare function DataCitation(_props: DataCitationProps): React.ReactElement | null;
+//# sourceMappingURL=DataCitation.d.ts.map

package/dist/components/stubs/DataCitation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataCitation.d.ts","sourceRoot":"","sources":["../../../src/components/stubs/DataCitation.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACzB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAEjF"}

package/dist/components/stubs/DataCitation.js

@@ -0,0 +1,6 @@
+function DataCitation(_props) {
+  return null;
+}
+export {
+  DataCitation
+};

package/dist/components/stubs/DataCitation.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/components/stubs/DataCitation.tsx"],
+  "sourcesContent": ["/**\n * Stub component for DataCitation.\n * This is a placeholder for data page functionality.\n */\nimport React from \"react\"\n\nexport interface DataCitationProps {\n    citation?: string\n    citationShort?: string\n    citationLong?: string\n    [key: string]: unknown\n}\n\nexport function DataCitation(_props: DataCitationProps): React.ReactElement | null {\n    return null\n}\n"],
+  "mappings": "AAaO,SAAS,aAAa,QAAsD;AAC/E,SAAO;AACX;",
+  "names": []
+}

package/dist/components/stubs/IndicatorKeyData.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Stub functions for IndicatorKeyData.
+ * These are placeholders for data page functionality.
+ */
+import React from "react";
+export interface KeyDataItem {
+    label: string;
+    value: React.ReactNode;
+}
+export declare function makeSource(_source: unknown): any;
+export declare function makeLastUpdated(_date: unknown): any;
+export declare function makeNextUpdate(_date: unknown): any;
+export declare function makeDateRange(_range: unknown): any;
+export declare function makeUnit(_unit: unknown): any;
+export declare function makeUnitConversionFactor(_factor: unknown): any;
+export declare function makeLinks(_links: unknown): any;
+//# sourceMappingURL=IndicatorKeyData.d.ts.map

package/dist/components/stubs/IndicatorKeyData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndicatorKeyData.d.ts","sourceRoot":"","sources":["../../../src/components/stubs/IndicatorKeyData.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,MAAM,WAAW,WAAW;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;CACzB;AAGD,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,GAAG,CAEhD;AAGD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAEnD;AAGD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAElD;AAGD,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,GAAG,CAElD;AAGD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAE5C;AAGD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,GAAG,CAE9D;AAGD,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,GAAG,CAE9C"}

package/dist/components/stubs/IndicatorKeyData.js

@@ -0,0 +1,30 @@
+function makeSource(_source) {
+  return null;
+}
+function makeLastUpdated(_date) {
+  return null;
+}
+function makeNextUpdate(_date) {
+  return null;
+}
+function makeDateRange(_range) {
+  return null;
+}
+function makeUnit(_unit) {
+  return null;
+}
+function makeUnitConversionFactor(_factor) {
+  return null;
+}
+function makeLinks(_links) {
+  return null;
+}
+export {
+  makeDateRange,
+  makeLastUpdated,
+  makeLinks,
+  makeNextUpdate,
+  makeSource,
+  makeUnit,
+  makeUnitConversionFactor
+};

package/dist/components/stubs/IndicatorKeyData.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/components/stubs/IndicatorKeyData.tsx"],
+  "sourcesContent": ["/**\n * Stub functions for IndicatorKeyData.\n * These are placeholders for data page functionality.\n */\nimport React from \"react\"\n\nexport interface KeyDataItem {\n    label: string\n    value: React.ReactNode\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function makeSource(_source: unknown): any {\n    return null\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function makeLastUpdated(_date: unknown): any {\n    return null\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function makeNextUpdate(_date: unknown): any {\n    return null\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function makeDateRange(_range: unknown): any {\n    return null\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function makeUnit(_unit: unknown): any {\n    return null\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function makeUnitConversionFactor(_factor: unknown): any {\n    return null\n}\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function makeLinks(_links: unknown): any {\n    return null\n}\n"],
+  "mappings": "AAYO,SAAS,WAAW,SAAuB;AAC9C,SAAO;AACX;AAGO,SAAS,gBAAgB,OAAqB;AACjD,SAAO;AACX;AAGO,SAAS,eAAe,OAAqB;AAChD,SAAO;AACX;AAGO,SAAS,cAAc,QAAsB;AAChD,SAAO;AACX;AAGO,SAAS,SAAS,OAAqB;AAC1C,SAAO;AACX;AAGO,SAAS,yBAAyB,SAAuB;AAC5D,SAAO;AACX;AAGO,SAAS,UAAU,QAAsB;AAC5C,SAAO;AACX;",
+  "names": []
+}

package/dist/components/stubs/IndicatorProcessing.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Stub component for IndicatorProcessing.
+ * This is a placeholder for data page functionality.
+ */
+import React from "react";
+export interface IndicatorProcessingProps {
+    processing?: unknown;
+    descriptionProcessing?: string;
+    [key: string]: unknown;
+}
+export declare function IndicatorProcessing(_props: IndicatorProcessingProps): React.ReactElement | null;
+//# sourceMappingURL=IndicatorProcessing.d.ts.map

package/dist/components/stubs/IndicatorProcessing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndicatorProcessing.d.ts","sourceRoot":"","sources":["../../../src/components/stubs/IndicatorProcessing.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,MAAM,WAAW,wBAAwB;IACrC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACzB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,wBAAwB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAE/F"}

package/dist/components/stubs/IndicatorProcessing.js

@@ -0,0 +1,6 @@
+function IndicatorProcessing(_props) {
+  return null;
+}
+export {
+  IndicatorProcessing
+};

package/dist/components/stubs/IndicatorProcessing.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/components/stubs/IndicatorProcessing.tsx"],
+  "sourcesContent": ["/**\n * Stub component for IndicatorProcessing.\n * This is a placeholder for data page functionality.\n */\nimport React from \"react\"\n\nexport interface IndicatorProcessingProps {\n    processing?: unknown\n    descriptionProcessing?: string\n    [key: string]: unknown\n}\n\nexport function IndicatorProcessing(_props: IndicatorProcessingProps): React.ReactElement | null {\n    return null\n}\n"],
+  "mappings": "AAYO,SAAS,oBAAoB,QAA6D;AAC7F,SAAO;AACX;",
+  "names": []
+}

package/dist/components/stubs/IndicatorSources.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Stub component for IndicatorSources.
+ * This is a placeholder for data page functionality.
+ */
+import React from "react";
+export interface IndicatorSourcesProps {
+    sources?: unknown[];
+    isEmbeddedInADataPage?: boolean;
+    [key: string]: unknown;
+}
+export declare function IndicatorSources(_props: IndicatorSourcesProps): React.ReactElement | null;
+//# sourceMappingURL=IndicatorSources.d.ts.map

package/dist/components/stubs/IndicatorSources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndicatorSources.d.ts","sourceRoot":"","sources":["../../../src/components/stubs/IndicatorSources.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,MAAM,WAAW,qBAAqB;IAClC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACnB,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACzB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,qBAAqB,GAAG,KAAK,CAAC,YAAY,GAAG,IAAI,CAEzF"}

package/dist/components/stubs/IndicatorSources.js

@@ -0,0 +1,6 @@
+function IndicatorSources(_props) {
+  return null;
+}
+export {
+  IndicatorSources
+};

package/dist/components/stubs/IndicatorSources.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/components/stubs/IndicatorSources.tsx"],
+  "sourcesContent": ["/**\n * Stub component for IndicatorSources.\n * This is a placeholder for data page functionality.\n */\nimport React from \"react\"\n\nexport interface IndicatorSourcesProps {\n    sources?: unknown[]\n    isEmbeddedInADataPage?: boolean\n    [key: string]: unknown\n}\n\nexport function IndicatorSources(_props: IndicatorSourcesProps): React.ReactElement | null {\n    return null\n}\n"],
+  "mappings": "AAYO,SAAS,iBAAiB,QAA0D;AACvF,SAAO;AACX;",
+  "names": []
+}

package/dist/config/ChartsConfig.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Configuration interface for @buildcanada/charts
+ *
+ * This allows customization of branding, API endpoints, and error handling
+ * to make the library work independently of any specific data provider.
+ */
+export interface ChartsBranding {
+    /**
+     * Text displayed for the license (e.g., "CC BY")
+     * @default "CC BY"
+     */
+    licenseText?: string;
+    /**
+     * URL for the license link
+     * @default "https://creativecommons.org/licenses/by/4.0/"
+     */
+    licenseUrl?: string;
+    /**
+     * Text displayed when showing "Powered by" attribution
+     * @default "Powered by Charts"
+     */
+    poweredByText?: string;
+    /**
+     * URL for the "Powered by" link
+     */
+    poweredByUrl?: string;
+    /**
+     * Support email for error messages
+     */
+    supportEmail?: string;
+    /**
+     * Custom tooltip text for the license/attribution section
+     */
+    licenseTooltip?: string;
+    /**
+     * Custom logos to use in charts
+     */
+    logos?: Record<string, LogoConfig>;
+}
+export interface LogoConfig {
+    svg: string;
+    width: number;
+    height: number;
+    url?: string;
+}
+export interface ChartsDataApi {
+    /**
+     * Base URL for the data API
+     * Example: "https://api.example.com/v1/indicators/"
+     */
+    baseUrl: string;
+    /**
+     * Custom route builder for variable data
+     * If not provided, uses default: `${baseUrl}/${variableId}.data.json`
+     */
+    getVariableDataRoute?: (variableId: number) => string;
+    /**
+     * Custom route builder for variable metadata
+     * If not provided, uses default: `${baseUrl}/${variableId}.metadata.json`
+     */
+    getVariableMetadataRoute?: (variableId: number) => string;
+}
+export interface ChartsErrorReporting {
+    /**
+     * Whether error reporting is enabled
+     */
+    enabled: boolean;
+    /**
+     * Custom error handler function
+     * Use this to integrate with your error tracking service (e.g., Sentry, LogRocket)
+     */
+    handler?: (error: Error, context: Record<string, unknown>) => void;
+}
+export interface ChartsAnalytics {
+    /**
+     * Whether analytics is enabled
+     */
+    enabled: boolean;
+    /**
+     * Custom analytics handler
+     */
+    trackEvent?: (eventName: string, properties: Record<string, unknown>) => void;
+}
+export interface ChartsConfig {
+    /**
+     * Branding configuration for customizing the appearance
+     */
+    branding?: ChartsBranding;
+    /**
+     * Data API configuration
+     */
+    dataApi: ChartsDataApi;
+    /**
+     * Error reporting configuration
+     */
+    errorReporting?: ChartsErrorReporting;
+    /**
+     * Analytics configuration
+     */
+    analytics?: ChartsAnalytics;
+}
+/**
+ * Default configuration values
+ */
+export declare const defaultChartsConfig: Partial<ChartsConfig>;
+/**
+ * Merge user config with defaults
+ */
+export declare function mergeWithDefaults(config: ChartsConfig): Required<ChartsConfig>;
+//# sourceMappingURL=ChartsConfig.d.ts.map

package/dist/config/ChartsConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartsConfig.d.ts","sourceRoot":"","sources":["../../src/config/ChartsConfig.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC3B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CACrC;AAED,MAAM,WAAW,UAAU;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,aAAa;IAC1B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,oBAAoB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAA;IAErD;;;OAGG;IACH,wBAAwB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAA;CAC5D;AAED,MAAM,WAAW,oBAAoB;IACjC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAA;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;CACrE;AAED,MAAM,WAAW,eAAe;IAC5B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAA;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,CACT,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAClC,IAAI,CAAA;CACZ;AAED,MAAM,WAAW,YAAY;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAA;IAEzB;;OAEG;IACH,OAAO,EAAE,aAAa,CAAA;IAEtB;;OAEG;IACH,cAAc,CAAC,EAAE,oBAAoB,CAAA;IAErC;;OAEG;IACH,SAAS,CAAC,EAAE,eAAe,CAAA;CAC9B;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAO,CAAC,YAAY,CAYrD,CAAA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC7B,MAAM,EAAE,YAAY,GACrB,QAAQ,CAAC,YAAY,CAAC,CAgBxB"}

package/dist/config/ChartsConfig.js

@@ -0,0 +1,34 @@
+const defaultChartsConfig = {
+  branding: {
+    licenseText: "CC BY",
+    licenseUrl: "https://creativecommons.org/licenses/by/4.0/",
+    poweredByText: "Powered by Build Canada Charts"
+  },
+  errorReporting: {
+    enabled: false
+  },
+  analytics: {
+    enabled: false
+  }
+};
+function mergeWithDefaults(config) {
+  return {
+    branding: {
+      ...defaultChartsConfig.branding,
+      ...config.branding
+    },
+    dataApi: config.dataApi,
+    errorReporting: {
+      ...defaultChartsConfig.errorReporting,
+      ...config.errorReporting
+    },
+    analytics: {
+      ...defaultChartsConfig.analytics,
+      ...config.analytics
+    }
+  };
+}
+export {
+  defaultChartsConfig,
+  mergeWithDefaults
+};

package/dist/config/ChartsConfig.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/config/ChartsConfig.ts"],
+  "sourcesContent": ["/**\n * Configuration interface for @buildcanada/charts\n *\n * This allows customization of branding, API endpoints, and error handling\n * to make the library work independently of any specific data provider.\n */\n\nexport interface ChartsBranding {\n    /**\n     * Text displayed for the license (e.g., \"CC BY\")\n     * @default \"CC BY\"\n     */\n    licenseText?: string\n\n    /**\n     * URL for the license link\n     * @default \"https://creativecommons.org/licenses/by/4.0/\"\n     */\n    licenseUrl?: string\n\n    /**\n     * Text displayed when showing \"Powered by\" attribution\n     * @default \"Powered by Charts\"\n     */\n    poweredByText?: string\n\n    /**\n     * URL for the \"Powered by\" link\n     */\n    poweredByUrl?: string\n\n    /**\n     * Support email for error messages\n     */\n    supportEmail?: string\n\n    /**\n     * Custom tooltip text for the license/attribution section\n     */\n    licenseTooltip?: string\n\n    /**\n     * Custom logos to use in charts\n     */\n    logos?: Record<string, LogoConfig>\n}\n\nexport interface LogoConfig {\n    svg: string\n    width: number\n    height: number\n    url?: string\n}\n\nexport interface ChartsDataApi {\n    /**\n     * Base URL for the data API\n     * Example: \"https://api.example.com/v1/indicators/\"\n     */\n    baseUrl: string\n\n    /**\n     * Custom route builder for variable data\n     * If not provided, uses default: `${baseUrl}/${variableId}.data.json`\n     */\n    getVariableDataRoute?: (variableId: number) => string\n\n    /**\n     * Custom route builder for variable metadata\n     * If not provided, uses default: `${baseUrl}/${variableId}.metadata.json`\n     */\n    getVariableMetadataRoute?: (variableId: number) => string\n}\n\nexport interface ChartsErrorReporting {\n    /**\n     * Whether error reporting is enabled\n     */\n    enabled: boolean\n\n    /**\n     * Custom error handler function\n     * Use this to integrate with your error tracking service (e.g., Sentry, LogRocket)\n     */\n    handler?: (error: Error, context: Record<string, unknown>) => void\n}\n\nexport interface ChartsAnalytics {\n    /**\n     * Whether analytics is enabled\n     */\n    enabled: boolean\n\n    /**\n     * Custom analytics handler\n     */\n    trackEvent?: (\n        eventName: string,\n        properties: Record<string, unknown>\n    ) => void\n}\n\nexport interface ChartsConfig {\n    /**\n     * Branding configuration for customizing the appearance\n     */\n    branding?: ChartsBranding\n\n    /**\n     * Data API configuration\n     */\n    dataApi: ChartsDataApi\n\n    /**\n     * Error reporting configuration\n     */\n    errorReporting?: ChartsErrorReporting\n\n    /**\n     * Analytics configuration\n     */\n    analytics?: ChartsAnalytics\n}\n\n/**\n * Default configuration values\n */\nexport const defaultChartsConfig: Partial<ChartsConfig> = {\n    branding: {\n        licenseText: \"CC BY\",\n        licenseUrl: \"https://creativecommons.org/licenses/by/4.0/\",\n        poweredByText: \"Powered by Build Canada Charts\",\n    },\n    errorReporting: {\n        enabled: false,\n    },\n    analytics: {\n        enabled: false,\n    },\n}\n\n/**\n * Merge user config with defaults\n */\nexport function mergeWithDefaults(\n    config: ChartsConfig\n): Required<ChartsConfig> {\n    return {\n        branding: {\n            ...defaultChartsConfig.branding,\n            ...config.branding,\n        },\n        dataApi: config.dataApi,\n        errorReporting: {\n            ...defaultChartsConfig.errorReporting,\n            ...config.errorReporting,\n        },\n        analytics: {\n            ...defaultChartsConfig.analytics,\n            ...config.analytics,\n        },\n    } as Required<ChartsConfig>\n}\n"],
+  "mappings": "AA+HO,MAAM,sBAA6C;AAAA,EACtD,UAAU;AAAA,IACN,aAAa;AAAA,IACb,YAAY;AAAA,IACZ,eAAe;AAAA,EACnB;AAAA,EACA,gBAAgB;AAAA,IACZ,SAAS;AAAA,EACb;AAAA,EACA,WAAW;AAAA,IACP,SAAS;AAAA,EACb;AACJ;AAKO,SAAS,kBACZ,QACsB;AACtB,SAAO;AAAA,IACH,UAAU;AAAA,MACN,GAAG,oBAAoB;AAAA,MACvB,GAAG,OAAO;AAAA,IACd;AAAA,IACA,SAAS,OAAO;AAAA,IAChB,gBAAgB;AAAA,MACZ,GAAG,oBAAoB;AAAA,MACvB,GAAG,OAAO;AAAA,IACd;AAAA,IACA,WAAW;AAAA,MACP,GAAG,oBAAoB;AAAA,MACvB,GAAG,OAAO;AAAA,IACd;AAAA,EACJ;AACJ;",
+  "names": []
+}

package/dist/config/ChartsProvider.d.ts

@@ -0,0 +1,89 @@
+import * as React from "react";
+import { ChartsConfig } from "./ChartsConfig.js";
+export interface ChartsProviderProps {
+    /**
+     * Configuration for the charts library
+     */
+    config: ChartsConfig;
+    /**
+     * Child components that will have access to the configuration
+     */
+    children: React.ReactNode;
+}
+/**
+ * Provider component for charts configuration.
+ *
+ * Wrap your application or chart components with this provider to configure
+ * branding, API endpoints, and error handling.
+ *
+ * @example
+ * ```tsx
+ * const config = {
+ *   branding: {
+ *     poweredByText: 'My Organization',
+ *     licenseText: 'CC BY 4.0'
+ *   },
+ *   dataApi: {
+ *     baseUrl: 'https://api.example.com/v1/indicators/'
+ *   }
+ * }
+ *
+ * function App() {
+ *   return (
+ *     <ChartsProvider config={config}>
+ *       <Grapher {...chartProps} />
+ *     </ChartsProvider>
+ *   )
+ * }
+ * ```
+ */
+export declare function ChartsProvider({ config, children, }: ChartsProviderProps): React.ReactElement;
+/**
+ * Hook to access the charts configuration.
+ *
+ * Must be used within a ChartsProvider.
+ *
+ * @throws Error if used outside of ChartsProvider
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const config = useChartsConfig()
+ *   return <div>Powered by: {config.branding.poweredByText}</div>
+ * }
+ * ```
+ */
+export declare function useChartsConfig(): Required<ChartsConfig>;
+/**
+ * Hook to access the charts configuration, returning undefined if not in a provider.
+ *
+ * Use this for optional configuration access where a fallback is acceptable.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const config = useMaybeChartsConfig()
+ *   const brandingText = config?.branding.poweredByText ?? 'Default'
+ *   return <div>Powered by: {brandingText}</div>
+ * }
+ * ```
+ */
+export declare function useMaybeChartsConfig(): Required<ChartsConfig> | undefined;
+/**
+ * Get a fallback configuration for use outside of a provider.
+ *
+ * This creates a minimal configuration with the provided data API URL.
+ * Useful for standalone usage or testing.
+ */
+export declare function createFallbackConfig(dataApiBaseUrl: string): Required<ChartsConfig>;
+/**
+ * Report an error using the configured error handler.
+ *
+ * Falls back to console.error if no handler is configured.
+ */
+export declare function reportError(config: Required<ChartsConfig> | undefined, error: Error, context?: Record<string, unknown>): void;
+/**
+ * Track an analytics event using the configured handler.
+ */
+export declare function trackEvent(config: Required<ChartsConfig> | undefined, eventName: string, properties?: Record<string, unknown>): void;
+//# sourceMappingURL=ChartsProvider.d.ts.map

package/dist/config/ChartsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartsProvider.d.ts","sourceRoot":"","sources":["../../src/config/ChartsProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,OAAO,EACH,YAAY,EAGf,MAAM,mBAAmB,CAAA;AAO1B,MAAM,WAAW,mBAAmB;IAChC;;OAEG;IACH,MAAM,EAAE,YAAY,CAAA;IAEpB;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,cAAc,CAAC,EAC3B,MAAM,EACN,QAAQ,GACX,EAAE,mBAAmB,GAAG,KAAK,CAAC,YAAY,CAQ1C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,IAAI,QAAQ,CAAC,YAAY,CAAC,CAWxD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,IAAI,QAAQ,CAAC,YAAY,CAAC,GAAG,SAAS,CAEzE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAChC,cAAc,EAAE,MAAM,GACvB,QAAQ,CAAC,YAAY,CAAC,CAMxB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACvB,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,SAAS,EAC1C,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACtC,IAAI,CAMN;AAED;;GAEG;AACH,wBAAgB,UAAU,CACtB,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,SAAS,EAC1C,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACzC,IAAI,CAIN"}

package/dist/config/ChartsProvider.js

@@ -0,0 +1,52 @@
+import * as React from "react";
+import { createContext, useContext, useMemo } from "react";
+import {
+  mergeWithDefaults
+} from "./ChartsConfig.js";
+const ChartsContext = createContext(null);
+function ChartsProvider({
+  config,
+  children
+}) {
+  const mergedConfig = useMemo(() => mergeWithDefaults(config), [config]);
+  return /* @__PURE__ */ React.createElement(ChartsContext.Provider, { value: mergedConfig }, children);
+}
+function useChartsConfig() {
+  const config = useContext(ChartsContext);
+  if (!config) {
+    throw new Error(
+      "useChartsConfig must be used within a ChartsProvider. Wrap your component tree with <ChartsProvider config={...}>."
+    );
+  }
+  return config;
+}
+function useMaybeChartsConfig() {
+  return useContext(ChartsContext) ?? void 0;
+}
+function createFallbackConfig(dataApiBaseUrl) {
+  return mergeWithDefaults({
+    dataApi: {
+      baseUrl: dataApiBaseUrl
+    }
+  });
+}
+function reportError(config, error, context = {}) {
+  if (config?.errorReporting?.enabled && config.errorReporting.handler) {
+    config.errorReporting.handler(error, context);
+  } else {
+    console.error("Chart error:", error, context);
+  }
+}
+function trackEvent(config, eventName, properties = {}) {
+  if (config?.analytics?.enabled && config.analytics.trackEvent) {
+    config.analytics.trackEvent(eventName, properties);
+  }
+}
+export {
+  ChartsProvider,
+  createFallbackConfig,
+  reportError,
+  trackEvent,
+  useChartsConfig,
+  useMaybeChartsConfig
+};

package/dist/config/ChartsProvider.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/config/ChartsProvider.tsx"],
+  "sourcesContent": ["import * as React from \"react\"\nimport { createContext, useContext, useMemo } from \"react\"\n\nimport {\n    ChartsConfig,\n    defaultChartsConfig,\n    mergeWithDefaults,\n} from \"./ChartsConfig.js\"\n\n/**\n * Context for charts configuration\n */\nconst ChartsContext = createContext<Required<ChartsConfig> | null>(null)\n\nexport interface ChartsProviderProps {\n    /**\n     * Configuration for the charts library\n     */\n    config: ChartsConfig\n\n    /**\n     * Child components that will have access to the configuration\n     */\n    children: React.ReactNode\n}\n\n/**\n * Provider component for charts configuration.\n *\n * Wrap your application or chart components with this provider to configure\n * branding, API endpoints, and error handling.\n *\n * @example\n * ```tsx\n * const config = {\n *   branding: {\n *     poweredByText: 'My Organization',\n *     licenseText: 'CC BY 4.0'\n *   },\n *   dataApi: {\n *     baseUrl: 'https://api.example.com/v1/indicators/'\n *   }\n * }\n *\n * function App() {\n *   return (\n *     <ChartsProvider config={config}>\n *       <Grapher {...chartProps} />\n *     </ChartsProvider>\n *   )\n * }\n * ```\n */\nexport function ChartsProvider({\n    config,\n    children,\n}: ChartsProviderProps): React.ReactElement {\n    const mergedConfig = useMemo(() => mergeWithDefaults(config), [config])\n\n    return (\n        <ChartsContext.Provider value={mergedConfig}>\n            {children}\n        </ChartsContext.Provider>\n    )\n}\n\n/**\n * Hook to access the charts configuration.\n *\n * Must be used within a ChartsProvider.\n *\n * @throws Error if used outside of ChartsProvider\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const config = useChartsConfig()\n *   return <div>Powered by: {config.branding.poweredByText}</div>\n * }\n * ```\n */\nexport function useChartsConfig(): Required<ChartsConfig> {\n    const config = useContext(ChartsContext)\n\n    if (!config) {\n        throw new Error(\n            \"useChartsConfig must be used within a ChartsProvider. \" +\n                \"Wrap your component tree with <ChartsProvider config={...}>.\"\n        )\n    }\n\n    return config\n}\n\n/**\n * Hook to access the charts configuration, returning undefined if not in a provider.\n *\n * Use this for optional configuration access where a fallback is acceptable.\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const config = useMaybeChartsConfig()\n *   const brandingText = config?.branding.poweredByText ?? 'Default'\n *   return <div>Powered by: {brandingText}</div>\n * }\n * ```\n */\nexport function useMaybeChartsConfig(): Required<ChartsConfig> | undefined {\n    return useContext(ChartsContext) ?? undefined\n}\n\n/**\n * Get a fallback configuration for use outside of a provider.\n *\n * This creates a minimal configuration with the provided data API URL.\n * Useful for standalone usage or testing.\n */\nexport function createFallbackConfig(\n    dataApiBaseUrl: string\n): Required<ChartsConfig> {\n    return mergeWithDefaults({\n        dataApi: {\n            baseUrl: dataApiBaseUrl,\n        },\n    })\n}\n\n/**\n * Report an error using the configured error handler.\n *\n * Falls back to console.error if no handler is configured.\n */\nexport function reportError(\n    config: Required<ChartsConfig> | undefined,\n    error: Error,\n    context: Record<string, unknown> = {}\n): void {\n    if (config?.errorReporting?.enabled && config.errorReporting.handler) {\n        config.errorReporting.handler(error, context)\n    } else {\n        console.error(\"Chart error:\", error, context)\n    }\n}\n\n/**\n * Track an analytics event using the configured handler.\n */\nexport function trackEvent(\n    config: Required<ChartsConfig> | undefined,\n    eventName: string,\n    properties: Record<string, unknown> = {}\n): void {\n    if (config?.analytics?.enabled && config.analytics.trackEvent) {\n        config.analytics.trackEvent(eventName, properties)\n    }\n}\n"],
+  "mappings": "AAAA,YAAY,WAAW;AACvB,SAAS,eAAe,YAAY,eAAe;AAEnD;AAAA,EAGI;AAAA,OACG;AAKP,MAAM,gBAAgB,cAA6C,IAAI;AAyChE,SAAS,eAAe;AAAA,EAC3B;AAAA,EACA;AACJ,GAA4C;AACxC,QAAM,eAAe,QAAQ,MAAM,kBAAkB,MAAM,GAAG,CAAC,MAAM,CAAC;AAEtE,SACI,oCAAC,cAAc,UAAd,EAAuB,OAAO,gBAC1B,QACL;AAER;AAiBO,SAAS,kBAA0C;AACtD,QAAM,SAAS,WAAW,aAAa;AAEvC,MAAI,CAAC,QAAQ;AACT,UAAM,IAAI;AAAA,MACN;AAAA,IAEJ;AAAA,EACJ;AAEA,SAAO;AACX;AAgBO,SAAS,uBAA2D;AACvE,SAAO,WAAW,aAAa,KAAK;AACxC;AAQO,SAAS,qBACZ,gBACsB;AACtB,SAAO,kBAAkB;AAAA,IACrB,SAAS;AAAA,MACL,SAAS;AAAA,IACb;AAAA,EACJ,CAAC;AACL;AAOO,SAAS,YACZ,QACA,OACA,UAAmC,CAAC,GAChC;AACJ,MAAI,QAAQ,gBAAgB,WAAW,OAAO,eAAe,SAAS;AAClE,WAAO,eAAe,QAAQ,OAAO,OAAO;AAAA,EAChD,OAAO;AACH,YAAQ,MAAM,gBAAgB,OAAO,OAAO;AAAA,EAChD;AACJ;AAKO,SAAS,WACZ,QACA,WACA,aAAsC,CAAC,GACnC;AACJ,MAAI,QAAQ,WAAW,WAAW,OAAO,UAAU,YAAY;AAC3D,WAAO,UAAU,WAAW,WAAW,UAAU;AAAA,EACrD;AACJ;",
+  "names": []
+}

package/dist/config/index.d.ts

@@ -0,0 +1,3 @@
+export { type ChartsConfig, type ChartsBranding, type ChartsDataApi, type ChartsErrorReporting, type ChartsAnalytics, type LogoConfig, defaultChartsConfig, mergeWithDefaults, } from "./ChartsConfig.js";
+export { ChartsProvider, type ChartsProviderProps, useChartsConfig, useMaybeChartsConfig, createFallbackConfig, reportError, trackEvent, } from "./ChartsProvider.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,mBAAmB,EACnB,iBAAiB,GACpB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACH,cAAc,EACd,KAAK,mBAAmB,EACxB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,UAAU,GACb,MAAM,qBAAqB,CAAA"}

package/dist/config/index.js

@@ -0,0 +1,22 @@
+import {
+  defaultChartsConfig,
+  mergeWithDefaults
+} from "./ChartsConfig.js";
+import {
+  ChartsProvider,
+  useChartsConfig,
+  useMaybeChartsConfig,
+  createFallbackConfig,
+  reportError,
+  trackEvent
+} from "./ChartsProvider.js";
+export {
+  ChartsProvider,
+  createFallbackConfig,
+  defaultChartsConfig,
+  mergeWithDefaults,
+  reportError,
+  trackEvent,
+  useChartsConfig,
+  useMaybeChartsConfig
+};

package/dist/config/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["src/config/index.ts"],
+  "sourcesContent": ["export {\n    type ChartsConfig,\n    type ChartsBranding,\n    type ChartsDataApi,\n    type ChartsErrorReporting,\n    type ChartsAnalytics,\n    type LogoConfig,\n    defaultChartsConfig,\n    mergeWithDefaults,\n} from \"./ChartsConfig.js\"\n\nexport {\n    ChartsProvider,\n    type ChartsProviderProps,\n    useChartsConfig,\n    useMaybeChartsConfig,\n    createFallbackConfig,\n    reportError,\n    trackEvent,\n} from \"./ChartsProvider.js\"\n"],
+  "mappings": "AAAA;AAAA,EAOI;AAAA,EACA;AAAA,OACG;AAEP;AAAA,EACI;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;",
+  "names": []
+}