@clusterenvision/ui-framework 1.0.0

package/dist/tracing-DGdvMCEl.d.cts

@@ -0,0 +1,109 @@
+import { promises } from 'node:fs';
+
+interface TraceEventPayload {
+  type: string;
+  timestamp: Date;
+  attributes?: Record<string, unknown>;
+  context?: Record<string, unknown>;
+  severity?: 'debug' | 'info' | 'warn' | 'error';
+}
+type TraceRedactor = (event: TraceEventPayload) => TraceEventPayload;
+interface TraceExporter {
+  export(event: TraceEventPayload): Promise<void> | void;
+  flush?(): Promise<void> | void;
+  shutdown?(): Promise<void> | void;
+}
+interface TraceExportOptions {
+  redactor?: TraceRedactor;
+}
+interface JsonlTraceExporterOptions extends TraceExportOptions {
+  filePath: string;
+  writer?: typeof promises;
+}
+declare class JsonlTraceExporter implements TraceExporter {
+  private readonly options;
+  private readonly writer;
+  constructor(options: JsonlTraceExporterOptions);
+  export(event: TraceEventPayload): Promise<void>;
+  flush(): Promise<void>;
+}
+interface OtlpHttpTraceExporterOptions extends TraceExportOptions {
+  url: string;
+  headers?: Record<string, string>;
+  resource?: Record<string, string>;
+  serviceName?: string;
+  scopeName?: string;
+  batchSize?: number;
+  flushIntervalMs?: number;
+  httpClient?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+}
+declare class OtlpHttpTraceExporter implements TraceExporter {
+  private readonly options;
+  private readonly batchSize;
+  private readonly flushIntervalMs;
+  private readonly httpClient;
+  private queue;
+  private timer;
+  constructor(options: OtlpHttpTraceExporterOptions);
+  export(event: TraceEventPayload): void;
+  flush(): Promise<void>;
+  shutdown(): Promise<void>;
+  private post;
+  private buildRequest;
+  private toSpan;
+}
+
+type RuntimeTraceEventType =
+  | 'component.mount.started'
+  | 'component.mount.completed'
+  | 'component.destroyed'
+  | 'component.props.updated'
+  | 'template.render.started'
+  | 'template.render.completed'
+  | 'signals.effect.created'
+  | 'signals.effect.run'
+  | 'signals.effect.completed'
+  | 'signals.effect.scheduled'
+  | 'signals.effect.disposed'
+  | 'signals.signal.read'
+  | 'signals.signal.written'
+  | 'signals.batch.started'
+  | 'signals.batch.completed'
+  | 'ssr.render.started'
+  | 'ssr.render.completed'
+  | 'server.request.started'
+  | 'server.request.completed'
+  | 'server.middleware.started'
+  | 'server.middleware.completed';
+interface RuntimeTraceEvent {
+  type: RuntimeTraceEventType;
+  timestamp?: Date;
+  componentName?: string;
+  componentInstanceId?: string;
+  templateId?: string;
+  effectId?: string;
+  signalId?: string;
+  middlewareName?: string;
+  middlewareIndex?: number;
+  requestId?: string;
+  attributes?: Record<string, unknown>;
+}
+interface RuntimeTraceSink {
+  record(event: RuntimeTraceEvent): void | Promise<void>;
+}
+declare class NoopRuntimeTraceSink implements RuntimeTraceSink {
+  record(_event: RuntimeTraceEvent): void;
+}
+declare class RuntimeTraceExporterSink implements RuntimeTraceSink {
+  private readonly exporter;
+  constructor(exporter: TraceExporter);
+  record(event: RuntimeTraceEvent): void;
+}
+declare function setRuntimeTraceSink(sink: RuntimeTraceSink | undefined): void;
+declare function withRuntimeTraceSink<T>(sink: RuntimeTraceSink | undefined, run: () => T): T;
+declare function getCurrentRuntimeTraceSink(): RuntimeTraceSink | undefined;
+declare function hasRuntimeTraceSink(): boolean;
+declare function recordRuntimeTrace(event: Omit<RuntimeTraceEvent, 'timestamp'> & { timestamp?: Date }): void;
+declare function nextRuntimeTraceId(prefix: string): string;
+
+export { JsonlTraceExporter as J, NoopRuntimeTraceSink as N, OtlpHttpTraceExporter as O, type RuntimeTraceSink as R, type TraceExporter as T, type RuntimeTraceEvent as a, type JsonlTraceExporterOptions as b, type OtlpHttpTraceExporterOptions as c, type RuntimeTraceEventType as d, RuntimeTraceExporterSink as e, type TraceEventPayload as f, type TraceExportOptions as g, type TraceRedactor as h, getCurrentRuntimeTraceSink as i, hasRuntimeTraceSink as j, nextRuntimeTraceId as n, recordRuntimeTrace as r, setRuntimeTraceSink as s, withRuntimeTraceSink as w };

