@kumwe/studio-testkit 0.1.0-alpha.10

package/dist/index.js

@@ -0,0 +1,211 @@
+import { BlockRegistry, compileStudioPropertySchema, projectBlueprintFieldBindings, StudioSchemaProfileError, validateBlueprint, } from '@kumwe/studio-core';
+import { STUDIO_CONTRACT_VERSION, STUDIO_WIRE_PROTOCOL_VERSION, } from '@kumwe/studio-protocol';
+export { createHostRequestContextFixture, createTestbedHost, TestbedHostError, } from './host-testbed.js';
+export { createHttpHostAdapter, } from './http-host-adapter.js';
+export { runAuthoringWebVector, } from './web-conformance.js';
+/**
+ * Replays a binding vector without consulting its expected projection. The
+ * normalized result intentionally excludes localized labels and prose so a
+ * non-TypeScript host compares stable coordinates, controls, outcomes, and
+ * diagnostic locations rather than an English rendering.
+ */
+export function runBindingProjectionVector(vector) {
+    const projection = projectBlueprintFieldBindings(vector.blueprint, vector.model, vector.blockDefinitions);
+    return cloneValue({
+        diagnostics: projection.diagnostics.map((entry) => ({
+            code: entry.code,
+            ...(entry.location === undefined ? {} : { location: entry.location }),
+            severity: entry.severity,
+        })),
+        model: projection.model,
+        nodes: projection.nodes.map((node) => ({
+            nodeId: node.nodeId,
+            ports: node.ports.map((port) => ({
+                ...(port.binding === undefined ? {} : { bindingSourceKind: port.binding.source.kind }),
+                ...(port.boundFieldPath === undefined ? {} : { boundFieldPath: [...port.boundFieldPath] }),
+                candidates: port.candidates.map((candidate) => ({
+                    cardinality: candidate.cardinality,
+                    ...(candidate.control === undefined ? {} : { control: candidate.control }),
+                    fieldPath: [...candidate.fieldPath],
+                    ...(candidate.itemKind === undefined ? {} : { itemKind: candidate.itemKind }),
+                    kind: candidate.kind,
+                })),
+                ...(port.multiple === undefined ? {} : { multiple: port.multiple }),
+                port: port.port,
+                ...(port.required === undefined ? {} : { required: port.required }),
+                status: port.status,
+                ...(port.valueType === undefined ? {} : { valueType: port.valueType }),
+            })),
+        })),
+    });
+}
+/**
+ * Replay a portable `studio.profile/schema-property` vector against the
+ * reference implementation. Only each case's input `value` is read from the
+ * accepted expectation; expected verdicts and diagnostics are not consulted.
+ * Callers compare this independently produced outcome with the published
+ * `expect` member.
+ */
+export function runSchemaProfileVector(vector) {
+    try {
+        const validator = compileStudioPropertySchema(vector.schema);
+        const instances = (vector.expect.instances ?? []).map((entry) => {
+            const valid = validator.validate(entry.value);
+            const first = validator.errors?.[0];
+            return {
+                ...(first === undefined
+                    ? {}
+                    : { diagnostic: { instancePath: first.instancePath, keyword: first.keyword } }),
+                valid,
+                value: entry.value,
+            };
+        });
+        return { instances, outcome: 'accepted' };
+    }
+    catch (error) {
+        if (error instanceof StudioSchemaProfileError) {
+            return {
+                code: error.code,
+                outcome: 'rejected',
+                schemaPath: error.schemaPath,
+            };
+        }
+        throw error;
+    }
+}
+export function createBlueprintFixture(options = {}) {
+    return {
+        contractVersion: STUDIO_CONTRACT_VERSION,
+        dependencyLock: {
+            blocks: cloneValue(options.blockLocks ?? []),
+            theme: { id: 'studio.test/theme', revision: 'theme-r1', version: '1.0.0' },
+        },
+        id: options.id ?? 'test.blueprint',
+        kind: 'blueprint',
+        label: { defaultMessage: 'Test Blueprint', key: 'studio.test/blueprint' },
+        model: { id: 'studio.test/model', revision: 'model-r1', version: '1.0.0' },
+        owner: { id: 'studio.test/testkit', version: '0.1.0-alpha.0' },
+        revision: options.revision ?? 'blueprint-r1',
+        roots: cloneValue(options.roots ?? []),
+        status: 'draft',
+        version: '1.0.0',
+    };
+}
+export function defineTestBlock(options) {
+    const label = options.label ?? 'Test block';
+    return {
+        accessibility: {
+            accessibleName: 'not-applicable',
+            category: 'structural',
+            keyboard: { defaultMessage: 'Use outline commands.', key: 'studio.test/block-keyboard' },
+            outputChecks: ['studio.check/test-block'],
+            reducedMotion: 'not-applicable',
+        },
+        category: 'studio.category/test',
+        contractVersion: STUDIO_CONTRACT_VERSION,
+        editingModes: ['blueprint', 'content'],
+        kind: 'block-definition',
+        label: { defaultMessage: label, key: 'studio.test/block-label' },
+        owner: { id: 'studio.test/testkit', version: '0.1.0-alpha.0' },
+        ports: [],
+        propertySchema: cloneValue(options.propertySchema ?? { additionalProperties: false, type: 'object' }),
+        rendererRequirements: [
+            { capability: 'studio.renderer/test', surface: 'preview', versions: '^0.1.0' },
+        ],
+        revision: 'block-r1',
+        slots: cloneValue(options.slots ?? []),
+        themeControls: [],
+        type: options.type,
+        version: options.version ?? '1.0.0',
+    };
+}
+export function createStudioConfigurationFixture(options = {}) {
+    return {
+        actor: { displayName: 'Test Author', id: 'users/test-author' },
+        artifacts: {},
+        blocks: [],
+        composite: options.composite ?? 'single',
+        contractVersion: STUDIO_CONTRACT_VERSION,
+        displayPreferences: {
+            calendar: 'gregory',
+            hourCycle: 'h23',
+            measurementSystem: 'metric',
+            numberingSystem: 'latn',
+        },
+        features: {
+            clipboardMediaUpload: false,
+            collaboration: false,
+            customInspectors: false,
+            executablePlugins: false,
+            externalMediaImport: false,
+            offlineRecovery: false,
+        },
+        hostCapabilities: {
+            capabilities: [],
+            contractVersion: STUDIO_CONTRACT_VERSION,
+            host: { generation: 'host-r1', id: 'studio.test/host', version: '1.0.0' },
+            kind: 'host-capabilities',
+            ports: [],
+            protocolVersions: [STUDIO_WIRE_PROTOCOL_VERSION],
+        },
+        limits: {
+            maxChildrenPerSlot: 1_000,
+            maxCommandBatch: 100,
+            maxContributionsPerPlugin: 500,
+            maxDepth: 32,
+            maxExtensionBytes: 1_048_576,
+            maxHistoryEntries: 100,
+            maxLocaleBytes: 1_048_576,
+            maxMediaBatch: 50,
+            maxMediaUploadBytes: 1_073_741_824,
+            maxNodes: 5_000,
+            maxPluginCount: 20,
+            maxPreviewBytes: 10_485_760,
+            maxPreviewRequestsPerMinute: 120,
+            maxPropertyBytes: 1_048_576,
+            maxRichTextBytes: 1_048_576,
+            maxRichTextDepth: 32,
+            maxSlotsPerNode: 20,
+        },
+        locale: {
+            direction: 'ltr',
+            fallbacks: [],
+            requested: 'en',
+            resolved: 'en',
+            timeZone: 'UTC',
+        },
+        mode: options.mode ?? 'blueprint',
+        permissions: [],
+        plugins: [],
+        protocolVersion: STUDIO_WIRE_PROTOCOL_VERSION,
+        preview: { allowApproximateRenderer: false, enabled: false, sameOriginRequired: true },
+        sessionGeneration: 'session-r1',
+        sessionId: 'session-test',
+        sessionState: options.sessionState ?? 'editable',
+        resourceContext: {
+            key: 'contexts/test',
+            scopes: [],
+            surface: 'studio.test/fixture',
+        },
+    };
+}
+export function assertBlueprintConforms(blueprint, definitions) {
+    const result = validateBlueprint(blueprint, new BlockRegistry(definitions));
+    if (!result.valid) {
+        throw new StudioConformanceError(result.diagnostics);
+    }
+}
+export class StudioConformanceError extends Error {
+    diagnostics;
+    constructor(diagnostics) {
+        super(diagnostics
+            .map((entry) => `${entry.code}: ${entry.message.defaultMessage ?? entry.message.key}`)
+            .join('\n'));
+        this.name = 'StudioConformanceError';
+        this.diagnostics = cloneValue(diagnostics);
+    }
+}
+function cloneValue(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,6BAA6B,EAC7B,wBAAwB,EACxB,iBAAiB,GAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,uBAAuB,EACvB,4BAA4B,GAc7B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,+BAA+B,EAC/B,iBAAiB,EACjB,gBAAgB,GAOjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,qBAAqB,GAMtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,qBAAqB,GAYtB,MAAM,sBAAsB,CAAC;AAgE9B;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAoC;IAEpC,MAAM,UAAU,GAAG,6BAA6B,CAC9C,MAAM,CAAC,SAAS,EAChB,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,gBAAgB,CACxB,CAAC;IACF,OAAO,UAAU,CAAC;QAChB,WAAW,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAClD,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrE,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;QACH,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACrC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC/B,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACtF,GAAG,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC1F,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;oBAC9C,WAAW,EAAE,SAAS,CAAC,WAAW;oBAClC,GAAG,CAAC,SAAS,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,CAAC;oBAC1E,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC;oBACnC,GAAG,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC;oBAC7E,IAAI,EAAE,SAAS,CAAC,IAAI;iBACrB,CAAC,CAAC;gBACH,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACnE,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACnE,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;aACvE,CAAC,CAAC;SACJ,CAAC,CAAC;KACJ,CAAC,CAAC;AACL,CAAC;AAwBD;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAA4F;IAE5F,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,2BAA2B,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YAC9D,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC9C,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;YACpC,OAAO;gBACL,GAAG,CAAC,KAAK,KAAK,SAAS;oBACrB,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBACjF,KAAK;gBACL,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAC5C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,wBAAwB,EAAE,CAAC;YAC9C,OAAO;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,OAAO,EAAE,UAAU;gBACnB,UAAU,EAAE,KAAK,CAAC,UAAU;aAC7B,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,UAAmC,EAAE;IAC1E,OAAO;QACL,eAAe,EAAE,uBAAuB;QACxC,cAAc,EAAE;YACd,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;YAC5C,KAAK,EAAE,EAAE,EAAE,EAAE,mBAAmB,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE;SAC3E;QACD,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,gBAAgB;QAClC,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,EAAE,cAAc,EAAE,gBAAgB,EAAE,GAAG,EAAE,uBAAuB,EAAE;QACzE,KAAK,EAAE,EAAE,EAAE,EAAE,mBAAmB,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE;QAC1E,KAAK,EAAE,EAAE,EAAE,EAAE,qBAAqB,EAAE,OAAO,EAAE,eAAe,EAAE;QAC9D,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,cAAc;QAC5C,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QACtC,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,OAAO;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC;IAC5C,OAAO;QACL,aAAa,EAAE;YACb,cAAc,EAAE,gBAAgB;YAChC,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,EAAE,cAAc,EAAE,uBAAuB,EAAE,GAAG,EAAE,4BAA4B,EAAE;YACxF,YAAY,EAAE,CAAC,yBAAyB,CAAC;YACzC,aAAa,EAAE,gBAAgB;SAChC;QACD,QAAQ,EAAE,sBAAsB;QAChC,eAAe,EAAE,uBAAuB;QACxC,YAAY,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;QACtC,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,EAAE,yBAAyB,EAAE;QAChE,KAAK,EAAE,EAAE,EAAE,EAAE,qBAAqB,EAAE,OAAO,EAAE,eAAe,EAAE;QAC9D,KAAK,EAAE,EAAE;QACT,cAAc,EAAE,UAAU,CACxB,OAAO,CAAC,cAAc,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAC1E;QACD,oBAAoB,EAAE;YACpB,EAAE,UAAU,EAAE,sBAAsB,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE;SAC/E;QACD,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QACtC,aAAa,EAAE,EAAE;QACjB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,UAA6C,EAAE;IAE/C,OAAO;QACL,KAAK,EAAE,EAAE,WAAW,EAAE,aAAa,EAAE,EAAE,EAAE,mBAAmB,EAAE;QAC9D,SAAS,EAAE,EAAE;QACb,MAAM,EAAE,EAAE;QACV,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,QAAQ;QACxC,eAAe,EAAE,uBAAuB;QACxC,kBAAkB,EAAE;YAClB,QAAQ,EAAE,SAAS;YACnB,SAAS,EAAE,KAAK;YAChB,iBAAiB,EAAE,QAAQ;YAC3B,eAAe,EAAE,MAAM;SACxB;QACD,QAAQ,EAAE;YACR,oBAAoB,EAAE,KAAK;YAC3B,aAAa,EAAE,KAAK;YACpB,gBAAgB,EAAE,KAAK;YACvB,iBAAiB,EAAE,KAAK;YACxB,mBAAmB,EAAE,KAAK;YAC1B,eAAe,EAAE,KAAK;SACvB;QACD,gBAAgB,EAAE;YAChB,YAAY,EAAE,EAAE;YAChB,eAAe,EAAE,uBAAuB;YACxC,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE;YACzE,IAAI,EAAE,mBAAmB;YACzB,KAAK,EAAE,EAAE;YACT,gBAAgB,EAAE,CAAC,4BAA4B,CAAC;SACjD;QACD,MAAM,EAAE;YACN,kBAAkB,EAAE,KAAK;YACzB,eAAe,EAAE,GAAG;YACpB,yBAAyB,EAAE,GAAG;YAC9B,QAAQ,EAAE,EAAE;YACZ,iBAAiB,EAAE,SAAS;YAC5B,iBAAiB,EAAE,GAAG;YACtB,cAAc,EAAE,SAAS;YACzB,aAAa,EAAE,EAAE;YACjB,mBAAmB,EAAE,aAAa;YAClC,QAAQ,EAAE,KAAK;YACf,cAAc,EAAE,EAAE;YAClB,eAAe,EAAE,UAAU;YAC3B,2BAA2B,EAAE,GAAG;YAChC,gBAAgB,EAAE,SAAS;YAC3B,gBAAgB,EAAE,SAAS;YAC3B,gBAAgB,EAAE,EAAE;YACpB,eAAe,EAAE,EAAE;SACpB;QACD,MAAM,EAAE;YACN,SAAS,EAAE,KAAK;YAChB,SAAS,EAAE,EAAE;YACb,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,KAAK;SAChB;QACD,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,WAAW;QACjC,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,EAAE;QACX,eAAe,EAAE,4BAA4B;QAC7C,OAAO,EAAE,EAAE,wBAAwB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE;QACtF,iBAAiB,EAAE,YAAY;QAC/B,SAAS,EAAE,cAAc;QACzB,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,UAAU;QAChD,eAAe,EAAE;YACf,GAAG,EAAE,eAAe;YACpB,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,qBAAqB;SAC/B;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,SAA4B,EAC5B,WAAuC;IAEvC,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,EAAE,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;IAC5E,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,sBAAsB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/B,WAAW,CAAqB;IAEhD,YAAmB,WAA+B;QAChD,KAAK,CACH,WAAW;aACR,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;aACrF,IAAI,CAAC,IAAI,CAAC,CACd,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,SAAS,UAAU,CAAI,KAAQ;IAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAM,CAAC;AAChD,CAAC"}

package/dist/web-conformance.d.ts

@@ -0,0 +1,105 @@
+import type { BlueprintDocument, JsonObject, JsonValue, QualifiedName, StableId } from '@kumwe/studio-protocol';
+export type AuthoringWebRegion = 'canvas' | 'command-palette' | 'inspector' | 'outline' | 'palette' | 'preview' | 'viewport';
+export type AuthoringWebAction = {
+    kind: 'focus-node';
+    nodeId: StableId;
+    region: AuthoringWebRegion;
+} | {
+    key: 'ArrowDown' | 'ArrowLeft' | 'ArrowRight' | 'ArrowUp' | 'Delete' | 'End' | 'Enter' | 'Escape' | 'Home' | 'Tab' | 'd' | 'y' | 'z';
+    kind: 'key';
+    modifiers: ('Alt' | 'Control' | 'Meta' | 'Shift')[];
+    region: AuthoringWebRegion;
+} | {
+    destination: {
+        parentNodeId?: StableId;
+        position: number;
+        slot?: string;
+    };
+    kind: 'drag-node';
+    nodeId: StableId;
+} | {
+    kind: 'activate-command';
+    payload: JsonObject;
+    region: AuthoringWebRegion;
+    type: QualifiedName;
+} | {
+    kind: 'edit-property';
+    nodeId: StableId;
+    property: string;
+    value: JsonValue;
+    viewport?: string;
+};
+export interface AuthoringWebGiven {
+    direction: 'ltr' | 'rtl';
+    document: BlueprintDocument;
+    locale: string;
+    readOnly: boolean;
+    reducedMotion: boolean;
+    selection: StableId | null;
+    viewport: {
+        height: number;
+        width: number;
+        zoomPercent: number;
+    };
+}
+export interface AuthoringWebCommandObservation {
+    payload: JsonObject;
+    type: QualifiedName;
+}
+export interface AuthoringWebObservation {
+    announcements: {
+        key: QualifiedName;
+        politeness: 'assertive' | 'polite';
+    }[];
+    commands: AuthoringWebCommandObservation[];
+    dirty: boolean;
+    document: BlueprintDocument;
+    focus: {
+        nodeId?: StableId;
+        region: AuthoringWebRegion;
+    };
+    selection: StableId | null;
+}
+export interface AuthoringWebLane {
+    name: string;
+    steps: AuthoringWebAction[];
+    surface: 'keyboard' | 'pointer' | 'structural-control';
+}
+export interface AuthoringWebVector {
+    contractVersion: string;
+    description: string;
+    expect: AuthoringWebObservation;
+    given: AuthoringWebGiven;
+    id: QualifiedName;
+    kind: 'authoring-web-vector';
+    lanes: AuthoringWebLane[];
+    requirements: string[];
+}
+export interface AuthoringWebConformanceSession {
+    dispose?(): Promise<void> | void;
+    observe(): Promise<AuthoringWebObservation> | AuthoringWebObservation;
+    perform(action: Readonly<AuthoringWebAction>): Promise<void> | void;
+}
+export interface AuthoringWebConformanceAdapter {
+    open(given: Readonly<AuthoringWebGiven>, lane: Readonly<AuthoringWebLane>): Promise<AuthoringWebConformanceSession> | AuthoringWebConformanceSession;
+}
+export interface AuthoringWebLaneResult {
+    mismatches: string[];
+    name: string;
+    observation: AuthoringWebObservation;
+    passed: boolean;
+    surface: AuthoringWebLane['surface'];
+}
+export interface AuthoringWebVectorResult {
+    lanes: AuthoringWebLaneResult[];
+    passed: boolean;
+    profile: 'studio.profile/authoring-web';
+    vectorId: QualifiedName;
+}
+/**
+ * Replay every interaction lane from an independent copy of the same initial
+ * state. The adapter owns browser automation; this runner owns fixture
+ * isolation and deterministic observation comparison.
+ */
+export declare function runAuthoringWebVector(vector: Readonly<AuthoringWebVector>, adapter: Readonly<AuthoringWebConformanceAdapter>): Promise<AuthoringWebVectorResult>;
+//# sourceMappingURL=web-conformance.d.ts.map

package/dist/web-conformance.d.ts.map

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

package/dist/web-conformance.js

@@ -0,0 +1,72 @@
+/**
+ * Replay every interaction lane from an independent copy of the same initial
+ * state. The adapter owns browser automation; this runner owns fixture
+ * isolation and deterministic observation comparison.
+ */
+export async function runAuthoringWebVector(vector, adapter) {
+    const pristine = stableJson(vector);
+    const lanes = [];
+    for (const lane of vector.lanes) {
+        const session = await adapter.open(cloneJson(vector.given), cloneJson(lane));
+        let observation;
+        try {
+            for (const action of lane.steps) {
+                await session.perform(cloneJson(action));
+            }
+            observation = cloneJson(await session.observe());
+        }
+        finally {
+            await session.dispose?.();
+        }
+        const mismatches = compareAuthoringObservation(observation, vector.expect);
+        if (stableJson(vector) !== pristine) {
+            mismatches.push('adapter mutated the conformance vector');
+        }
+        lanes.push({
+            mismatches,
+            name: lane.name,
+            observation,
+            passed: mismatches.length === 0,
+            surface: lane.surface,
+        });
+    }
+    return {
+        lanes,
+        passed: lanes.every((lane) => lane.passed),
+        profile: 'studio.profile/authoring-web',
+        vectorId: vector.id,
+    };
+}
+function compareAuthoringObservation(actual, expected) {
+    const mismatches = [];
+    compareExact(mismatches, 'announcements', actual.announcements, expected.announcements);
+    compareExact(mismatches, 'commands', actual.commands, expected.commands);
+    compareExact(mismatches, 'dirty', actual.dirty, expected.dirty);
+    compareExact(mismatches, 'document', actual.document, expected.document);
+    compareExact(mismatches, 'focus', actual.focus, expected.focus);
+    compareExact(mismatches, 'selection', actual.selection, expected.selection);
+    return mismatches;
+}
+function compareExact(mismatches, field, actual, expected) {
+    if (stableJson(actual) !== stableJson(expected)) {
+        mismatches.push(`${field} differs from the vector expectation`);
+    }
+}
+function cloneJson(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function stableJson(value) {
+    return JSON.stringify(sortJson(value)) ?? 'undefined';
+}
+function sortJson(value) {
+    if (Array.isArray(value)) {
+        return value.map((member) => sortJson(member));
+    }
+    if (value !== null && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0))
+            .map(([key, member]) => [key, sortJson(member)]));
+    }
+    return value;
+}
+//# sourceMappingURL=web-conformance.js.map

package/dist/web-conformance.js.map

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