@prodivix/shared 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Minsecrus 2025
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types/PdxComponent';
+export * from './llm';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,OAAO,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './types/PdxComponent';
+export * from './llm';

package/dist/llm/contextBuilder.d.ts

@@ -0,0 +1,9 @@
+import type { LlmContextBundle, LlmContextEntry } from './types';
+export declare class LlmContextBuilder {
+    private readonly entries;
+    private readonly omittedContext;
+    add<TValue>(entry: LlmContextEntry<TValue>): this;
+    omit(reason: string): this;
+    build(tokenBudget?: number): LlmContextBundle;
+}
+//# sourceMappingURL=contextBuilder.d.ts.map

package/dist/llm/contextBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextBuilder.d.ts","sourceRoot":"","sources":["../../src/llm/contextBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEjE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAE/C,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,IAAI;IASjD,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK1B,KAAK,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,gBAAgB;CAO9C"}

package/dist/llm/contextBuilder.js

@@ -0,0 +1,22 @@
+export class LlmContextBuilder {
+    entries = [];
+    omittedContext = [];
+    add(entry) {
+        if (this.entries.some((current) => current.id === entry.id)) {
+            throw new Error(`LLM context entry already exists: ${entry.id}`);
+        }
+        this.entries.push(entry);
+        return this;
+    }
+    omit(reason) {
+        this.omittedContext.push(reason);
+        return this;
+    }
+    build(tokenBudget) {
+        return {
+            entries: [...this.entries],
+            omittedContext: [...this.omittedContext],
+            tokenBudget,
+        };
+    }
+}

package/dist/llm/gateway.d.ts

@@ -0,0 +1,28 @@
+import type { LlmProvider, LlmTaskRequest, LlmTaskResult } from './types';
+import type { LlmTraceStore } from './traceStore';
+import { LlmToolRegistry } from './toolRegistry';
+export interface LlmGatewayOptions {
+    provider: LlmProvider;
+    tools: LlmToolRegistry;
+    traceStore?: LlmTraceStore;
+    createId?: () => string;
+    now?: () => string;
+}
+/**
+ * LLM Gateway 是 MFE 内部 AI 调用链路的统一入口：先按任务挑选允许的工具，
+ * 再调用 provider，随后校验输出通道并写入 trace，最后返回可 dry-run 或可计划化的结果。
+ *
+ * LlmGateway is the unified MFE AI execution entrypoint: it picks task-allowed
+ * tools, calls the provider, validates the output channel, records trace data,
+ * and returns a result ready for planning or dry-run handling.
+ */
+export declare class LlmGateway {
+    private readonly provider;
+    private readonly tools;
+    private readonly traceStore?;
+    private readonly createId;
+    private readonly now;
+    constructor(options: LlmGatewayOptions);
+    run(task: LlmTaskRequest): Promise<LlmTaskResult>;
+}
+//# sourceMappingURL=gateway.d.ts.map

package/dist/llm/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src/llm/gateway.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,WAAW,EAGX,cAAc,EACd,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,eAAe,CAAC;IACvB,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAkDD;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,OAAO,EAAE,iBAAiB;IAQhC,GAAG,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CA6ExD"}

package/dist/llm/gateway.js

