@cratis/components.conformance 0.0.0 → 4.1.0

package/CONFORMANCE.md

@@ -0,0 +1,64 @@
+<!-- Copyright (c) Cratis. All rights reserved. -->
+<!-- Licensed under the MIT license. See LICENSE file in the project root for full license information. -->
+
+# Conformance evidence boundary
+
+`runConformance()` returns evidence for the exact library manifest, package metadata, DOM
+implementation, dependency versions, and execution environment supplied to that call. A passing
+report does **not** claim universal accessibility, browser, visual, assistive-technology, framework,
+or production conformance.
+
+The automated families are:
+
+- package metadata schema constraints, runtime consistency, and capability over-declaration;
+- all fourteen ABI v1 slot declarations, stable parts/states, pt markers, and exact native roots;
+- bounded native form/callback behavior and one interactive semantic root per declared ownership selector;
+- internal React-boundary normalization fixtures (props, styles, refs, events, cleanup, StrictMode);
+- DOM-free deterministic server rendering, slot-local output distinction, hydration, and bounded overlay absence/presence;
+- axe WCAG A/AA scans plus a real slot rendered inside bounded RTL, forced-color-adjust, and reduced-transition DOM hosts;
+- a separate packed-package gate covering every emitted declaration, runtime entry loading, and strict Bundler/NodeNext consumer compilation.
+
+A requested skip is accepted only when the relevant declaration is `unsupported`/`emulated`, or the
+request names a capability the library does not claim. An unjustified skip is a failure. Adapters
+whose upstream provider remains application-owned may supply an outer `wrapper` fixture; the runner
+uses it for the exercised environment but never configures or transports credentials.
+
+## Private plain-DOM falsification fixture
+
+The repository includes a private, test-only plain-DOM renderer under
+`for_plain_dom_renderer/`. It is not a workspace, package, published entry point, or source of
+runtime code. It independently implements the nine stable presentation slots using public ABI and
+component prop contracts only; it does not import the Components-owned Core implementations.
+
+The declared `stable-presentation/v1` profile and its schema-valid static metadata point to the
+actual private source fixture and exported manifest. The generated report must contain zero
+failures and zero skips and remains the authoritative check inventory. The bounded run observes:
+
+- exact semantic native elements and forwarded refs for every ref-capable slot;
+- native submit, form-value, and reset behavior;
+- one `ChangeHandler` callback carrying `source: 'user'` and the originating native `Event`;
+- every documented stable part and canonical state, plus every declared `pt` route; and
+- deterministic SSR/hydration, axe WCAG A/AA, and the runner's bounded environmental hosts.
+
+Within this nine-slot profile, no renderer ABI widening or Core change was required. This finding is
+limited to the public contracts and automated environment exercised here; it does not upgrade the
+general evidence boundary or the limitations below.
+
+## Explicit limitations
+
+- axe is automated DOM analysis and cannot replace manual keyboard, screen-reader, magnification,
+  voice-control, or other assistive-technology review.
+- jsdom does not establish behavior across browser engines, devices, touch/pointer combinations, or
+  operating-system accessibility modes.
+- forced-color-adjust and reduced-transition host fixtures prove that a real slot renders under
+  those bounded DOM inputs, not that a browser activated forced-colors/reduced-motion media modes,
+  visual contrast, or the absence of all motion. Repository Storybook light/dark axe runs remain a
+  separate gate.
+- ownership checks count declared interactive semantic roots. They do not instrument a vendor's
+  internal focus trap, dismissal listener, or scroll lock.
+- slot-local SSR output checks do not establish concurrent-request isolation across processes or
+  application server runtimes.
+- renderer-vendor focus, collection, and overlay behavior outside the fourteen public slots is not
+  exercised.
+- adapter package licensing, security, performance, and upstream support policy remain the adapter
+  author's responsibility.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Cratis
+
+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/README.md