package/dist/tracing-DGdvMCEl.d.ts

@@ -0,0 +1,109 @@
+import { promises } from 'node:fs';
+
+interface TraceEventPayload {
+  type: string;
+  timestamp: Date;
+  attributes?: Record<string, unknown>;
+  context?: Record<string, unknown>;
+  severity?: 'debug' | 'info' | 'warn' | 'error';
+}
+type TraceRedactor = (event: TraceEventPayload) => TraceEventPayload;
+interface TraceExporter {
+  export(event: TraceEventPayload): Promise<void> | void;
+  flush?(): Promise<void> | void;
+  shutdown?(): Promise<void> | void;
+}
+interface TraceExportOptions {
+  redactor?: TraceRedactor;
+}
+interface JsonlTraceExporterOptions extends TraceExportOptions {
+  filePath: string;
+  writer?: typeof promises;
+}
+declare class JsonlTraceExporter implements TraceExporter {
+  private readonly options;
+  private readonly writer;
+  constructor(options: JsonlTraceExporterOptions);
+  export(event: TraceEventPayload): Promise<void>;
+  flush(): Promise<void>;
+}
+interface OtlpHttpTraceExporterOptions extends TraceExportOptions {
+  url: string;
+  headers?: Record<string, string>;
+  resource?: Record<string, string>;
+  serviceName?: string;
+  scopeName?: string;
+  batchSize?: number;
+  flushIntervalMs?: number;
+  httpClient?: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+}
+declare class OtlpHttpTraceExporter implements TraceExporter {
+  private readonly options;
+  private readonly batchSize;
+  private readonly flushIntervalMs;
+  private readonly httpClient;
+  private queue;
+  private timer;
+  constructor(options: OtlpHttpTraceExporterOptions);
+  export(event: TraceEventPayload): void;
+  flush(): Promise<void>;
+  shutdown(): Promise<void>;
+  private post;
+  private buildRequest;
+  private toSpan;
+}
+
+type RuntimeTraceEventType =
+  | 'component.mount.started'
+  | 'component.mount.completed'
+  | 'component.destroyed'
+  | 'component.props.updated'
+  | 'template.render.started'
+  | 'template.render.completed'
+  | 'signals.effect.created'
+  | 'signals.effect.run'
+  | 'signals.effect.completed'
+  | 'signals.effect.scheduled'
+  | 'signals.effect.disposed'
+  | 'signals.signal.read'
+  | 'signals.signal.written'
+  | 'signals.batch.started'
+  | 'signals.batch.completed'
+  | 'ssr.render.started'
+  | 'ssr.render.completed'
+  | 'server.request.started'
+  | 'server.request.completed'
+  | 'server.middleware.started'
+  | 'server.middleware.completed';
+interface RuntimeTraceEvent {
+  type: RuntimeTraceEventType;
+  timestamp?: Date;
+  componentName?: string;
+  componentInstanceId?: string;
+  templateId?: string;
+  effectId?: string;
+  signalId?: string;
+  middlewareName?: string;
+  middlewareIndex?: number;
+  requestId?: string;
+  attributes?: Record<string, unknown>;
+}
+interface RuntimeTraceSink {
+  record(event: RuntimeTraceEvent): void | Promise<void>;
+}
+declare class NoopRuntimeTraceSink implements RuntimeTraceSink {
+  record(_event: RuntimeTraceEvent): void;
+}
+declare class RuntimeTraceExporterSink implements RuntimeTraceSink {
+  private readonly exporter;
+  constructor(exporter: TraceExporter);
+  record(event: RuntimeTraceEvent): void;
+}
+declare function setRuntimeTraceSink(sink: RuntimeTraceSink | undefined): void;
+declare function withRuntimeTraceSink<T>(sink: RuntimeTraceSink | undefined, run: () => T): T;
+declare function getCurrentRuntimeTraceSink(): RuntimeTraceSink | undefined;
+declare function hasRuntimeTraceSink(): boolean;
+declare function recordRuntimeTrace(event: Omit<RuntimeTraceEvent, 'timestamp'> & { timestamp?: Date }): void;
+declare function nextRuntimeTraceId(prefix: string): string;
+
+export { JsonlTraceExporter as J, NoopRuntimeTraceSink as N, OtlpHttpTraceExporter as O, type RuntimeTraceSink as R, type TraceExporter as T, type RuntimeTraceEvent as a, type JsonlTraceExporterOptions as b, type OtlpHttpTraceExporterOptions as c, type RuntimeTraceEventType as d, RuntimeTraceExporterSink as e, type TraceEventPayload as f, type TraceExportOptions as g, type TraceRedactor as h, getCurrentRuntimeTraceSink as i, hasRuntimeTraceSink as j, nextRuntimeTraceId as n, recordRuntimeTrace as r, setRuntimeTraceSink as s, withRuntimeTraceSink as w };

