@qontinui/shared-types 0.2.1 → 0.2.3

package/dist/tauri-events.js

@@ -0,0 +1 @@
+//# sourceMappingURL=tauri-events.js.map

package/dist/tauri-events.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/ui-bridge-ir.d.cts

@@ -294,6 +294,58 @@ interface IRTransition {
  * way. The adapter rejects documents whose version it does not understand.
  */
 type IRVersion = "1.0";
+/**
+ * Axes that the spec <-> IR pairing gate compares. A document's
+ * `pairingPolicy.acceptDrift.axes` lists which of these are
+ * intentionally allowed to diverge between the legacy spec and the
+ * IR's forward projection.
+ */
+type IRPairingAxis = "groupCount" | "groupIds" | "assertionCount";
+/**
+ * Per-document opt-out for specific spec<->IR pairing axes.
+ *
+ * The canonical use case is a hand-authored IR that uses a different
+ * grouping convention than the legacy spec. Without an explicit policy
+ * the pairing gate flags it as a mismatch on every PR, which trains
+ * reviewers to ignore the gate. The policy makes the divergence
+ * explicit and audit-friendly:
+ *
+ *   - `axes`     — which fingerprint comparisons to skip
+ *   - `reason`   — human-readable justification (required, surfaced in
+ *                  `check-spec-pairing` summary output)
+ *   - `since`    — ISO date (YYYY-MM-DD) the exemption was added
+ *   - `expiresAt` — optional ISO date (YYYY-MM-DD) after which the
+ *                   exemption stops applying. Forces periodic
+ *                   re-justification: the pairing gate downgrades
+ *                   expired exemptions back to ordinary mismatches.
+ *
+ * Mismatches NOT covered by the listed `axes` still fail the gate as
+ * usual — you can accept drift on `groupCount` while still requiring
+ * the assertion total to match.
+ */
+interface IRAcceptDriftPolicy {
+    /** Fingerprint axes whose mismatches are tolerated. */
+    axes: IRPairingAxis[];
+    /** Human-readable justification for the exemption. */
+    reason: string;
+    /** ISO date (YYYY-MM-DD) the exemption was added. */
+    since: string;
+    /**
+     * Optional ISO date (YYYY-MM-DD) after which the exemption stops
+     * applying. The pairing gate then surfaces the document as an
+     * ordinary mismatch.
+     */
+    expiresAt?: string;
+}
+/**
+ * Per-document pairing policy block. Currently only carries
+ * `acceptDrift`; future policies (e.g. assertion-shape exemptions)
+ * can extend this without breaking the IR schema.
+ */
+interface IRPairingPolicy {
+    /** Opt-out from specific spec<->IR pairing mismatch axes. */
+    acceptDrift?: IRAcceptDriftPolicy;
+}
 /**
  * Top-level IR document.
  */
@@ -310,6 +362,12 @@ interface IRDocument {
     metadata?: IRMetadata;
     /** Where this document came from. */
     provenance?: IRProvenance;
+    /**
+     * Per-document policy block — opt-out from specific spec<->IR
+     * pairing mismatches. Used by hand-authored IRs that intentionally
+     * diverge from the legacy spec shape.
+     */
+    pairingPolicy?: IRPairingPolicy;
     /** State declarations within this document. */
     states: IRState[];
     /** Transition declarations within this document. */
@@ -817,4 +875,4 @@ interface ProjectLegacyToIROptions {
  */
 declare function projectLegacyToIR(legacy: LegacySpec, opts?: ProjectLegacyToIROptions): IRDocument;
 
-export { type AdaptedState, type AdaptedTransition, type AdaptedTransitionAction, type AdaptedWaitAfter, type AdaptedWorkflowConfig, type IRCrossRef, type IRDocument, type IREffect, type IRElementCriteria, type IRMetadata, type IRProvenance, type IRState, type IRStateCondition, type IRTransition, type IRTransitionAction, type IRVersion, type IRVisualRef, type IRWaitSpec, type LegacyAssertion, type LegacyAssertionTarget, type LegacyCriteria, type LegacyGroup, type LegacyMetadata, type LegacyProcessStep, type LegacySpec, type LegacyStateMachine, type LegacyStateMachineState, type LegacyTransition, type ProjectLegacyToIROptions, adaptIRDocumentToWorkflowConfig, adaptIRState, adaptIRTransition, adaptIRTransitionAction, projectIRToBundledPage, projectLegacyToIR, projectionVersion };
+export { type AdaptedState, type AdaptedTransition, type AdaptedTransitionAction, type AdaptedWaitAfter, type AdaptedWorkflowConfig, type IRAcceptDriftPolicy, type IRCrossRef, type IRDocument, type IREffect, type IRElementCriteria, type IRMetadata, type IRPairingAxis, type IRPairingPolicy, type IRProvenance, type IRState, type IRStateCondition, type IRTransition, type IRTransitionAction, type IRVersion, type IRVisualRef, type IRWaitSpec, type LegacyAssertion, type LegacyAssertionTarget, type LegacyCriteria, type LegacyGroup, type LegacyMetadata, type LegacyProcessStep, type LegacySpec, type LegacyStateMachine, type LegacyStateMachineState, type LegacyTransition, type ProjectLegacyToIROptions, adaptIRDocumentToWorkflowConfig, adaptIRState, adaptIRTransition, adaptIRTransitionAction, projectIRToBundledPage, projectLegacyToIR, projectionVersion };

package/dist/ui-bridge-ir.d.ts

@@ -294,6 +294,58 @@ interface IRTransition {
  * way. The adapter rejects documents whose version it does not understand.
  */
 type IRVersion = "1.0";
+/**
+ * Axes that the spec <-> IR pairing gate compares. A document's
+ * `pairingPolicy.acceptDrift.axes` lists which of these are
+ * intentionally allowed to diverge between the legacy spec and the
+ * IR's forward projection.
+ */
+type IRPairingAxis = "groupCount" | "groupIds" | "assertionCount";
+/**
+ * Per-document opt-out for specific spec<->IR pairing axes.
+ *
+ * The canonical use case is a hand-authored IR that uses a different
+ * grouping convention than the legacy spec. Without an explicit policy
+ * the pairing gate flags it as a mismatch on every PR, which trains
+ * reviewers to ignore the gate. The policy makes the divergence
+ * explicit and audit-friendly:
+ *
+ *   - `axes`     — which fingerprint comparisons to skip
+ *   - `reason`   — human-readable justification (required, surfaced in
+ *                  `check-spec-pairing` summary output)
+ *   - `since`    — ISO date (YYYY-MM-DD) the exemption was added
+ *   - `expiresAt` — optional ISO date (YYYY-MM-DD) after which the
+ *                   exemption stops applying. Forces periodic
+ *                   re-justification: the pairing gate downgrades
+ *                   expired exemptions back to ordinary mismatches.
+ *
+ * Mismatches NOT covered by the listed `axes` still fail the gate as
+ * usual — you can accept drift on `groupCount` while still requiring
+ * the assertion total to match.
+ */
+interface IRAcceptDriftPolicy {
+    /** Fingerprint axes whose mismatches are tolerated. */
+    axes: IRPairingAxis[];
+    /** Human-readable justification for the exemption. */
+    reason: string;
+    /** ISO date (YYYY-MM-DD) the exemption was added. */
+    since: string;
+    /**
+     * Optional ISO date (YYYY-MM-DD) after which the exemption stops
+     * applying. The pairing gate then surfaces the document as an
+     * ordinary mismatch.
+     */
+    expiresAt?: string;
+}
+/**
+ * Per-document pairing policy block. Currently only carries
+ * `acceptDrift`; future policies (e.g. assertion-shape exemptions)
+ * can extend this without breaking the IR schema.
+ */
+interface IRPairingPolicy {
+    /** Opt-out from specific spec<->IR pairing mismatch axes. */
+    acceptDrift?: IRAcceptDriftPolicy;
+}
 /**
  * Top-level IR document.
  */
@@ -310,6 +362,12 @@ interface IRDocument {
     metadata?: IRMetadata;
     /** Where this document came from. */
     provenance?: IRProvenance;
+    /**
+     * Per-document policy block — opt-out from specific spec<->IR
+     * pairing mismatches. Used by hand-authored IRs that intentionally
+     * diverge from the legacy spec shape.
+     */
+    pairingPolicy?: IRPairingPolicy;
     /** State declarations within this document. */
     states: IRState[];
     /** Transition declarations within this document. */
@@ -817,4 +875,4 @@ interface ProjectLegacyToIROptions {
  */
 declare function projectLegacyToIR(legacy: LegacySpec, opts?: ProjectLegacyToIROptions): IRDocument;
 
-export { type AdaptedState, type AdaptedTransition, type AdaptedTransitionAction, type AdaptedWaitAfter, type AdaptedWorkflowConfig, type IRCrossRef, type IRDocument, type IREffect, type IRElementCriteria, type IRMetadata, type IRProvenance, type IRState, type IRStateCondition, type IRTransition, type IRTransitionAction, type IRVersion, type IRVisualRef, type IRWaitSpec, type LegacyAssertion, type LegacyAssertionTarget, type LegacyCriteria, type LegacyGroup, type LegacyMetadata, type LegacyProcessStep, type LegacySpec, type LegacyStateMachine, type LegacyStateMachineState, type LegacyTransition, type ProjectLegacyToIROptions, adaptIRDocumentToWorkflowConfig, adaptIRState, adaptIRTransition, adaptIRTransitionAction, projectIRToBundledPage, projectLegacyToIR, projectionVersion };
+export { type AdaptedState, type AdaptedTransition, type AdaptedTransitionAction, type AdaptedWaitAfter, type AdaptedWorkflowConfig, type IRAcceptDriftPolicy, type IRCrossRef, type IRDocument, type IREffect, type IRElementCriteria, type IRMetadata, type IRPairingAxis, type IRPairingPolicy, type IRProvenance, type IRState, type IRStateCondition, type IRTransition, type IRTransitionAction, type IRVersion, type IRVisualRef, type IRWaitSpec, type LegacyAssertion, type LegacyAssertionTarget, type LegacyCriteria, type LegacyGroup, type LegacyMetadata, type LegacyProcessStep, type LegacySpec, type LegacyStateMachine, type LegacyStateMachineState, type LegacyTransition, type ProjectLegacyToIROptions, adaptIRDocumentToWorkflowConfig, adaptIRState, adaptIRTransition, adaptIRTransitionAction, projectIRToBundledPage, projectLegacyToIR, projectionVersion };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qontinui/shared-types",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Shared TypeScript types for the Qontinui ecosystem",
   "type": "module",
   "main": "./dist/index.js",
@@ -92,7 +92,12 @@
       "import": "./dist/ui-bridge-ir.js",
       "require": "./dist/ui-bridge-ir.cjs"
     },
-    "./ui-bridge-ir/schema": "./src/ui-bridge-ir/ir.schema.json"
+    "./ui-bridge-ir/schema": "./src/ui-bridge-ir/ir.schema.json",
+    "./tauri-events": {
+      "types": "./dist/tauri-events.d.ts",
+      "import": "./dist/tauri-events.js",
+      "require": "./dist/tauri-events.cjs"
+    }
   },
   "files": [
     "dist",