@@ -0,0 +1,118 @@
+import { LlmProviderError } from './types';
+import { LlmToolRegistry } from './toolRegistry';
+const defaultCreateId = () => `llm_${Date.now().toString(36)}_${Math.random().toString(36).slice(2)}`;
+const defaultNow = () => new Date().toISOString();
+const getOutputChannel = (output) => {
+    if ('channel' in output) {
+        return output.channel;
+    }
+    return 'plan';
+};
+const unwrapProviderResult = (result) => {
+    if (isProviderResultEnvelope(result)) {
+        return result;
+    }
+    return { output: result };
+};
+const isProviderResultEnvelope = (result) => typeof result === 'object' &&
+    result !== null &&
+    'output' in result &&
+    isStructuredOutput(result.output);
+const isStructuredOutput = (value) => {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const candidate = value;
+    return (('goal' in candidate && typeof candidate.goal === 'string') ||
+        ('channel' in candidate &&
+            (candidate.channel === 'pir-command' ||
+                candidate.channel === 'node-graph-operation' ||
+                candidate.channel === 'code-artifact')));
+};
+/**
+ * LLM Gateway 是 MFE 内部 AI 调用链路的统一入口：先按任务挑选允许的工具，
+ * 再调用 provider，随后校验输出通道并写入 trace，最后返回可 dry-run 或可计划化的结果。
+ *
+ * LlmGateway is the unified MFE AI execution entrypoint: it picks task-allowed
+ * tools, calls the provider, validates the output channel, records trace data,
+ * and returns a result ready for planning or dry-run handling.
+ */
+export class LlmGateway {
+    provider;
+    tools;
+    traceStore;
+    createId;
+    now;
+    constructor(options) {
+        this.provider = options.provider;
+        this.tools = options.tools;
+        this.traceStore = options.traceStore;
+        this.createId = options.createId ?? defaultCreateId;
+        this.now = options.now ?? defaultNow;
+    }
+    async run(task) {
+        const startedAt = this.now();
+        const traceId = this.createId();
+        const allowedTools = this.tools.pick(task.allowedTools);
+        try {
+            const providerResult = await this.provider.generate({
+                task,
+                tools: allowedTools,
+            });
+            const { output, rawResponse } = unwrapProviderResult(providerResult);
+            const outputChannel = getOutputChannel(output);
+            if (outputChannel !== 'plan' &&
+                !task.outputChannels.includes(outputChannel)) {
+                throw new Error(`Provider returned disallowed LLM output channel: ${outputChannel}`);
+            }
+            const completedAt = this.now();
+            await this.traceStore?.append({
+                id: traceId,
+                taskId: task.id,
+                userIntent: task.intent,
+                modelProviderId: this.provider.id,
+                context: task.context,
+                toolNames: allowedTools.map((tool) => tool.name),
+                toolCalls: [],
+                diagnostics: [],
+                startedAt,
+                completedAt,
+            });
+            return {
+                taskId: task.id,
+                status: task.requiresPlan ? 'planned' : 'dry-run',
+                output,
+                rawResponse,
+                diagnostics: [],
+                traceId,
+            };
+        }
+        catch (error) {
+            const rawResponse = error instanceof LlmProviderError ? error.rawResponse : undefined;
+            const diagnostic = {
+                code: 'LLM_PROVIDER_FAILED',
+                severity: 'error',
+                message: error instanceof Error ? error.message : 'LLM provider failed.',
+            };
+            await this.traceStore?.append({
+                id: traceId,
+                taskId: task.id,
+                userIntent: task.intent,
+                modelProviderId: this.provider.id,
+                context: task.context,
+                toolNames: allowedTools.map((tool) => tool.name),
+                toolCalls: [],
+                diagnostics: [diagnostic],
+                startedAt,
+                completedAt: this.now(),
+            });
+            return {
+                taskId: task.id,
+                status: 'failed',
+                rawResponse,
+                diagnostics: [diagnostic],
+                traceId,
+            };
+        }
+    }
+}

package/dist/llm/index.d.ts

@@ -0,0 +1,7 @@
+export * from './contextBuilder';
+export * from './gateway';
+export * from './mockProvider';
+export * from './toolRegistry';
+export * from './traceStore';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/llm/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC"}

package/dist/llm/index.js

@@ -0,0 +1,6 @@
+export * from './contextBuilder';
+export * from './gateway';
+export * from './mockProvider';
+export * from './toolRegistry';
+export * from './traceStore';
+export * from './types';

package/dist/llm/mockProvider.d.ts

@@ -0,0 +1,8 @@
+import type { LlmProvider, LlmProviderGenerateResult, LlmProviderRequest, LlmStructuredOutput } from './types';
+export declare class MockLlmProvider implements LlmProvider {
+    private readonly output;
+    readonly id = "mock";
+    constructor(output: LlmStructuredOutput);
+    generate(_request: LlmProviderRequest): Promise<LlmProviderGenerateResult>;
+}
+//# sourceMappingURL=mockProvider.d.ts.map

package/dist/llm/mockProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockProvider.d.ts","sourceRoot":"","sources":["../../src/llm/mockProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAEjB,qBAAa,eAAgB,YAAW,WAAW;IAGrC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,QAAQ,CAAC,EAAE,UAAU;gBAEQ,MAAM,EAAE,mBAAmB;IAExD,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,yBAAyB,CAAC;CAG3E"}