package/dist/types-C4RXXKfk.d.cts

@@ -0,0 +1,76 @@
+type TemplateInstruction = ElementInstruction | TextInstruction | ExpressionInstruction | ConditionalInstruction | LoopInstruction | SlotInstruction | AwaitInstruction;
+interface CompiledTemplate {
+    name?: string;
+    instructions: TemplateInstruction[];
+    styles?: string[];
+    scopeId?: string;
+}
+interface ElementInstruction {
+    type: 'element';
+    tag: string;
+    attributes: TemplateAttribute[];
+    children: TemplateInstruction[];
+}
+interface TextInstruction {
+    type: 'text';
+    value: string;
+}
+interface ExpressionInstruction {
+    type: 'expression';
+    expression: string;
+}
+interface ConditionalInstruction {
+    type: 'if';
+    condition: string;
+    truthy: TemplateInstruction[];
+    falsy?: TemplateInstruction[];
+}
+interface LoopInstruction {
+    type: 'for';
+    item: string;
+    iterator: string;
+    index?: string;
+    trackBy?: string;
+    children: TemplateInstruction[];
+}
+interface SlotInstruction {
+    type: 'slot';
+    name?: string;
+    children: TemplateInstruction[];
+}
+interface AwaitInstruction {
+    type: 'await';
+    expression: string;
+    pending: TemplateInstruction[];
+    resolved: TemplateInstruction[];
+    rejected: TemplateInstruction[];
+    valueName?: string;
+    errorName?: string;
+}
+type TemplateAttribute = StaticAttribute | PropertyAttribute | EventAttribute | ClassListAttribute;
+interface StaticAttribute {
+    kind: 'static';
+    name: string;
+    value: string;
+}
+interface PropertyAttribute {
+    kind: 'property';
+    name: string;
+    expression: string;
+}
+interface EventAttribute {
+    kind: 'event';
+    name: string;
+    handler: string;
+}
+interface ClassListAttribute {
+    kind: 'class-list';
+    expression: string;
+}
+interface TemplateCompileOptions {
+    name?: string;
+    preserveWhitespace?: boolean;
+    scopeId?: string;
+}
+
+export type { AwaitInstruction as A, CompiledTemplate as C, ElementInstruction as E, LoopInstruction as L, PropertyAttribute as P, SlotInstruction as S, TemplateCompileOptions as T, ClassListAttribute as a, ConditionalInstruction as b, EventAttribute as c, ExpressionInstruction as d, StaticAttribute as e, TemplateAttribute as f, TemplateInstruction as g, TextInstruction as h };

package/dist/types-C4RXXKfk.d.ts