@@ -1,3 +1,121 @@
+<!-- Copyright (c) Cratis. All rights reserved. -->
+<!-- Licensed under the MIT license. See LICENSE file in the project root for full license information. -->
+
 # @cratis/components.conformance
 
-Reserved for the Cratis Components release workflow.
+Development-only verification for authors of `@cratis/components` renderer adapters. Ordinary
+applications do not install this package. Adapter authors use it to prove a renderer manifest
+against the Components behavior, parts, state, SSR, and accessibility contract.
+
+The package shares the Components repository release version while renderer ABI major `1` remains a
+separate protocol version. It is neither an application runtime dependency nor an adapter discovery
+mechanism.
+
+> **Publication status:** The install example targets the owner-authorized 4.0.0 npm release. When
+> reading this README from repository source before that release, verify availability with
+> `npm view @cratis/components.conformance@4.0.0 version`; source contributors use the workspace
+> commands below.
+
+## Requirements
+
+- Node.js 23 or newer.
+- `@cratis/components >=4 <5`.
+- React and ReactDOM 19.
+- A DOM test environment. The runner defaults to `globalThis.document`; plain Node without a
+  supplied `Document` deliberately fails the `runtime.domAvailable` check.
+
+Install it only in an adapter project:
+
+```sh
+npm install --save-dev \
+  @cratis/components.conformance@^4 \
+  @cratis/components@^4 \
+  react@^19 react-dom@^19
+```
+
+## Run it in a DOM test
+
+This Vitest example uses jsdom explicitly and passes its `document` to make the environment
+requirement visible:
+
+```tsx
+// @vitest-environment jsdom
+
+import { expect, it } from 'vitest';
+import {
+    ConformanceStatus,
+    runConformance,
+    type ConformanceReport,
+} from '@cratis/components.conformance';
+import { myLibrary } from '@example/components-adapter';
+import packageJson from '@example/components-adapter/package.json' with { type: 'json' };
+
+it('conforms to its declared renderer profile', async () => {
+    const report: ConformanceReport = await runConformance(myLibrary, {
+        metadata: packageJson.cratis,
+        document,
+        axe: true,
+    });
+
+    const failures = report.checks.filter(
+        (check) => check.status === ConformanceStatus.Failed,
+    );
+
+    expect(
+        failures,
+        failures.map((check) => `${check.id}: ${check.message}`).join('\n'),
+    ).toEqual([]);
+    expect(report.passed).toBe(true);
+});
+```
+
+An adapter that requires an application-owned outer provider passes it through `wrapper`. The
+wrapper receives `children`; it is the correct place for a vendor theme, cache, or licensed provider.
+Credentials and license keys must remain application-owned and must not enter adapter metadata.
+
+## Options
+
+| Option     | Purpose                                                                                                                   |
+| ---------- | ------------------------------------------------------------------------------------------------------------------------- |
+| `metadata` | The adapter package's static `package.json#cratis` metadata. Runtime and static declarations must agree.                  |
+| `document` | DOM document for runtime checks. Defaults to `globalThis.document`.                                                       |
+| `axe`      | Enables axe-core evidence. Defaults to `true`.                                                                            |
+| `wrapper`  | Optional application-owned provider mounted around runtime fixtures.                                                      |
+| `skips`    | Explicit `ConformanceSkipRequest[]`. A skip is accepted only when declared fidelity or a missing capability justifies it. |
+
+Do not use skips to make a failing implementation green. Every skip names a check and, when
+applicable, a slot or missing capability. The returned report records accepted omissions as
+limitations.
+
+## Report and public types
+
+`runConformance()` returns a `ConformanceReport` containing:
+
+- `passed` plus a `ConformanceSummary` of passed, failed, and skipped checks;
+- individual `ConformanceCheck` records with family, status, slot, message, evidence, and skip basis;
+- explicit `ConformanceLimitation` records describing what the report does not establish.
+
+The package also exports:
+
+- `AdapterPackageMetadata` for the public adapter schema shape;
+- `ConformanceLibrary`, the renderer-library structure accepted by the runner;
+- `ConformanceFamily` and `ConformanceStatus` enums;
+- `ConformanceOptions`, `ConformanceSkipRequest`, `ConformanceCheck`, `ConformanceSummary`,
+  `ConformanceLimitation`, and `ConformanceReport` types.
+
+The stable `stable-presentation/v1` profile covers exactly nine primitive slots. The broader
+fourteen-slot inventory remains experimental. Checks cover static/runtime metadata consistency,
+stable parts and canonical states, pass-through routing, native elements and refs, bounded form and
+callback behavior, behavior ownership, SSR/hydration, axe, RTL/forced-color/reduced-motion inputs,
+and skip discipline. See [CONFORMANCE.md](./CONFORMANCE.md) for the precise evidence boundary.
+
+## Repository commands
+
+```sh
+yarn workspace @cratis/components.conformance build
+yarn workspace @cratis/components.conformance test
+yarn workspace @cratis/components.conformance verify-package
+```
+
+`verify-package` packs the real archive, rejects tests/cache files and forbidden declaration types,
+and compiles an external consumer under both Bundler and NodeNext with `skipLibCheck: false`.