package/dist/llm/mockProvider.js

@@ -0,0 +1,10 @@
+export class MockLlmProvider {
+    output;
+    id = 'mock';
+    constructor(output) {
+        this.output = output;
+    }
+    generate(_request) {
+        return Promise.resolve(this.output);
+    }
+}

package/dist/llm/toolRegistry.d.ts

@@ -0,0 +1,9 @@
+import type { LlmToolDefinition } from './types';
+export declare class LlmToolRegistry {
+    private readonly tools;
+    register(tool: LlmToolDefinition): void;
+    get(name: string): LlmToolDefinition | undefined;
+    list(): readonly LlmToolDefinition[];
+    pick(names: readonly string[]): readonly LlmToolDefinition[];
+}
+//# sourceMappingURL=toolRegistry.d.ts.map

package/dist/llm/toolRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolRegistry.d.ts","sourceRoot":"","sources":["../../src/llm/toolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwC;IAE9D,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI;IAQvC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIhD,IAAI,IAAI,SAAS,iBAAiB,EAAE;IAIpC,IAAI,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,iBAAiB,EAAE;CAW7D"}

package/dist/llm/toolRegistry.js

@@ -0,0 +1,24 @@
+export class LlmToolRegistry {
+    tools = new Map();
+    register(tool) {
+        if (this.tools.has(tool.name)) {
+            throw new Error(`LLM tool already registered: ${tool.name}`);
+        }
+        this.tools.set(tool.name, tool);
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    list() {
+        return Array.from(this.tools.values());
+    }
+    pick(names) {
+        return names.map((name) => {
+            const tool = this.tools.get(name);
+            if (!tool) {
+                throw new Error(`Unknown LLM tool: ${name}`);
+            }
+            return tool;
+        });
+    }
+}

package/dist/llm/traceStore.d.ts

@@ -0,0 +1,10 @@
+import type { LlmGatewayTrace } from './types';
+export interface LlmTraceStore {
+    append(trace: LlmGatewayTrace): void | Promise<void>;
+}
+export declare class InMemoryLlmTraceStore implements LlmTraceStore {
+    private readonly traces;
+    append(trace: LlmGatewayTrace): void;
+    list(): readonly LlmGatewayTrace[];
+}
+//# sourceMappingURL=traceStore.d.ts.map

package/dist/llm/traceStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceStore.d.ts","sourceRoot":"","sources":["../../src/llm/traceStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED,qBAAa,qBAAsB,YAAW,aAAa;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAEhD,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAIpC,IAAI,IAAI,SAAS,eAAe,EAAE;CAGnC"}

package/dist/llm/traceStore.js

@@ -0,0 +1,9 @@
+export class InMemoryLlmTraceStore {
+    traces = [];
+    append(trace) {
+        this.traces.push(trace);
+    }
+    list() {
+        return [...this.traces];
+    }
+}

package/dist/llm/types.d.ts

@@ -0,0 +1,173 @@
+export type LlmOutputChannel = 'pir-command' | 'node-graph-operation' | 'code-artifact';
+export type LlmRiskLevel = 'low' | 'medium' | 'high';
+export type LlmTaskStatus = 'planned' | 'dry-run' | 'applied' | 'failed';
+export type LlmContextAuthority = 'authoritative' | 'summary';
+export type LlmCodeArtifactKind = 'node-code' | 'external-runtime-code' | 'adapter-code' | 'test-code' | 'shader-code' | 'worker-code' | 'utility-code';
+export type LlmDiagnosticSeverity = 'info' | 'warning' | 'error';
+export type LlmToolSideEffect = 'read' | 'dry-run' | 'write' | 'verify';
+export type LlmResponseMode = 'json' | 'tool-calls' | 'text-with-json';
+export type LlmToolSchemaFormat = 'json-schema' | 'openai-compatible' | 'anthropic-compatible' | 'gemini-compatible';
+export interface LlmModelPreferences {
+    jsonMode?: boolean;
+    toolCalling?: boolean;
+    vision?: boolean;
+    longContext?: boolean;
+}
+export interface LlmExecutionBudget {
+    maxOutputTokens?: number;
+    temperature?: number;
+    timeoutMs?: number;
+}
+export interface LlmProviderCapabilities {
+    responseModes: readonly LlmResponseMode[];
+    toolSchemaFormats: readonly LlmToolSchemaFormat[];
+    supportsStreaming: boolean;
+    supportsJsonMode: boolean;
+    supportsToolCalling: boolean;
+    supportsVision: boolean;
+    supportsLongContext: boolean;
+}
+export interface LlmDiagnostic {
+    code: string;
+    message: string;
+    severity: LlmDiagnosticSeverity;
+    path?: string;
+    allowedValues?: readonly string[];
+    repairHint?: string;
+}
+export interface LlmContextEntry<TValue = unknown> {
+    id: string;
+    title: string;
+    authority: LlmContextAuthority;
+    value: TValue;
+    description?: string;
+}
+export interface LlmContextBundle {
+    entries: readonly LlmContextEntry[];
+    tokenBudget?: number;
+    omittedContext?: readonly string[];
+}
+export interface LlmPlanMilestone {
+    id: string;
+    title: string;
+    description?: string;
+}
+export interface LlmPlanArtifact {
+    goal: string;
+    assumptions: readonly string[];
+    milestones: readonly LlmPlanMilestone[];
+}
+export interface LlmPirCommandBatch {
+    channel: 'pir-command';
+    commands: readonly unknown[];
+    riskLevel: LlmRiskLevel;
+}
+export interface LlmNodeGraphOperationBatch {
+    channel: 'node-graph-operation';
+    operations: readonly unknown[];
+    riskLevel: LlmRiskLevel;
+}
+export interface LlmCodeArtifact {
+    channel: 'code-artifact';
+    id: string;
+    kind: LlmCodeArtifactKind;
+    language: string;
+    content: string;
+    ownerId?: string;
+    bindTargetId?: string;
+    riskLevel: LlmRiskLevel;
+}
+export type LlmStructuredOutput = LlmPlanArtifact | LlmPirCommandBatch | LlmNodeGraphOperationBatch | LlmCodeArtifact;
+export type LlmProviderGenerateResult<TOutput extends LlmStructuredOutput = LlmStructuredOutput> = TOutput | {
+    output: TOutput;
+    rawResponse?: string;
+};
+export interface LlmProviderErrorOptions {
+    rawResponse?: string;
+}
+export declare class LlmProviderError extends Error {
+    readonly rawResponse?: string;
+    constructor(message: string, options?: LlmProviderErrorOptions);
+}
+export interface LlmTaskRequest {
+    id: string;
+    intent: string;
+    context: LlmContextBundle;
+    allowedTools: readonly string[];
+    outputChannels: readonly LlmOutputChannel[];
+    modelPreferences?: LlmModelPreferences;
+    responseMode?: LlmResponseMode;
+    streaming?: boolean;
+    toolSchemaFormat?: LlmToolSchemaFormat;
+    providerMetadata?: Record<string, unknown>;
+    budget?: LlmExecutionBudget;
+    requiresPlan?: boolean;
+}
+export interface LlmTaskResult<TOutput extends LlmStructuredOutput = LlmStructuredOutput> {
+    taskId: string;
+    status: LlmTaskStatus;
+    output?: TOutput;
+    rawResponse?: string;
+    diagnostics: readonly LlmDiagnostic[];
+    traceId?: string;
+}
+export type LlmStreamEvent = {
+    type: 'started';
+    taskId: string;
+    traceId: string;
+    providerId: string;
+} | {
+    type: 'raw-delta';
+    delta: string;
+} | {
+    type: 'raw-snapshot';
+    rawResponse: string;
+} | {
+    type: 'diagnostic';
+    diagnostic: LlmDiagnostic;
+} | {
+    type: 'validated-output';
+    output: LlmStructuredOutput;
+    rawResponse: string;
+} | {
+    type: 'completed';
+    result: LlmTaskResult;
+};
+export interface LlmToolDefinition<TInput = unknown, TOutput = unknown> {
+    name: string;
+    description: string;
+    sideEffect: LlmToolSideEffect;
+    requiresDryRun?: boolean;
+    riskLevel?: LlmRiskLevel;
+    execute(input: TInput): Promise<TOutput> | TOutput;
+}
+export interface LlmToolCallRecord {
+    name: string;
+    sideEffect: LlmToolSideEffect;
+    startedAt: string;
+    completedAt?: string;
+    diagnostics?: readonly LlmDiagnostic[];
+}
+export interface LlmProviderRequest {
+    task: LlmTaskRequest;
+    tools: readonly LlmToolDefinition[];
+}
+export interface LlmProvider {
+    id: string;
+    capabilities?: LlmProviderCapabilities;
+    generate(request: LlmProviderRequest): Promise<LlmProviderGenerateResult>;
+    stream?(request: LlmProviderRequest): AsyncIterable<LlmStreamEvent>;
+}
+export interface LlmGatewayTrace {
+    id: string;
+    taskId: string;
+    userIntent: string;
+    modelProviderId: string;
+    context: LlmContextBundle;
+    toolNames: readonly string[];
+    toolCalls: readonly LlmToolCallRecord[];
+    diagnostics: readonly LlmDiagnostic[];
+    startedAt: string;
+    completedAt?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/llm/types.ts"],"names":[],"mappings":"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"}

package/dist/llm/types.js

@@ -0,0 +1,8 @@
+export class LlmProviderError extends Error {
+    rawResponse;
+    constructor(message, options) {
+        super(message);
+        this.name = 'LlmProviderError';
+        this.rawResponse = options?.rawResponse;
+    }
+}

package/dist/types/PdxComponent.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+export interface PdxComponent {
+    className?: string;
+    style?: React.CSSProperties;
+    id?: string;
+    dataAttributes?: Record<string, string>;
+    onClick?: React.MouseEventHandler;
+    as?: React.ElementType;
+}
+//# sourceMappingURL=PdxComponent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PdxComponent.d.ts","sourceRoot":"","sources":["../../src/types/PdxComponent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC;IAClC,EAAE,CAAC,EAAE,KAAK,CAAC,WAAW,CAAC;CACxB"}

package/dist/types/PdxComponent.js

@@ -0,0 +1 @@
+import React from 'react';

package/dist/types/pir.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Generated from PIR Schema v1.0
+ * DO NOT EDIT - Run `pnpm run generate-types` to regenerate
+ */
+export interface PIRDocumentV10 {
+    version: string;
+    metadata?: {
+        name?: string;
+        description?: string;
+        tags?: string[];
+        [k: string]: unknown;
+    };
+    ui: {
+        root: ComponentNode;
+    };
+    logic?: {
+        graphs?: {
+            [k: string]: NodeGraph;
+        };
+        state?: {
+            [k: string]: StateDef;
+        };
+    };
+}
+export interface ComponentNode {
+    id?: string;
+    type: string;
+    text?: string;
+    style?: {
+        [k: string]: unknown;
+    };
+    props?: {
+        [k: string]: unknown;
+    };
+    children?: ComponentNode[];
+    events?: {
+        [k: string]: EventBinding;
+    };
+    binding?: DataBinding;
+    resources?: {
+        [k: string]: Resource;
+    };
+    _comment?: string;
+}
+export interface EventBinding {
+    target: string;
+    payload?: {
+        [k: string]: unknown;
+    };
+    debounce?: number;
+    preventDefault?: boolean;
+}
+export interface DataBinding {
+    path: string;
+    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
+}
+export interface Resource {
+    type: 'file' | 'url' | 'inline';
+    value: string;
+    mimeType?: string;
+}
+export interface NodeGraph {
+    id: string;
+    name?: string;
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+}
+export interface GraphNode {
+    id: string;
+    type: string;
+    inputs?: {
+        [k: string]: unknown;
+    }[];
+    outputs?: {
+        [k: string]: unknown;
+    }[];
+    config?: {
+        [k: string]: unknown;
+    };
+}
+export interface GraphEdge {
+    id: string;
+    source: {
+        nodeId: string;
+        port: string;
+        [k: string]: unknown;
+    };
+    target: {
+        nodeId: string;
+        port: string;
+        [k: string]: unknown;
+    };
+}
+export interface StateDef {
+    type: 'local' | 'global' | 'derived';
+    initial?: unknown;
+    schema?: {
+        [k: string]: unknown;
+    };
+}
+//# sourceMappingURL=pir.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pir.d.ts","sourceRoot":"","sources":["../../src/types/pir.ts"],"names":[],"mappings":"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"}

package/dist/types/pir.js

@@ -0,0 +1,6 @@
+/* eslint-disable */
+/**
+ * Generated from PIR Schema v1.0
+ * DO NOT EDIT - Run `pnpm run generate-types` to regenerate
+ */
+export {};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@prodivix/shared",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./types/*": {
+      "types": "./dist/types/*.d.ts",
+      "import": "./dist/types/*.js"
+    }
+  },
+  "files": [
+    "dist",
+    "scripts"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.2",
+    "json-schema-to-typescript": "^15.0.4",
+    "typescript": "~5.9.3"
+  },
+  "peerDependencies": {
+    "react": "^19.1.1"
+  },
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "chalk": "^5.6.2"
+  },
+  "scripts": {
+    "build": "pnpm run clean && tsc -p tsconfig.json",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "generate-types": "node scripts/generate-types.js"
+  }
+}