@@ -0,0 +1,76 @@
+type TemplateInstruction = ElementInstruction | TextInstruction | ExpressionInstruction | ConditionalInstruction | LoopInstruction | SlotInstruction | AwaitInstruction;
+interface CompiledTemplate {
+    name?: string;
+    instructions: TemplateInstruction[];
+    styles?: string[];
+    scopeId?: string;
+}
+interface ElementInstruction {
+    type: 'element';
+    tag: string;
+    attributes: TemplateAttribute[];
+    children: TemplateInstruction[];
+}
+interface TextInstruction {
+    type: 'text';
+    value: string;
+}
+interface ExpressionInstruction {
+    type: 'expression';
+    expression: string;
+}
+interface ConditionalInstruction {
+    type: 'if';
+    condition: string;
+    truthy: TemplateInstruction[];
+    falsy?: TemplateInstruction[];
+}
+interface LoopInstruction {
+    type: 'for';
+    item: string;
+    iterator: string;
+    index?: string;
+    trackBy?: string;
+    children: TemplateInstruction[];
+}
+interface SlotInstruction {
+    type: 'slot';
+    name?: string;
+    children: TemplateInstruction[];
+}
+interface AwaitInstruction {
+    type: 'await';
+    expression: string;
+    pending: TemplateInstruction[];
+    resolved: TemplateInstruction[];
+    rejected: TemplateInstruction[];
+    valueName?: string;
+    errorName?: string;
+}
+type TemplateAttribute = StaticAttribute | PropertyAttribute | EventAttribute | ClassListAttribute;
+interface StaticAttribute {
+    kind: 'static';
+    name: string;
+    value: string;
+}
+interface PropertyAttribute {
+    kind: 'property';
+    name: string;
+    expression: string;
+}
+interface EventAttribute {
+    kind: 'event';
+    name: string;
+    handler: string;
+}
+interface ClassListAttribute {
+    kind: 'class-list';
+    expression: string;
+}
+interface TemplateCompileOptions {
+    name?: string;
+    preserveWhitespace?: boolean;
+    scopeId?: string;
+}
+
+export type { AwaitInstruction as A, CompiledTemplate as C, ElementInstruction as E, LoopInstruction as L, PropertyAttribute as P, SlotInstruction as S, TemplateCompileOptions as T, ClassListAttribute as a, ConditionalInstruction as b, EventAttribute as c, ExpressionInstruction as d, StaticAttribute as e, TemplateAttribute as f, TemplateInstruction as g, TextInstruction as h };

package/package.json