package/dist/AdapterPackageMetadata.d.ts

@@ -0,0 +1,28 @@
+/** Static `package.json#cratis` metadata validated against the public adapter schema. */
+export interface AdapterPackageMetadata {
+    readonly kind: 'ui-adapter';
+    readonly id: string;
+    readonly displayName: string;
+    readonly abi: string;
+    readonly level: 'full' | 'primitive' | 'behavior' | 'portal' | 'theme';
+    readonly profile: string;
+    readonly category: string;
+    readonly entry: string;
+    readonly export: string;
+    readonly slots: readonly string[];
+    readonly modes: Readonly<Record<string, 'presentation' | 'atomic'>>;
+    readonly capabilities: readonly string[];
+    readonly ssr: 'safe' | 'client-only' | 'hydration-risk';
+    readonly a11y: {
+        readonly axeProfile: 'wcag21a' | 'wcag21aa' | 'wcag22a' | 'wcag22aa';
+        readonly evidence: string;
+    };
+    readonly license: {
+        readonly spdx: string;
+        readonly requiresKey: boolean;
+        readonly keyEnv?: string;
+        readonly url?: string;
+    };
+    readonly upstream: Readonly<Record<string, string>>;
+}
+//# sourceMappingURL=AdapterPackageMetadata.d.ts.map

package/dist/AdapterPackageMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdapterPackageMetadata.d.ts","sourceRoot":"","sources":["../src/AdapterPackageMetadata.ts"],"names":[],"mappings":"AAGA,yFAAyF;AACzF,MAAM,WAAW,sBAAsB;IACnC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,GAAG,gBAAgB,CAAC;IACxD,QAAQ,CAAC,IAAI,EAAE;QACX,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;QACrE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE;QACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;QAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvD"}

package/dist/AdapterPackageMetadata.js

@@ -0,0 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export {};
+//# sourceMappingURL=AdapterPackageMetadata.js.map

package/dist/AdapterPackageMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdapterPackageMetadata.js","sourceRoot":"","sources":["../src/AdapterPackageMetadata.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/ConformanceCheck.d.ts

@@ -0,0 +1,13 @@
+import type { ConformanceFamily } from './ConformanceFamily.js';
+import type { ConformanceStatus } from './ConformanceStatus.js';
+/** Result of one bounded, reproducible conformance assertion. */
+export interface ConformanceCheck {
+    readonly id: string;
+    readonly family: ConformanceFamily;
+    readonly status: ConformanceStatus;
+    readonly slotId?: string;
+    readonly message: string;
+    readonly evidence?: Readonly<Record<string, unknown>>;
+    readonly skipBasis?: 'unsupported-fidelity' | 'emulated-fidelity' | 'missing-capability';
+}
+//# sourceMappingURL=ConformanceCheck.d.ts.map

