@luckydraw/blex 0.1.0

package/dist/esm/types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * A content block to be rendered. Generic over the data payload type.
+ */
+export interface ContentBlock<T = unknown> {
+    type: string;
+    data: T;
+    id: string;
+    streaming?: boolean;
+}
+/**
+ * Renderer implementation for a specific block type.
+ * All renderers must implement render() and destroy().
+ * Streaming-capable renderers implement update().
+ * Interactive renderers implement onInteraction().
+ */
+export interface BlockRenderer<T = unknown> {
+    render(block: ContentBlock<T>, container: HTMLElement): void;
+    update?(block: ContentBlock<T>): void;
+    onInteraction?(callback: (interaction: BlockInteraction) => void): void;
+    destroy(): void;
+}
+/**
+ * Handle returned from renderBlock(). Allows updating, listening for
+ * interactions, and cleanup.
+ */
+export interface BlockHandle {
+    update(block: ContentBlock): void;
+    onInteraction(callback: (interaction: BlockInteraction) => void): void;
+    destroy(): void;
+}
+/**
+ * User interaction with a rendered block. Every interaction includes
+ * a serialized text form suitable for chat input injection.
+ */
+export interface BlockInteraction {
+    blockId: string;
+    type: string;
+    payload: unknown;
+    serialized: string;
+}
+/**
+ * Options for renderBlock().
+ */
+export interface RenderOptions {
+    onReady?: () => void;
+}
+/**
+ * Factory function or class that creates a BlockRenderer.
+ * Used by the registry to instantiate renderers on demand.
+ */
+export type BlockRendererFactory<T = unknown> = () => BlockRenderer<T>;
+/**
+ * Registry entry: either a factory (sync) or a lazy loader (async).
+ */
+export interface RegistryEntry {
+    factory?: BlockRendererFactory;
+    loader?: () => Promise<BlockRendererFactory>;
+}
+export interface ChartConfig {
+    type: 'bar' | 'line' | 'pie' | 'doughnut';
+    data: {
+        labels: string[];
+        datasets: DataSet[];
+    };
+    options?: ChartOptions;
+}
+export interface ChartOptions {
+    title?: string;
+    legend?: boolean;
+    responsive?: boolean;
+}
+export interface DataSet {
+    label: string;
+    values: number[];
+    color?: string;
+}
+export interface ChartInstance {
+    update(config: Partial<ChartConfig>): void;
+    destroy(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,CAAC;IACR,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7D,MAAM,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACtC,aAAa,CAAC,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI,CAAC;IACxE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,aAAa,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI,CAAC;IACvE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,aAAa,CAAC,CAAC,CAAC,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAC9C;AAID,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC;IAC1C,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAChD,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IAC3C,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@luckydraw/blex",
+  "version": "0.1.0",
+  "description": "Interactive content block rendering library — framework-agnostic, streaming-aware",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/esm/index.js",
+      "types": "./dist/esm/index.d.ts"
+    },
+    "./chart": {
+      "import": "./dist/esm/chart/index.js",
+      "types": "./dist/esm/chart/index.d.ts"
+    },
+    "./react": {
+      "import": "./dist/esm/react/index.js",
+      "types": "./dist/esm/react/index.d.ts"
+    },
+    "./react/chart": {
+      "import": "./dist/esm/react/chart.js",
+      "types": "./dist/esm/react/chart.d.ts"
+    }
+  },
+  "main": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "build:types": "tsc --emitDeclarationOnly --outDir dist/esm",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src/ --ext .ts,.tsx",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm run build:types"
+  },
+  "keywords": [
+    "content-blocks",
+    "rendering",
+    "streaming",
+    "charts",
+    "interactive"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^18.3.28",
+    "@types/react-dom": "^19.2.3",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "chart.js": "^4.5.1",
+    "eslint": "^8.57.0",
+    "jsdom": "^24.0.0",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "dependencies": {
+    "dompurify": "^3.1.0"
+  },
+  "peerDependencies": {
+    "chart.js": "^4.0.0",
+    "mermaid": "^10.0.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "chart.js": {
+      "optional": true
+    },
+    "mermaid": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  }
+}