@pyreon/charts 0.6.0

package/lib/types/index.d.ts

@@ -0,0 +1,255 @@
+import { effect, signal } from "@pyreon/reactivity";
+import { onUnmount } from "@pyreon/core";
+
+//#region src/loader.ts
+
+/**
+* Lazily load echarts/core. Cached after first call.
+*/
+async function getCore() {
+  if (coreModule) return coreModule;
+  if (!corePromise) corePromise = import("./core.d.ts").then(m => {
+    coreModule = m;
+    return m;
+  });
+  return corePromise;
+}
+async function loadAndRegister(core, key, loader) {
+  if (registered.has(key)) return;
+  if (inflight.has(key)) return inflight.get(key);
+  const promise = loader().then(mod => {
+    core.use(mod);
+    registered.add(key);
+    inflight.delete(key);
+  });
+  inflight.set(key, promise);
+  return promise;
+}
+/**
+* Analyze an ECharts option object and dynamically import only the
+* required chart types, components, and renderer. All imports are
+* cached — subsequent calls with the same types are instant.
+*/
+async function ensureModules(option, renderer = "canvas") {
+  const core = await getCore();
+  const loads = [];
+  loads.push(loadAndRegister(core, `renderer:${renderer}`, RENDERERS[renderer]));
+  const rawSeries = option.series;
+  const seriesList = rawSeries ? Array.isArray(rawSeries) ? rawSeries : [rawSeries] : [];
+  for (const s of seriesList) {
+    const type = s.type;
+    if (type && CHARTS[type]) loads.push(loadAndRegister(core, `chart:${type}`, CHARTS[type]));
+  }
+  for (const key of Object.keys(option)) if (COMPONENTS[key]) loads.push(loadAndRegister(core, `component:${key}`, COMPONENTS[key]));
+  for (const s of seriesList) for (const key of Object.keys(s)) if (SERIES_FEATURES[key]) loads.push(loadAndRegister(core, `feature:${key}`, SERIES_FEATURES[key]));
+  await Promise.all(loads);
+  return core;
+}
+
+//#endregion
+//#region src/use-chart.ts
+/**
+* Reactive ECharts hook. Creates a chart instance bound to a container
+* element, with automatic module lazy-loading, signal tracking, resize
+* handling, error capture, and cleanup.
+*
+* Generic parameter `TOption` narrows the option type for exact autocomplete.
+* Use `ComposeOption<SeriesUnion>` from ECharts to restrict to specific chart types.
+*
+* @example
+* ```tsx
+* // Default — accepts any ECharts option
+* const chart = useChart(() => ({
+*   series: [{ type: 'bar', data: revenue() }],
+* }))
+*
+* // Strict — only bar + line allowed, full autocomplete
+* import type { ComposeOption, BarSeriesOption, LineSeriesOption } from '@pyreon/charts'
+* type MyChartOption = ComposeOption<BarSeriesOption | LineSeriesOption>
+*
+* const chart = useChart<MyChartOption>(() => ({
+*   series: [{ type: 'bar', data: revenue() }],  // ✓
+* }))
+* ```
+*/
+function useChart(optionsFn, config) {
+  const instance = signal(null);
+  const loading = signal(true);
+  const error = signal(null);
+  const container = signal(null);
+  const renderer = config?.renderer ?? "canvas";
+  let observer = null;
+  let initialized = false;
+  effect(() => {
+    const el = container();
+    if (!el || initialized) return;
+    initialized = true;
+    let opts;
+    try {
+      opts = optionsFn();
+    } catch (err) {
+      error.set(err instanceof Error ? err : new Error(String(err)));
+      loading.set(false);
+      return;
+    }
+    ensureModules(opts, renderer).then(core => {
+      if (!container.peek()) return;
+      try {
+        const chart = core.init(el, config?.theme, {
+          renderer,
+          locale: config?.locale,
+          devicePixelRatio: config?.devicePixelRatio,
+          width: config?.width,
+          height: config?.height
+        });
+        chart.setOption(opts);
+        instance.set(chart);
+        loading.set(false);
+        error.set(null);
+        config?.onInit?.(chart);
+        observer = new ResizeObserver(() => {
+          chart.resize();
+        });
+        observer.observe(el);
+      } catch (err) {
+        error.set(err instanceof Error ? err : new Error(String(err)));
+        loading.set(false);
+      }
+    }).catch(err => {
+      error.set(err instanceof Error ? err : new Error(String(err)));
+      loading.set(false);
+    });
+  });
+  effect(() => {
+    const chart = instance();
+    if (!chart) return;
+    try {
+      const opts = optionsFn();
+      chart.setOption(opts, {
+        notMerge: config?.notMerge ?? false,
+        lazyUpdate: config?.lazyUpdate ?? true
+      });
+      error.set(null);
+    } catch (err) {
+      error.set(err instanceof Error ? err : new Error(String(err)));
+    }
+  });
+  onUnmount(() => {
+    observer?.disconnect();
+    observer = null;
+    const chart = instance.peek();
+    if (chart) {
+      chart.dispose();
+      instance.set(null);
+    }
+    initialized = false;
+  });
+  return {
+    ref: el => container.set(el),
+    instance,
+    loading,
+    error,
+    resize: () => instance.peek()?.resize()
+  };
+}
+
+//#endregion
+//#region ../../node_modules/.bun/@pyreon+core@0.6.0/node_modules/@pyreon/core/lib/jsx-runtime.js
+/**
+* Hyperscript function — the compiled output of JSX.
+* `<div class="x">hello</div>` → `h("div", { class: "x" }, "hello")`
+*
+* Generic on P so TypeScript validates props match the component's signature
+* at the call site, then stores the result in the loosely-typed VNode.
+*/
+/** Shared empty props sentinel — identity-checked in mountElement to skip applyProps. */
+
+function h(type, props, ...children) {
+  return {
+    type,
+    props: props ?? EMPTY_PROPS,
+    children: normalizeChildren(children),
+    key: props?.key ?? null
+  };
+}
+function normalizeChildren(children) {
+  for (let i = 0; i < children.length; i++) if (Array.isArray(children[i])) return flattenChildren(children);
+  return children;
+}
+function flattenChildren(children) {
+  const result = [];
+  for (const child of children) if (Array.isArray(child)) result.push(...flattenChildren(child));else result.push(child);
+  return result;
+}
+/**
+* JSX automatic runtime.
+*
+* When tsconfig has `"jsxImportSource": "@pyreon/core"`, the TS/bundler compiler
+* rewrites JSX to imports from this file automatically:
+*   <div class="x" />  →  jsx("div", { class: "x" })
+*/
+function jsx(type, props, key) {
+  const {
+    children,
+    ...rest
+  } = props;
+  const propsWithKey = key != null ? {
+    ...rest,
+    key
+  } : rest;
+  if (typeof type === "function") return h(type, children !== void 0 ? {
+    ...propsWithKey,
+    children
+  } : propsWithKey);
+  return h(type, propsWithKey, ...(children === void 0 ? [] : Array.isArray(children) ? children : [children]));
+}
+
+//#endregion
+//#region src/chart-component.tsx
+/**
+* Reactive chart component. Wraps useChart in a div with automatic
+* event binding.
+*
+* @example
+* ```tsx
+* // Default — any chart type
+* <Chart
+*   options={() => ({
+*     series: [{ type: 'bar', data: revenue() }],
+*     tooltip: {},
+*   })}
+*   style="height: 400px"
+* />
+*
+* // Strict — only specific chart types
+* import type { ComposeOption, BarSeriesOption } from '@pyreon/charts'
+* <Chart<ComposeOption<BarSeriesOption>>
+*   options={() => ({
+*     series: [{ type: 'bar', data: revenue() }],
+*   })}
+*   style="height: 400px"
+* />
+* ```
+*/
+function Chart(props) {
+  const chart = useChart(props.options, {
+    theme: props.theme,
+    renderer: props.renderer
+  });
+  effect(() => {
+    const inst = chart.instance();
+    if (!inst) return;
+    if (props.onClick) inst.on("click", props.onClick);
+    if (props.onMouseover) inst.on("mouseover", props.onMouseover);
+    if (props.onMouseout) inst.on("mouseout", props.onMouseout);
+  });
+  return () => /* @__PURE__ */jsx("div", {
+    ref: chart.ref,
+    style: props.style,
+    class: props.class
+  });
+}
+
+//#endregion
+export { Chart, useChart };
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/loader.ts","../../src/use-chart.ts","../../../../node_modules/.bun/@pyreon+core@0.6.0/node_modules/@pyreon/core/lib/jsx-runtime.js","../../src/chart-component.tsx"],"x_google_ignoreList":[2],"mappings":"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"}