package/dist/ConformanceCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformanceCheck.d.ts","sourceRoot":"","sources":["../src/ConformanceCheck.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,sBAAsB,GAAG,mBAAmB,GAAG,oBAAoB,CAAC;CAC5F"}

package/dist/ConformanceCheck.js

@@ -0,0 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export {};
+//# sourceMappingURL=ConformanceCheck.js.map

package/dist/ConformanceCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformanceCheck.js","sourceRoot":"","sources":["../src/ConformanceCheck.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/ConformanceFamily.d.ts

@@ -0,0 +1,12 @@
+/** Evidence families emitted by the renderer conformance runner. */
+export declare enum ConformanceFamily {
+    Manifest = "manifest",
+    Contract = "contract",
+    Behavior = "behavior",
+    BehaviorOwnership = "behaviorOwnership",
+    ReactNormalization = "reactNormalization",
+    ServerRendering = "ssr",
+    Accessibility = "a11y",
+    TypePurity = "typePurity"
+}
+//# sourceMappingURL=ConformanceFamily.d.ts.map

package/dist/ConformanceFamily.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformanceFamily.d.ts","sourceRoot":"","sources":["../src/ConformanceFamily.ts"],"names":[],"mappings":"AAGA,oEAAoE;AACpE,oBAAY,iBAAiB;IACzB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,iBAAiB,sBAAsB;IACvC,kBAAkB,uBAAuB;IACzC,eAAe,QAAQ;IACvB,aAAa,SAAS;IACtB,UAAU,eAAe;CAC5B"}

package/dist/ConformanceFamily.js

@@ -0,0 +1,15 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** Evidence families emitted by the renderer conformance runner. */
+export var ConformanceFamily;
+(function (ConformanceFamily) {
+    ConformanceFamily["Manifest"] = "manifest";
+    ConformanceFamily["Contract"] = "contract";
+    ConformanceFamily["Behavior"] = "behavior";
+    ConformanceFamily["BehaviorOwnership"] = "behaviorOwnership";
+    ConformanceFamily["ReactNormalization"] = "reactNormalization";
+    ConformanceFamily["ServerRendering"] = "ssr";
+    ConformanceFamily["Accessibility"] = "a11y";
+    ConformanceFamily["TypePurity"] = "typePurity";
+})(ConformanceFamily || (ConformanceFamily = {}));
+//# sourceMappingURL=ConformanceFamily.js.map

package/dist/ConformanceFamily.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformanceFamily.js","sourceRoot":"","sources":["../src/ConformanceFamily.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,oEAAoE;AACpE,MAAM,CAAN,IAAY,iBASX;AATD,WAAY,iBAAiB;IACzB,0CAAqB,CAAA;IACrB,0CAAqB,CAAA;IACrB,0CAAqB,CAAA;IACrB,4DAAuC,CAAA;IACvC,8DAAyC,CAAA;IACzC,4CAAuB,CAAA;IACvB,2CAAsB,CAAA;IACtB,8CAAyB,CAAA;AAC7B,CAAC,EATW,iBAAiB,KAAjB,iBAAiB,QAS5B"}

package/dist/ConformanceLibrary.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Public structural view accepted by the conformance runner.
+ *
+ * `unstable_UiLibrary` satisfies this shape without leaking Components component or renderer-vendor
+ * declarations through the conformance package's separately packaged public types.
+ */
+export interface ConformanceLibrary {
+    readonly id: string;
+    readonly displayName: string;
+    readonly abi: number;
+    readonly level: 'full' | 'primitive' | 'behavior' | 'portal' | 'theme';
+    readonly profile: string;
+    readonly profileSlots?: readonly string[];
+    readonly capabilities: readonly string[];
+    readonly slots: object;
+    readonly Provider?: unknown;
+    readonly preflight?: unknown;
+}
+//# sourceMappingURL=ConformanceLibrary.d.ts.map

