@funnest/charts-cli 0.0.0-stage → 0.1.1

package/dist/render.d.ts

@@ -0,0 +1,14 @@
+import type { ChartSpec, Row } from './spec';
+export declare function valueFormatter(spec: ChartSpec): (v: number) => string;
+export interface RenderOptions {
+    theme?: 'light' | 'dark';
+}
+/** Render a (validated) spec to a standalone SVG document. */
+export declare function renderSvg(spec: ChartSpec, options?: RenderOptions): string;
+export declare function renderHtml(spec: ChartSpec, options?: RenderOptions): string;
+/** PNG via resvg (optional dependency, loaded on demand). */
+export declare function renderPng(spec: ChartSpec, options?: RenderOptions & {
+    scale?: number;
+}): Promise<Uint8Array>;
+export declare function reactCode(spec: ChartSpec): string;
+export type { Row };

package/dist/spec.d.ts

@@ -0,0 +1,92 @@
+import { type CliLocale } from './i18n';
+/** A row of tabular data: column name → value. */
+export type Row = Record<string, unknown>;
+export type ChartType = 'line' | 'area' | 'bar' | 'percentage-bar' | 'sparkline';
+export interface ReferenceLineSpec {
+    y?: number;
+    /** Row index, or a value of the x column. */
+    x?: number | string;
+    label?: string;
+    color?: string;
+}
+export interface PointSpec {
+    /** Row index, or a value of the x column. */
+    x: number | string;
+    /** Value; omit to sit on `series`. */
+    y?: number;
+    series?: string;
+    label?: string;
+    color?: string;
+    pulse?: boolean;
+}
+/** Declarative chart description shared by the CLI, the MCP server and AI agents. */
+export interface ChartSpec {
+    type: ChartType;
+    data: Row[];
+    title?: string;
+    width?: number;
+    height?: number;
+    theme?: 'light' | 'dark';
+    locale?: CliLocale;
+    /** x column (labels/dates). Omit to use the row index. */
+    x?: string;
+    /** Numeric column(s) to draw. */
+    y?: string | string[];
+    /** Display names per y column. */
+    labels?: Record<string, string>;
+    /** Colors per y column (or per row label for percentage-bar). */
+    colors?: Record<string, string>;
+    /** percentage-bar: the label and value columns. */
+    label?: string;
+    value?: string;
+    curve?: 'monotone' | 'linear' | 'step';
+    area?: 'none' | 'gradient' | 'solid';
+    stacked?: boolean;
+    /** bar: red for ≥ 0, blue for < 0 (Korean convention). */
+    colorBySign?: boolean;
+    showXAxis?: boolean;
+    showYAxis?: boolean;
+    legend?: boolean;
+    /** Value labels: prefix/suffix/decimals, e.g. { suffix: '원' }. */
+    format?: {
+        prefix?: string;
+        suffix?: string;
+        decimals?: number;
+    };
+    referenceLines?: ReferenceLineSpec[];
+    points?: PointSpec[];
+}
+type FieldKind = 'string' | 'number' | 'boolean' | 'string|string[]' | 'record' | 'array' | 'object' | 'rows';
+export interface FieldDef {
+    kind: FieldKind;
+    required?: boolean;
+    enum?: readonly string[];
+    /** For string fields naming a data column (checked against the data). */
+    column?: 'any' | 'numeric';
+    default?: unknown;
+    ko: string;
+    en: string;
+    /** JSON Schema for array items / object properties. */
+    items?: Record<string, unknown>;
+}
+export interface ChartDef {
+    type: ChartType;
+    ko: string;
+    en: string;
+    /** Which React component the spec maps to. */
+    component: string;
+    fields: Record<string, FieldDef>;
+    example: Omit<ChartSpec, 'type'>;
+}
+export declare const CHARTS: Record<ChartType, ChartDef>;
+export declare const CHART_TYPES: ChartType[];
+export interface ValidationIssue {
+    path: string;
+    message: string;
+}
+export declare function closest(word: string, options: readonly string[]): string | null;
+/** Check a spec. Returns an empty list when it can be rendered. */
+export declare function validateSpec(input: unknown, locale?: CliLocale): ValidationIssue[];
+export declare function chartSchema(type: ChartType, locale?: CliLocale): Record<string, unknown>;
+export declare const exampleSpec: (type: ChartType) => ChartSpec;
+export {};

package/dist/templates.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Starter code an agent (or a person) can drop into an app. These are templates for the
+ * app's own code — the library itself never ships exchange connections.
+ */
+export type DatafeedTemplateKind = 'rest-websocket' | 'polling' | 'static';
+export declare const datafeedTemplate: (kind?: DatafeedTemplateKind) => string;

package/package.json

@@ -1,6 +1,65 @@
 {
   "name": "@funnest/charts-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "description": "Funnest Charts command line: list charts, validate JSON specs, render SVG/PNG/HTML, suggest charts for your data, generate React code",
+  "keywords": [
+    "chart",
+    "cli",
+    "svg",
+    "png",
+    "json-schema",
+    "ai",
+    "funnest"
+  ],
+  "license": "Apache-2.0",
+  "author": "Funnest",
+  "homepage": "https://charts.funnest.xyz/docs/ai/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/funnest-xyz/funnest-charts.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/funnest-xyz/funnest-charts/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "funnest-charts": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "funnest-source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "dependencies": {
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "@funnest/charts-react": "0.1.1",
+    "@funnest/charts-viz": "0.1.1"
+  },
+  "optionalDependencies": {
+    "@resvg/resvg-js": "^2.6.2"
+  },
+  "devDependencies": {
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0"
+  },
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json"
+  }
 }