package/scripts/generate-types.js

@@ -0,0 +1,39 @@
+import { compileFromFile } from 'json-schema-to-typescript';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const SCHEMA_PATH = path.join(__dirname, '../../../specs/pir/PIR-v1.0.json');
+const OUTPUT_PATH = path.join(__dirname, '../src/types/pir.ts');
+
+console.log('📄 从Schema生成TS类型...');
+console.log(`   Schema: ${SCHEMA_PATH}`);
+console.log(`   输出: ${OUTPUT_PATH}`);
+
+compileFromFile(SCHEMA_PATH, {
+  bannerComment:
+    '/* eslint-disable */\n/**\n * Generated from PIR Schema v1.0\n * DO NOT EDIT - Run `pnpm run generate-types` to regenerate\n */',
+  format: true,
+  style: {
+    singleQuote: true,
+    semi: true,
+    tabWidth: 2,
+  },
+})
+  .then((ts) => {
+    // 确保目录存在
+    fs.mkdirSync(path.dirname(OUTPUT_PATH), { recursive: true });
+
+    // 写入文件
+    fs.writeFileSync(OUTPUT_PATH, ts);
+
+    console.log('✅ 类型生成成功！');
+    console.log(`   共生成 ${ts.split('\n').length} 行类型定义`);
+  })
+  .catch((err) => {
+    console.error('❌ 生成失败:', err.message);
+    process.exit(1);
+  });