@@ -0,0 +1,166 @@
+{
+  "name": "@clusterenvision/ui-framework",
+  "version": "1.0.0",
+  "private": false,
+  "type": "module",
+  "description": "Compile-time first UI framework with CE ecosystem integrations.",
+  "license": "MIT",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20 <25"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/browser.js",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./compiler": {
+      "types": "./dist/compiler/index.d.ts",
+      "import": "./dist/compiler/index.js",
+      "require": "./dist/compiler/index.cjs"
+    },
+    "./router": {
+      "types": "./dist/runtime/router.d.ts",
+      "import": "./dist/runtime/router.js",
+      "require": "./dist/runtime/router.cjs"
+    },
+    "./server": {
+      "types": "./dist/runtime/server.d.ts",
+      "import": "./dist/runtime/server.js",
+      "require": "./dist/runtime/server.cjs"
+    },
+    "./adapters/angular": {
+      "types": "./dist/runtime/adapters/angular.d.ts",
+      "import": "./dist/runtime/adapters/angular.js",
+      "require": "./dist/runtime/adapters/angular.cjs"
+    },
+    "./adapters/react": {
+      "types": "./dist/runtime/adapters/react.d.ts",
+      "import": "./dist/runtime/adapters/react.js",
+      "require": "./dist/runtime/adapters/react.cjs"
+    },
+    "./adapters/vue": {
+      "types": "./dist/runtime/adapters/vue.d.ts",
+      "import": "./dist/runtime/adapters/vue.js",
+      "require": "./dist/runtime/adapters/vue.cjs"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js",
+      "require": "./dist/browser.cjs"
+    },
+    "./workflow": {
+      "types": "./dist/runtime/workflow/index.d.ts",
+      "import": "./dist/runtime/workflow/index.js",
+      "require": "./dist/runtime/workflow/index.cjs"
+    },
+    "./components/ai-assistant": {
+      "types": "./dist/runtime/components/ai-assistant.d.ts",
+      "import": "./dist/runtime/components/ai-assistant.js",
+      "require": "./dist/runtime/components/ai-assistant.cjs"
+    },
+    "./components/ai-summary-card": {
+      "types": "./dist/runtime/components/ai-summary-card.d.ts",
+      "import": "./dist/runtime/components/ai-summary-card.js",
+      "require": "./dist/runtime/components/ai-summary-card.cjs"
+    },
+    "./signals": {
+      "types": "./dist/browser-signals.d.ts",
+      "import": "./dist/browser-signals.js",
+      "require": "./dist/browser-signals.cjs"
+    },
+    "./lib": {
+      "types": "./dist/lib/index.d.ts",
+      "import": "./dist/lib/index.js",
+      "require": "./dist/lib/index.cjs"
+    },
+    "./lib/dom": {
+      "types": "./dist/lib/dom.d.ts",
+      "import": "./dist/lib/dom.js",
+      "require": "./dist/lib/dom.cjs"
+    },
+    "./lib/icons": {
+      "types": "./dist/lib/icons.d.ts",
+      "import": "./dist/lib/icons.js",
+      "require": "./dist/lib/icons.cjs"
+    },
+    "./lib/theme": {
+      "types": "./dist/lib/theme.d.ts",
+      "import": "./dist/lib/theme.js",
+      "require": "./dist/lib/theme.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "ceui": "./dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "cross-env TSUP_WORKERS=1 NODE_OPTIONS=--max-old-space-size=4096 tsup --config tsup.config.ts",
+    "dev": "tsup --config tsup.config.ts --watch",
+    "docs:api": "typedoc --options typedoc.json",
+    "docs:api:publish": "npm run build && npm run docs:api",
+    "lint": "eslint \"src/**/*.{ts,tsx}\" --max-warnings=0",
+    "test": "node ./scripts/run-vitest.mjs",
+    "test:compiler": "npm run test -- \"tests/compiler.spec.ts\" \"tests/html-parser.spec.ts\" \"tests/compiler/**/*.spec.ts\" \"tests/html-parser/**/*.spec.ts\" --passWithNoTests",
+    "test:runtime": "npm run test -- \"tests/runtime/**/*.spec.ts\" \"tests/signals.spec.ts\" --passWithNoTests",
+    "test:workflow": "npm run test -- \"tests/workflow/**/*.spec.ts\" --passWithNoTests",
+    "test:ci": "npm run test:compiler && npm run test:runtime && npm run test:workflow",
+    "test:types": "npm run build && tsd",
+    "tokens:matrix": "node ./scripts/generate-token-compat-matrix.mjs",
+    "bench": "node ./scripts/run-benchmarks.mjs",
+    "typecheck": "tsc --noEmit",
+    "compile:examples": "node dist/cli/index.js compile examples/basic-counter",
+    "prerelease": "npm run lint && npm run test && npm run build"
+  },
+  "dependencies": {
+    "@jridgewell/gen-mapping": "^0.3.5",
+    "chokidar": "^5.0.0",
+    "commander": "^15.0.0",
+    "fast-glob": "^3.3.2",
+    "picocolors": "^1.1.0"
+  },
+  "peerDependencies": {
+    "@clusterenvision/ce-ui-scss": "^1.94.2",
+    "@clusterenvision/ui-webcomponents": "^1.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@clusterenvision/ce-ui-scss": {
+      "optional": true
+    },
+    "@clusterenvision/ui-webcomponents": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@clusterenvision/ce-ui-scss": "file:../ce-ui-scss",
+    "@clusterenvision/ui-webcomponents": "file:../ce-ui-webcomponents",
+    "@types/node": "^25.9.3",
+    "@typescript-eslint/eslint-plugin": "^8.61.0",
+    "@typescript-eslint/parser": "^8.61.0",
+    "cross-env": "^10.1.0",
+    "eslint": "^10.5.0",
+    "eslint-config-prettier": "^10.1.8",
+    "jsdom": "^29.1.1",
+    "prettier": "^3.8.4",
+    "tsd": "^0.33.0",
+    "tsup": "^8.5.1",
+    "typedoc": "^0.28.19",
+    "typedoc-plugin-markdown": "^4.12.0",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.61.0",
+    "vitest": "^4.1.8"
+  },
+  "overrides": {
+    "vite": "8.0.16",
+    "esbuild": "0.28.1"
+  }
+}