package/dist/ConformanceLibrary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformanceLibrary.d.ts","sourceRoot":"","sources":["../src/ConformanceLibrary.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAChC"}

package/dist/ConformanceLibrary.js

@@ -0,0 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export {};
+//# sourceMappingURL=ConformanceLibrary.js.map

package/dist/ConformanceLibrary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformanceLibrary.js","sourceRoot":"","sources":["../src/ConformanceLibrary.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/ConformanceLimitation.d.ts

@@ -0,0 +1,6 @@
+/** Explicit boundary on what a programmatic conformance report establishes. */
+export interface ConformanceLimitation {
+    readonly id: string;
+    readonly message: string;
+}
+//# sourceMappingURL=ConformanceLimitation.d.ts.map

package/dist/ConformanceLimitation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformanceLimitation.d.ts","sourceRoot":"","sources":["../src/ConformanceLimitation.ts"],"names":[],"mappings":"AAGA,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B"}

package/dist/ConformanceLimitation.js

@@ -0,0 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export {};
+//# sourceMappingURL=ConformanceLimitation.js.map

package/dist/ConformanceLimitation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformanceLimitation.js","sourceRoot":"","sources":["../src/ConformanceLimitation.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/ConformanceOptions.d.ts

@@ -0,0 +1,19 @@
+import type { ComponentType, ReactNode } from 'react';
+import type { AdapterPackageMetadata } from './AdapterPackageMetadata.js';
+import type { ConformanceSkipRequest } from './ConformanceSkipRequest.js';
+/** Options for a bounded conformance run. */
+export interface ConformanceOptions {
+    /** Static `package.json#cratis` metadata for runtime/static consistency checks. */
+    readonly metadata?: AdapterPackageMetadata | Readonly<Record<string, unknown>>;
+    /** DOM document used for runtime checks. Defaults to `globalThis.document`. */
+    readonly document?: Document;
+    /** Enables axe-core evidence. Defaults to `true`. */
+    readonly axe?: boolean;
+    /** Optional application-owned outer provider required by a vendor renderer. */
+    readonly wrapper?: ComponentType<{
+        readonly children: ReactNode;
+    }>;
+    /** Explicit omissions, accepted only when fidelity/capability declarations justify them. */
+    readonly skips?: readonly ConformanceSkipRequest[];
+}
+//# sourceMappingURL=ConformanceOptions.d.ts.map

package/dist/ConformanceOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformanceOptions.d.ts","sourceRoot":"","sources":["../src/ConformanceOptions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE1E,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IAC/B,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,CAAC,EAAE,sBAAsB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/E,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;QAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IACnE,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACtD"}

package/dist/ConformanceOptions.js

@@ -0,0 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export {};
+//# sourceMappingURL=ConformanceOptions.js.map

package/dist/ConformanceOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformanceOptions.js","sourceRoot":"","sources":["../src/ConformanceOptions.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/ConformanceReport.d.ts

@@ -0,0 +1,13 @@
+import type { ConformanceCheck } from './ConformanceCheck.js';
+import type { ConformanceLimitation } from './ConformanceLimitation.js';
+import type { ConformanceSummary } from './ConformanceSummary.js';
+/** Bounded evidence returned for one renderer library. */
+export interface ConformanceReport {
+    readonly adapterId: string;
+    readonly abi: number;
+    readonly passed: boolean;
+    readonly summary: ConformanceSummary;
+    readonly checks: readonly ConformanceCheck[];
+    readonly limitations: readonly ConformanceLimitation[];
+}
+//# sourceMappingURL=ConformanceReport.d.ts.map

package/dist/ConformanceReport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformanceReport.d.ts","sourceRoot":"","sources":["../src/ConformanceReport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,SAAS,qBAAqB,EAAE,CAAC;CAC1D"}

package/dist/ConformanceReport.js

@@ -0,0 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export {};
+//# sourceMappingURL=ConformanceReport.js.map