package/scripts/validate-pir.js

@@ -0,0 +1,52 @@
+import { readFileSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import Ajv from 'ajv';
+import addFormats from 'ajv-formats';
+import chalk from 'chalk';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const SCHEMA_PATH = resolve(__dirname, '../../../specs/pir/PIR-v1.0.json');
+
+// 创建AJV实例
+const ajv = new Ajv({ allErrors: true, verbose: true });
+addFormats(ajv);
+
+// 编译Schema
+const schema = JSON.parse(readFileSync(SCHEMA_PATH, 'utf-8'));
+const validate = ajv.compile(schema);
+
+// CLI参数
+const pirPath = resolve(process.argv[2] || './project.pir.json');
+
+console.log('🔍 校验PIR文件...');
+console.log(`   Schema: ${SCHEMA_PATH}`);
+console.log(`   文件: ${pirPath}`);
+
+try {
+  const pir = JSON.parse(readFileSync(pirPath, 'utf-8'));
+  const valid = validate(pir);
+
+  if (valid) {
+    console.log(chalk.green('\n✅ PIR格式正确！'));
+    process.exit(0);
+  } else {
+    console.error(chalk.red('\n❌ 校验失败：'));
+    validate.errors?.forEach((error, i) => {
+      console.error(
+        chalk.red(`\n  ${i + 1}. ${error.instancePath || 'root'}`) +
+          chalk.gray(`\n     ${error.message}`) +
+          chalk.yellow(`\n     参数: ${JSON.stringify(error.params)}`)
+      );
+      if (error.schemaPath) {
+        console.error(chalk.gray(`     Schema路径: ${error.schemaPath}`));
+      }
+    });
+    process.exit(1);
+  }
+} catch (error) {
+  console.error(chalk.red(`\n💥 致命错误: ${error.message}`));
+  process.exit(1);
+}