openxiangda-devkit-core 2.0.0-alpha.100

package/dist/compiler/index.d.ts

@@ -0,0 +1,6 @@
+export * from './bundle.js';
+export * from './config.js';
+export * from './package-compiler.js';
+export * from './ai-catalog.js';
+export * from './schema-composition.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/compiler/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC"}

package/dist/compiler/index.js

@@ -0,0 +1,6 @@
+export * from './bundle.js';
+export * from './config.js';
+export * from './package-compiler.js';
+export * from './ai-catalog.js';
+export * from './schema-composition.js';
+//# sourceMappingURL=index.js.map

package/dist/compiler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/compiler/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC"}

package/dist/compiler/package-compiler.d.ts

@@ -0,0 +1,22 @@
+import { type AppArtifact, type AppPackage, type ConfigurationBundleV3, type RequiredPlatformCapabilityContract } from 'openxiangda-contracts';
+import { type OpenXiangdaAppConfig } from './config.js';
+export interface CompileAppPackageInput {
+    config: OpenXiangdaAppConfig;
+    version: string;
+    createdAt?: string;
+    source: AppPackage['source'];
+    toolchainVersion: string;
+    artifacts: AppArtifact[];
+    manifests: AppPackage['manifests'];
+    minimumPlatformVersion: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CompiledAppPackage {
+    manifest: AppPackage;
+    digest: string;
+}
+export declare const NATIVE_GOLDEN_CRUD_CAPABILITY = "data.native-golden-crud";
+export declare function requiredPlatformCapabilities(config: OpenXiangdaAppConfig): RequiredPlatformCapabilityContract[];
+export declare function requiredPlatformCapabilitiesFromConfiguration(config: ConfigurationBundleV3): RequiredPlatformCapabilityContract[];
+export declare function compileAppPackage(input: CompileAppPackageInput): CompiledAppPackage;
+//# sourceMappingURL=package-compiler.d.ts.map

package/dist/compiler/package-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-compiler.d.ts","sourceRoot":"","sources":["../../src/compiler/package-compiler.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,qBAAqB,EAE1B,KAAK,kCAAkC,EACxC,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAEL,KAAK,oBAAoB,EAE1B,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IACnC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,6BAA6B,4BAA4B,CAAC;AAEvE,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,oBAAoB,GAC3B,kCAAkC,EAAE,CAItC;AAED,wBAAgB,6CAA6C,CAC3D,MAAM,EAAE,qBAAqB,GAC5B,kCAAkC,EAAE,CAkRtC;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,sBAAsB,GAC5B,kBAAkB,CA8BpB"}

package/dist/compiler/package-compiler.js

@@ -0,0 +1,246 @@
+import { CURRENT_APPLICATION_CONTRACT, OPENXIANGDA_CONTRACT_VERSION, PLATFORM_CAPABILITY_CONTRACT_VERSIONS, SCHEMA_VERSIONS, assertAppPackage, sha256Digest, } from 'openxiangda-contracts';
+// AppPackage sealing lives in the compiler package so CLI and MCP cannot drift.
+import { AppConfigValidationError, validateAppConfig, } from './config.js';
+import { normalizeConfiguration } from './bundle.js';
+export const NATIVE_GOLDEN_CRUD_CAPABILITY = 'data.native-golden-crud';
+export function requiredPlatformCapabilities(config) {
+    return requiredPlatformCapabilitiesFromConfiguration(normalizeConfiguration(config));
+}
+export function requiredPlatformCapabilitiesFromConfiguration(config) {
+    const operations = config.backend.operations;
+    const requiresDirectoryV2 = config.authz.roles.some(role => role.capabilities.some(capability => capability.endsWith(':directory:read'))) ||
+        config.data.resources.some(resource => resource.schema.fields.some(field => ['user.single', 'user.multiple', 'department.single', 'department.multiple'].includes(field.type))) ||
+        operations.some(operation => operation.platformAccess?.directory);
+    const usesEvents = Boolean(config.events.subscriptions.length ||
+        config.events.timers.length ||
+        config.events.dateTriggers.length ||
+        config.events.schemas.length);
+    const usesManagedFiles = operations.some(operation => operation.platformAccess?.managedFiles ||
+        operation.platformAccess?.managedFileCopies) ||
+        config.events.subscriptions.some(subscription => subscription.platformAccess?.managedFileCopies);
+    const usesNotification = operations.some(operation => operation.platformAccess?.notification) || config.events.subscriptions.some(subscription => subscription.platformAccess?.notification);
+    const standardProcessDefinitions = config.workflows.definitions.filter(declaration => declaration.launch.mode === 'standalone' ||
+        declaration.launch.mode === 'hidden-handoff');
+    const usesBusinessProcess = operations.some(operation => operation.platformAccess?.workflow) ||
+        standardProcessDefinitions.length > 0;
+    const dataUsage = { resources: config.data.resources };
+    const authzUsage = {
+        perspectives: config.perspectives,
+        authz: config.authz,
+    };
+    const runtimeUsage = {
+        schemaVersion: config.schemaVersion,
+        appCode: config.appCode,
+        frontend: {
+            routes: config.frontend.routes || [],
+            user: config.frontend.user,
+            admin: config.frontend.admin,
+            devicePolicy: config.frontend.devicePolicy,
+        },
+        backend: {
+            // Bind runtime routing and declared platform dependencies, but never
+            // hash descriptions, schema examples/defaults or Secret descriptors.
+            operations: operations.map(operation => ({
+                code: operation.code,
+                method: operation.method,
+                path: operation.path,
+                capability: operation.capability,
+                platformAccess: operation.platformAccess || null,
+                ai: operation.ai || null,
+            })),
+        },
+    };
+    const usages = [
+        { code: 'application-native-2', declaration: runtimeUsage },
+        { code: 'authz.native-batch-explain', declaration: authzUsage },
+        { code: 'authz.native-management', declaration: authzUsage },
+        {
+            code: 'deployment.durable-runs',
+            declaration: runtimeUsage.backend,
+        },
+        {
+            code: 'deployment.platform-executor',
+            declaration: runtimeUsage.backend,
+        },
+        {
+            code: 'environment.on-demand-production',
+            declaration: { environments: ['preproduction', 'production'] },
+        },
+        {
+            code: 'environment.runtime-lifecycle',
+            declaration: { environments: ['preproduction', 'production'] },
+        },
+        ...(config.data.resources.length
+            ? [
+                { code: 'data-api-v2', declaration: dataUsage },
+                { code: NATIVE_GOLDEN_CRUD_CAPABILITY, declaration: dataUsage },
+            ]
+            : []),
+        ...(requiresDirectoryV2
+            ? [
+                {
+                    code: 'directory-v2',
+                    declaration: {
+                        roles: config.authz.roles.map(role => ({
+                            code: role.code,
+                            capabilities: role.capabilities.filter(capability => capability.endsWith(':directory:read')),
+                        })),
+                        resources: config.data.resources.map(resource => ({
+                            code: resource.code,
+                            fields: resource.schema.fields.filter(field => [
+                                'user.single',
+                                'user.multiple',
+                                'department.single',
+                                'department.multiple',
+                            ].includes(field.type)),
+                        })),
+                        operations: operations
+                            .filter(operation => operation.platformAccess?.directory)
+                            .map(operation => ({
+                            code: operation.code,
+                            directory: operation.platformAccess.directory,
+                        })),
+                    },
+                },
+            ]
+            : []),
+        ...(usesManagedFiles
+            ? [
+                {
+                    code: 'data.managed-files',
+                    declaration: {
+                        operations: operations
+                            .filter(operation => operation.platformAccess?.managedFiles ||
+                            operation.platformAccess?.managedFileCopies)
+                            .map(operation => ({
+                            code: operation.code,
+                            ...(operation.platformAccess.managedFiles
+                                ? { managedFiles: operation.platformAccess.managedFiles }
+                                : {}),
+                            ...(operation.platformAccess.managedFileCopies
+                                ? {
+                                    managedFileCopies: operation.platformAccess.managedFileCopies,
+                                }
+                                : {}),
+                        })),
+                        subscriptions: config.events.subscriptions
+                            .filter(subscription => subscription.platformAccess?.managedFileCopies)
+                            .map(subscription => ({
+                            code: subscription.code,
+                            managedFileCopies: subscription.platformAccess.managedFileCopies,
+                        })),
+                    },
+                },
+            ]
+            : []),
+        ...(usesEvents
+            ? [
+                { code: 'events-v2', declaration: config.events },
+                { code: 'events.durable-receipts', declaration: config.events },
+            ]
+            : []),
+        ...(config.workflows.activations.length
+            ? [
+                { code: 'workflow-kernel-v2', declaration: config.workflows },
+                {
+                    code: 'workflow.fresh-command-token',
+                    declaration: config.workflows,
+                },
+            ]
+            : []),
+        ...(usesBusinessProcess
+            ? [
+                {
+                    code: 'business-process.durable-command',
+                    declaration: {
+                        operations: operations
+                            .filter(operation => operation.platformAccess?.workflow)
+                            .map(operation => ({
+                            code: operation.code,
+                            workflow: operation.platformAccess.workflow,
+                        })),
+                        definitions: standardProcessDefinitions,
+                        activations: config.workflows.activations.filter(activation => standardProcessDefinitions.some(declaration => declaration.definition.code === activation.workflowCode)),
+                    },
+                },
+            ]
+            : []),
+        ...(usesNotification
+            ? [
+                {
+                    code: 'notification-hub-v2',
+                    declaration: {
+                        operations: operations
+                            .filter(operation => operation.platformAccess?.notification)
+                            .map(operation => ({
+                            code: operation.code,
+                            notification: operation.platformAccess.notification,
+                        })),
+                        subscriptions: config.events.subscriptions
+                            .filter(subscription => subscription.platformAccess?.notification)
+                            .map(subscription => ({
+                            code: subscription.code,
+                            notification: subscription.platformAccess.notification,
+                        })),
+                    },
+                },
+            ]
+            : []),
+        ...(config.frontend.authentication
+            ? [
+                {
+                    code: 'authentication.application-login-surface',
+                    declaration: config.frontend.authentication,
+                },
+            ]
+            : []),
+        ...(config.frontend.publicAccess
+            ? [
+                {
+                    code: 'public-access.anonymous-owner-records',
+                    declaration: config.frontend.publicAccess,
+                },
+            ]
+            : []),
+    ];
+    return usages
+        .map(({ code, declaration }) => ({
+        code,
+        contractVersion: PLATFORM_CAPABILITY_CONTRACT_VERSIONS[code],
+        usageDigest: `sha256:${sha256Digest(declaration)}`,
+    }))
+        .sort((left, right) => left.code === right.code ? 0 : left.code < right.code ? -1 : 1);
+}
+export function compileAppPackage(input) {
+    const diagnostics = validateAppConfig(input.config);
+    if (diagnostics.length > 0)
+        throw new AppConfigValidationError(diagnostics);
+    const manifest = {
+        schemaVersion: SCHEMA_VERSIONS.appPackage,
+        appCode: input.config.app.code,
+        version: input.version,
+        createdAt: input.createdAt || new Date().toISOString(),
+        source: { ...input.source },
+        toolchain: {
+            version: input.toolchainVersion,
+            contractVersion: OPENXIANGDA_CONTRACT_VERSION,
+        },
+        artifacts: [...input.artifacts].sort((left, right) => {
+            if (left.kind !== right.kind)
+                return left.kind < right.kind ? -1 : 1;
+            if (left.digest === right.digest)
+                return 0;
+            return left.digest < right.digest ? -1 : 1;
+        }),
+        manifests: { ...input.manifests },
+        compatibility: {
+            minimumPlatformVersion: input.minimumPlatformVersion,
+            applicationContract: { ...CURRENT_APPLICATION_CONTRACT },
+            requiredPlatformCapabilities: requiredPlatformCapabilitiesFromConfiguration(normalizeConfiguration(input.config)),
+        },
+        ...(input.metadata ? { metadata: { ...input.metadata } } : {}),
+    };
+    assertAppPackage(manifest);
+    return { manifest, digest: sha256Digest(manifest) };
+}
+//# sourceMappingURL=package-compiler.js.map

package/dist/compiler/package-compiler.js.map

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

package/dist/compiler/schema-composition.d.ts

@@ -0,0 +1,21 @@
+import { type AppApiOperationDeclaration, type OpenXiangdaJsonSchema } from 'openxiangda-contracts';
+import type { AppDataResourceDeclaration } from './config.js';
+export type JsonSchemaDefinitions = Readonly<Record<string, OpenXiangdaJsonSchema>>;
+export interface ResourceRecordSchemaOptions {
+    /** Defaults to every declared field, in declaration order. */
+    fields?: readonly string[];
+    /** Defaults to fields declared with `required: true`. */
+    required?: 'declared' | 'none' | readonly string[];
+    /** Defaults to false so operation payloads cannot smuggle undeclared fields. */
+    additionalProperties?: boolean;
+}
+export interface AppOperationSchemasInput {
+    request: OpenXiangdaJsonSchema;
+    response: OpenXiangdaJsonSchema;
+    definitions?: JsonSchemaDefinitions;
+}
+export declare function schemaRef(definitionName: string): OpenXiangdaJsonSchema;
+export declare function composeJsonSchema(schema: OpenXiangdaJsonSchema, definitions?: JsonSchemaDefinitions): OpenXiangdaJsonSchema;
+export declare function composeAppOperationSchemas(input: AppOperationSchemasInput): Pick<AppApiOperationDeclaration, 'requestSchema' | 'responseSchema'>;
+export declare function resourceRecordSchema(resource: AppDataResourceDeclaration, options?: ResourceRecordSchemaOptions): OpenXiangdaJsonSchema;
+//# sourceMappingURL=schema-composition.d.ts.map

package/dist/compiler/schema-composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-composition.d.ts","sourceRoot":"","sources":["../../src/compiler/schema-composition.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAEV,0BAA0B,EAC3B,MAAM,aAAa,CAAC;AAQrB,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAC1C,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CACtC,CAAC;AAEF,MAAM,WAAW,2BAA2B;IAC1C,8DAA8D;IAC9D,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IACnD,gFAAgF;IAChF,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,WAAW,CAAC,EAAE,qBAAqB,CAAC;CACrC;AAED,wBAAgB,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,qBAAqB,CAGvE;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,qBAAqB,EAC7B,WAAW,GAAE,qBAA0B,GACtC,qBAAqB,CAiCvB;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,wBAAwB,GAC9B,IAAI,CAAC,0BAA0B,EAAE,eAAe,GAAG,gBAAgB,CAAC,CAKtE;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,0BAA0B,EACpC,OAAO,GAAE,2BAAgC,GACxC,qBAAqB,CAyCvB"}

package/dist/compiler/schema-composition.js

@@ -0,0 +1,193 @@
+import { fieldValueSchemaForDefinition, } from 'openxiangda-contracts';
+const DEFINITION_NAME = /^[A-Za-z][A-Za-z0-9_-]{0,63}$/;
+const MAX_DEFINITIONS = 64;
+const MAX_RESOURCE_FIELDS = 200;
+const MAX_SCHEMA_NODES = 10_000;
+const MAX_SCHEMA_DEPTH = 32;
+export function schemaRef(definitionName) {
+    assertDefinitionName(definitionName);
+    return { $ref: `#/$defs/${definitionName}` };
+}
+export function composeJsonSchema(schema, definitions = {}) {
+    const root = cloneSchema(schema);
+    const authoredDefinitions = root.$defs;
+    if (authoredDefinitions !== undefined &&
+        (!isRecord(authoredDefinitions) || Array.isArray(authoredDefinitions))) {
+        throw schemaCompositionError('$defs 必须是 JSON Schema 对象字典');
+    }
+    delete root.$defs;
+    const combined = new Map();
+    for (const [name, value] of Object.entries((authoredDefinitions || {}))) {
+        addDefinition(combined, name, value);
+    }
+    for (const [name, value] of Object.entries(definitions)) {
+        addDefinition(combined, name, value);
+    }
+    if (combined.size > MAX_DEFINITIONS) {
+        throw schemaCompositionError(`JSON Schema definitions 不能超过 ${MAX_DEFINITIONS} 个`);
+    }
+    const sortedDefinitions = Object.fromEntries([...combined.entries()].sort(([left], [right]) => left.localeCompare(right)));
+    const composed = combined.size > 0 ? { ...root, $defs: sortedDefinitions } : root;
+    validateLocalReferences(composed, new Set(combined.keys()));
+    return composed;
+}
+export function composeAppOperationSchemas(input) {
+    return {
+        requestSchema: composeJsonSchema(input.request, input.definitions),
+        responseSchema: composeJsonSchema(input.response, input.definitions),
+    };
+}
+export function resourceRecordSchema(resource, options = {}) {
+    const fieldsByCode = new Map(resource.fields.map(field => [field.code, field]));
+    if (fieldsByCode.size !== resource.fields.length) {
+        throw schemaCompositionError(`资源 ${resource.code} 包含重复字段 code`);
+    }
+    const selectedCodes = options.fields
+        ? [...options.fields]
+        : resource.fields.map(field => field.code);
+    if (selectedCodes.length > MAX_RESOURCE_FIELDS) {
+        throw schemaCompositionError(`Resource schema fields 不能超过 ${MAX_RESOURCE_FIELDS} 个`);
+    }
+    assertUniqueSelectedFields(selectedCodes);
+    const selectedFields = selectedCodes.map(code => {
+        const field = fieldsByCode.get(code);
+        if (!field) {
+            throw schemaCompositionError(`资源 ${resource.code} 未声明字段 ${code}`);
+        }
+        return field;
+    });
+    const required = resolveRequiredFields(options.required, selectedFields);
+    const schema = {
+        type: 'object',
+        title: resource.name,
+        additionalProperties: options.additionalProperties === true,
+        properties: Object.fromEntries(selectedFields.map(field => [
+            field.code,
+            projectFieldValueSchema(field),
+        ])),
+        ...(required.length > 0 ? { required } : {}),
+    };
+    return schema;
+}
+function projectFieldValueSchema(field) {
+    const schema = fieldValueSchemaForDefinition(field);
+    schema.title = field.label;
+    if (field.min !== undefined &&
+        (field.type === 'number.integer' || field.type === 'number.decimal')) {
+        schema.minimum = field.min;
+    }
+    if (field.max !== undefined &&
+        (field.type === 'number.integer' || field.type === 'number.decimal')) {
+        schema.maximum = field.max;
+    }
+    if (field.maxLength !== undefined &&
+        (field.type === 'text.short' ||
+            field.type === 'text.long' ||
+            field.type === 'text.rich')) {
+        schema.maxLength = Math.min(typeof schema.maxLength === 'number'
+            ? schema.maxLength
+            : field.maxLength, field.maxLength);
+    }
+    if (field.file?.maxCount !== undefined && isArraySchema(schema)) {
+        schema.maxItems = Math.min(typeof schema.maxItems === 'number' ? schema.maxItems : field.file.maxCount, field.file.maxCount);
+    }
+    if (field.subtable?.maxRows !== undefined &&
+        field.type === 'subtable' &&
+        isArraySchema(schema)) {
+        schema.maxItems = Math.min(typeof schema.maxItems === 'number'
+            ? schema.maxItems
+            : field.subtable.maxRows, field.subtable.maxRows);
+    }
+    if (field.type === 'resource-ref.single' && field.source) {
+        constrainResourceCode(schema, field.source.resourceCode);
+    }
+    if (field.type === 'resource-ref.multiple' && field.source) {
+        const items = isRecord(schema.items) ? schema.items : undefined;
+        if (items)
+            constrainResourceCode(items, field.source.resourceCode);
+    }
+    return schema;
+}
+function constrainResourceCode(schema, resourceCode) {
+    const properties = isRecord(schema.properties)
+        ? schema.properties
+        : undefined;
+    if (properties) {
+        properties.resourceCode = { const: resourceCode };
+    }
+}
+function resolveRequiredFields(required, selectedFields) {
+    if (required === 'none')
+        return [];
+    if (required === undefined || required === 'declared') {
+        return selectedFields
+            .filter(field => field.required === true)
+            .map(field => field.code);
+    }
+    const selected = new Set(selectedFields.map(field => field.code));
+    assertUniqueSelectedFields(required);
+    for (const code of required) {
+        if (!selected.has(code)) {
+            throw schemaCompositionError(`required 引用了未选择字段 ${code}`);
+        }
+    }
+    return [...required];
+}
+function assertUniqueSelectedFields(fields) {
+    if (new Set(fields).size !== fields.length) {
+        throw schemaCompositionError('Resource schema fields 不能重复');
+    }
+}
+function addDefinition(definitions, name, value) {
+    assertDefinitionName(name);
+    if (!isRecord(value) || Array.isArray(value)) {
+        throw schemaCompositionError(`definition ${name} 必须是 JSON Schema 对象`);
+    }
+    if (definitions.has(name)) {
+        throw schemaCompositionError(`definition ${name} 重复`);
+    }
+    definitions.set(name, cloneSchema(value));
+}
+function assertDefinitionName(name) {
+    if (!DEFINITION_NAME.test(name)) {
+        throw schemaCompositionError(`非法 JSON Schema definition 名称: ${name}`);
+    }
+}
+function validateLocalReferences(root, definitions) {
+    let nodes = 0;
+    const visit = (value, depth) => {
+        nodes += 1;
+        if (nodes > MAX_SCHEMA_NODES || depth > MAX_SCHEMA_DEPTH) {
+            throw schemaCompositionError('JSON Schema 超出组合深度或节点上限');
+        }
+        if (Array.isArray(value)) {
+            for (const item of value)
+                visit(item, depth + 1);
+            return;
+        }
+        if (!isRecord(value))
+            return;
+        if ('$ref' in value) {
+            const match = /^#\/\$defs\/([A-Za-z][A-Za-z0-9_-]{0,63})$/.exec(String(value.$ref));
+            if (!match || !definitions.has(match[1])) {
+                throw schemaCompositionError(`只允许引用已声明的本地 $defs: ${value.$ref}`);
+            }
+        }
+        for (const child of Object.values(value))
+            visit(child, depth + 1);
+    };
+    visit(root, 0);
+}
+function cloneSchema(schema) {
+    return structuredClone(schema);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function schemaCompositionError(message) {
+    return new Error(`OPENXIANGDA_SCHEMA_COMPOSITION_INVALID: ${message}`);
+}
+function isArraySchema(schema) {
+    return schema.type === 'array';
+}
+//# sourceMappingURL=schema-composition.js.map

package/dist/compiler/schema-composition.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,2 @@
+export * from './compiler/config.js';
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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

package/dist/config.js

@@ -0,0 +1,2 @@
+export * from './compiler/config.js';
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/connected-development.d.ts

@@ -0,0 +1,62 @@
+import type { ApplicationEnvironment, DeploymentEnvironment } from "openxiangda-contracts";
+import type { OpenXiangdaDeveloperSession } from "./session.js";
+export interface ConnectedDevelopmentGrant {
+    id: string;
+    token: string;
+    expiresAt: string;
+    mode: "published-resources" | "manifest-overlay";
+    manifestOverlay: boolean;
+    manifestDigest: string | null;
+}
+export interface ConnectedDevelopmentSessionApi {
+    create(): Promise<ConnectedDevelopmentGrant>;
+    current(token: string): Promise<Omit<ConnectedDevelopmentGrant, "token">>;
+    refresh(token: string): Promise<Omit<ConnectedDevelopmentGrant, "token">>;
+    revoke(token: string): Promise<void>;
+}
+export interface ConnectedDevelopmentOptions {
+    root: string;
+    appCode: string;
+    platformBaseUrl: string;
+    environment: ApplicationEnvironment;
+    developerSession: OpenXiangdaDeveloperSession;
+    remoteSession: ConnectedDevelopmentSessionApi;
+    noOpen?: boolean;
+    webPort?: number;
+    onStatus?: (message: string) => void;
+    readinessTimeoutMs?: number;
+    /** @internal deterministic proxy port for verification. */
+    proxyPort?: number;
+    /** @internal observes a ready session without exposing credentials. */
+    onReady?: (session: ConnectedDevelopmentSession) => void | Promise<void>;
+}
+export interface ConnectedDevelopmentSession {
+    mode: "connected";
+    appCode: string;
+    environment: {
+        key: DeploymentEnvironment;
+        label: "test" | "production";
+        id: string;
+        productionData: boolean;
+    };
+    urls: {
+        web: string;
+        app: string;
+        proxy: string;
+        platform: string;
+    };
+    ports: {
+        web: number;
+        app: number;
+        proxy: number;
+    };
+    publishedResourcesOnly: boolean;
+    manifestOverlay: boolean;
+}
+export interface ConnectedDevelopmentResult {
+    exitCode: number;
+    session: ConnectedDevelopmentSession;
+}
+export declare function selectConnectedDevelopmentEnvironment(environments: ApplicationEnvironment[]): ApplicationEnvironment | undefined;
+export declare function runConnectedDevelopment(input: ConnectedDevelopmentOptions): Promise<ConnectedDevelopmentResult>;
+//# sourceMappingURL=connected-development.d.ts.map

package/dist/connected-development.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connected-development.d.ts","sourceRoot":"","sources":["../src/connected-development.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAOhE,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,qBAAqB,GAAG,kBAAkB,CAAC;IACjD,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,8BAA8B;IAC7C,MAAM,IAAI,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC7C,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1E,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1E,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,sBAAsB,CAAC;IACpC,gBAAgB,EAAE,2BAA2B,CAAC;IAC9C,aAAa,EAAE,8BAA8B,CAAC;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,2BAA2B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1E;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE;QACX,GAAG,EAAE,qBAAqB,CAAC;QAC3B,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;QAC7B,EAAE,EAAE,MAAM,CAAC;QACX,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,IAAI,EAAE;QACJ,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,sBAAsB,EAAE,OAAO,CAAC;IAChC,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,2BAA2B,CAAC;CACtC;AAED,wBAAgB,qCAAqC,CACnD,YAAY,EAAE,sBAAsB,EAAE,sCASvC;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,0BAA0B,CAAC,CAgKrC"}