package/dist/ConformanceReport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformanceReport.js","sourceRoot":"","sources":["../src/ConformanceReport.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/ConformanceSkipRequest.d.ts

@@ -0,0 +1,7 @@
+/** Explicit request to omit one check when the manifest truthfully declares the reason. */
+export interface ConformanceSkipRequest {
+    readonly checkId: string;
+    readonly slotId?: string;
+    readonly missingCapability?: string;
+}
+//# sourceMappingURL=ConformanceSkipRequest.d.ts.map

package/dist/ConformanceSkipRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformanceSkipRequest.d.ts","sourceRoot":"","sources":["../src/ConformanceSkipRequest.ts"],"names":[],"mappings":"AAGA,2FAA2F;AAC3F,MAAM,WAAW,sBAAsB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACvC"}

package/dist/ConformanceSkipRequest.js

@@ -0,0 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export {};
+//# sourceMappingURL=ConformanceSkipRequest.js.map

package/dist/ConformanceSkipRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformanceSkipRequest.js","sourceRoot":"","sources":["../src/ConformanceSkipRequest.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/ConformanceStatus.d.ts

@@ -0,0 +1,7 @@
+/** Result status for one bounded conformance check. */
+export declare enum ConformanceStatus {
+    Passed = "passed",
+    Failed = "failed",
+    Skipped = "skipped"
+}
+//# sourceMappingURL=ConformanceStatus.d.ts.map

package/dist/ConformanceStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformanceStatus.d.ts","sourceRoot":"","sources":["../src/ConformanceStatus.ts"],"names":[],"mappings":"AAGA,uDAAuD;AACvD,oBAAY,iBAAiB;IACzB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,OAAO,YAAY;CACtB"}

package/dist/ConformanceStatus.js

@@ -0,0 +1,10 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** Result status for one bounded conformance check. */
+export var ConformanceStatus;
+(function (ConformanceStatus) {
+    ConformanceStatus["Passed"] = "passed";
+    ConformanceStatus["Failed"] = "failed";
+    ConformanceStatus["Skipped"] = "skipped";
+})(ConformanceStatus || (ConformanceStatus = {}));
+//# sourceMappingURL=ConformanceStatus.js.map

package/dist/ConformanceStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformanceStatus.js","sourceRoot":"","sources":["../src/ConformanceStatus.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG;AAErG,uDAAuD;AACvD,MAAM,CAAN,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IACzB,sCAAiB,CAAA;IACjB,sCAAiB,CAAA;IACjB,wCAAmB,CAAA;AACvB,CAAC,EAJW,iBAAiB,KAAjB,iBAAiB,QAI5B"}

package/dist/ConformanceSummary.d.ts

@@ -0,0 +1,8 @@
+/** Aggregate counts for one conformance run. */
+export interface ConformanceSummary {
+    readonly total: number;
+    readonly passed: number;
+    readonly failed: number;
+    readonly skipped: number;
+}
+//# sourceMappingURL=ConformanceSummary.d.ts.map

package/dist/ConformanceSummary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformanceSummary.d.ts","sourceRoot":"","sources":["../src/ConformanceSummary.ts"],"names":[],"mappings":"AAGA,gDAAgD;AAChD,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B"}

package/dist/ConformanceSummary.js

@@ -0,0 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export {};
+//# sourceMappingURL=ConformanceSummary.js.map

package/dist/ConformanceSummary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConformanceSummary.js","sourceRoot":"","sources":["../src/ConformanceSummary.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export type { AdapterPackageMetadata } from './AdapterPackageMetadata.js';
+export type { ConformanceCheck } from './ConformanceCheck.js';
+export { ConformanceFamily } from './ConformanceFamily.js';
+export type { ConformanceLibrary } from './ConformanceLibrary.js';
+export type { ConformanceLimitation } from './ConformanceLimitation.js';
+export type { ConformanceOptions } from './ConformanceOptions.js';
+export type { ConformanceReport } from './ConformanceReport.js';
+export type { ConformanceSkipRequest } from './ConformanceSkipRequest.js';
+export { ConformanceStatus } from './ConformanceStatus.js';
+export type { ConformanceSummary } from './ConformanceSummary.js';
+export { runConformance } from './runConformance.js';
+//# 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":"AAGA,YAAY,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,YAAY,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,YAAY,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export { ConformanceFamily } from './ConformanceFamily.js';
+export { ConformanceStatus } from './ConformanceStatus.js';
+export { runConformance } from './runConformance.js';
+//# 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,6CAA6C;AAC7C,qGAAqG;AAIrG,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAM3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/internal/SlotProfile.d.ts

@@ -0,0 +1,20 @@
+import type { RefObject } from 'react';
+import type { unstable_SlotId } from '@cratis/components/renderer';
+import type { CratisPartsManifest } from '@cratis/components/types';
+/** Internal fixture for one public renderer slot. */
+export interface SlotProfile {
+    readonly slotId: unstable_SlotId;
+    readonly partsKey: keyof CratisPartsManifest;
+    readonly createProps: () => Readonly<Record<string, unknown>>;
+    readonly createStateProps?: () => Readonly<Record<string, unknown>>;
+    readonly createPartVariants?: () => readonly Readonly<Record<string, unknown>>[];
+    readonly conditionallyAbsentParts?: readonly string[];
+    readonly ptKeys: readonly string[];
+    readonly nativeSelector: string;
+    readonly nativeTag: string;
+    readonly refCapable: boolean;
+    readonly ownershipSelectors: readonly string[];
+    readonly activate?: (document: Document, container: HTMLElement) => Promise<void>;
+    readonly exercise?: (document: Document, container: HTMLElement, ref: RefObject<Element | null>) => Promise<Readonly<Record<string, unknown>>>;
+}
+//# sourceMappingURL=SlotProfile.d.ts.map

package/dist/internal/SlotProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlotProfile.d.ts","sourceRoot":"","sources":["../../src/internal/SlotProfile.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,qDAAqD;AACrD,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,mBAAmB,CAAC;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC;IACjF,QAAQ,CAAC,wBAAwB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAChB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,WAAW,EACtB,GAAG,EAAE,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,KAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACnD"}

package/dist/internal/SlotProfile.js

@@ -0,0 +1,4 @@
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+export {};
+//# sourceMappingURL=SlotProfile.js.map

package/dist/internal/SlotProfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlotProfile.js","sourceRoot":"","sources":["../../src/internal/SlotProfile.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,qGAAqG"}

package/dist/internal/metadata.d.ts

@@ -0,0 +1,9 @@
+import type { unstable_UiLibrary } from '@cratis/components/renderer';
+import type { AdapterPackageMetadata } from '../AdapterPackageMetadata.js';
+/** Validates package metadata against the actual published adapter schema. */
+export declare const validateMetadata: (value: unknown) => readonly string[];
+/** Compares static package metadata to the immutable runtime manifest. */
+export declare const compareMetadata: (metadata: AdapterPackageMetadata | Readonly<Record<string, unknown>>, library: unstable_UiLibrary) => readonly string[];
+/** Rejects capability claims that this bounded harness cannot support with the declared slots. */
+export declare const overDeclaredCapabilities: (library: unstable_UiLibrary) => readonly string[];
+//# sourceMappingURL=metadata.d.ts.map

package/dist/internal/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/internal/metadata.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAmB,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAoL3E,8EAA8E;AAC9E,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,SAAS,MAAM,EACzB,CAAC;AAEzC,0EAA0E;AAC1E,eAAO,MAAM,eAAe,GACxB,UAAU,sBAAsB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACpE,SAAS,kBAAkB,KAC5B,SAAS,MAAM,EAoCjB,CAAC;AAEF,kGAAkG;AAClG,eAAO,MAAM,wBAAwB,GACjC,SAAS,kBAAkB,KAC5B,SAAS,MAAM,EAmCjB,CAAC"}