@servicetitan/journey 1.0.0

package/README.md

@@ -0,0 +1,7 @@
+# @servicetitan/journey
+
+Critical user journey monitoring for Datadog RUM (`user_journey` custom actions).
+
+- **Docs:** [Journey](https://docs.st.dev/docs/frontend/journey) (source: [`packages/docs/docs/journey.mdx`](../docs/docs/journey.mdx))
+
+Prefer `defineJourney` handles (`.start` / `.step` / `.complete`). Soft ambient attributes HTTP only when exactly one step is in flight — use `step.tag()` after `await` or when steps overlap.

package/dist/__mocks__/test-runtime.d.ts

@@ -0,0 +1,16 @@
+/** Standard journey def used across engine suites. */
+export declare const baseJourneyDef: {
+    readonly name: "journey-under-test";
+    readonly team: "platform";
+    readonly group: "test";
+    readonly service: "journey";
+    readonly timeoutMs: 0;
+};
+/** Last emitted journey payload from a sink mock. */
+export declare function lastJourney(emitMock: jest.Mock): any;
+/**
+ * Wire `emitMock` as the only sink and restore package defaults after each test.
+ * Call once at the top of a `describe` block.
+ */
+export declare function useJourneyTestRuntime(emitMock: jest.Mock): void;
+//# sourceMappingURL=test-runtime.d.ts.map

package/dist/__mocks__/test-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-runtime.d.ts","sourceRoot":"","sources":["../../src/__mocks__/test-runtime.ts"],"names":[],"mappings":"AAGA,sDAAsD;AACtD,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AAEX,qDAAqD;AACrD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,OAE9C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,QAexD"}

package/dist/__tests__/ambient.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ambient.test.d.ts.map

package/dist/__tests__/ambient.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambient.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/ambient.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/axios.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=axios.test.d.ts.map

package/dist/__tests__/axios.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axios.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/axios.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/__tests__/config.test.d.ts.map

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

package/dist/__tests__/context.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.test.d.ts.map

package/dist/__tests__/context.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/context.test.tsx"],"names":[],"mappings":""}

package/dist/__tests__/datadog.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=datadog.test.d.ts.map

package/dist/__tests__/datadog.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datadog.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/datadog.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/define-journey.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=define-journey.test.d.ts.map

package/dist/__tests__/define-journey.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-journey.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/define-journey.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/expose-app-journey.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=expose-app-journey.test.d.ts.map

package/dist/__tests__/expose-app-journey.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expose-app-journey.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/expose-app-journey.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/fetch.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fetch.test.d.ts.map

package/dist/__tests__/fetch.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/fetch.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/jquery.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=jquery.test.d.ts.map

package/dist/__tests__/jquery.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jquery.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/jquery.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=registry.test.d.ts.map

package/dist/__tests__/registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/registry.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/request-key.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=request-key.test.d.ts.map

package/dist/__tests__/request-key.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-key.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/request-key.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/requests.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=requests.test.d.ts.map

package/dist/__tests__/requests.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/requests.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/runtime.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime.test.d.ts.map

package/dist/__tests__/runtime.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/runtime.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/scope.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scope.test.d.ts.map

package/dist/__tests__/scope.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/scope.test.tsx"],"names":[],"mappings":""}

package/dist/__tests__/sinks.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sinks.test.d.ts.map

package/dist/__tests__/sinks.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sinks.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/sinks.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/step.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=step.test.d.ts.map

package/dist/__tests__/step.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/step.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/timeouts.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=timeouts.test.d.ts.map

package/dist/__tests__/timeouts.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeouts.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/timeouts.test.ts"],"names":[],"mappings":""}

package/dist/config.d.ts

@@ -0,0 +1,42 @@
+import { type JourneySink } from './core/registry';
+import { type AppRequestTimeouts, type EndpointPolicy } from './endpoint-policy';
+import { type AxiosLikeInstance } from './integrations/axios';
+import { type InstrumentFetchOptions } from './integrations/fetch';
+import { type JqueryStatic, type WindowWithAppJourney } from './integrations/jquery';
+export { longestEndpointMatch, sortEndpointsByLongestMatch } from './endpoint-policy';
+export type { AppRequestTimeouts, EndpointPolicy };
+/** Optional app-wide / per-bundle configuration. */
+export interface JourneyConfig {
+    /** App-wide request-timeout fallback. Defaults to { defaultMs: 4000, endpoints: [] }. */
+    requestTimeouts?: AppRequestTimeouts;
+    /**
+     * Replace the sink list used when a journey finishes.
+     * Only applied when provided — omit to leave the current list unchanged.
+     * Package default is `[sendToDatadog]`; pass `[]` to disable emission.
+     */
+    sinks?: readonly JourneySink[];
+    /**
+     * Wire this bundle's axios instance (host or MFE). Same as `instrumentAxios(axios)`.
+     * Register any async request interceptors (e.g. auth) before `configureJourney`.
+     */
+    axios?: AxiosLikeInstance;
+    /**
+     * Wire fetch. `true` wraps `globalThis.fetch`; pass options for a scoped target / baseURL.
+     * Same as `instrumentFetch(...)`.
+     */
+    fetch?: true | InstrumentFetchOptions;
+    /** Wire this bundle's jQuery static. Same as `instrumentJquery($)`. */
+    jquery?: JqueryStatic;
+    /**
+     * Publish `window.App.Journey` for Knockout / legacy hosts.
+     * `true` uses the real window; pass a target object in tests.
+     */
+    exposeAppJourney?: boolean | WindowWithAppJourney;
+}
+/**
+ * Apply bundle options: request thresholds, sinks, and/or HTTP / legacy wiring.
+ * Optional — call once at startup. Pass this bundle's own axios / `$` / fetch target.
+ */
+export declare function configureJourney(config: JourneyConfig): void;
+export declare function getRequestTimeouts(): AppRequestTimeouts;
+//# 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":"AACA,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAEH,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAmB,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAmB,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAGH,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACtF,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC;AAEnD,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC1B,yFAAyF;IACzF,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B;;;OAGG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,IAAI,GAAG,sBAAsB,CAAC;IACtC,uEAAuE;IACvE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,OAAO,GAAG,oBAAoB,CAAC;CACrD;AASD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAsB5D;AAED,wBAAgB,kBAAkB,IAAI,kBAAkB,CAEvD"}

package/dist/config.js

@@ -0,0 +1,46 @@
+import { defaultRuntime } from './core/runtime';
+import { setJourneySinks } from './core/registry';
+import { sortEndpointsByLongestMatch } from './endpoint-policy';
+import { instrumentAxios } from './integrations/axios';
+import { instrumentFetch } from './integrations/fetch';
+import { exposeAppJourney, instrumentJquery } from './integrations/jquery';
+import { sendToDatadog } from './sinks/datadog';
+export { longestEndpointMatch, sortEndpointsByLongestMatch } from './endpoint-policy';
+/*
+ * Default emission target. Kept as a module side effect so any import of this file
+ * (see index.ts `import './config'`) installs Datadog. configureJourney only replaces
+ * sinks when `sinks` is passed explicitly.
+ */ setJourneySinks([
+    sendToDatadog
+]);
+/**
+ * Apply bundle options: request thresholds, sinks, and/or HTTP / legacy wiring.
+ * Optional — call once at startup. Pass this bundle's own axios / `$` / fetch target.
+ */ export function configureJourney(config) {
+    if (config.requestTimeouts !== undefined) {
+        defaultRuntime.setRequestTimeouts({
+            ...config.requestTimeouts,
+            endpoints: sortEndpointsByLongestMatch(config.requestTimeouts.endpoints)
+        });
+    }
+    if (config.sinks !== undefined) {
+        setJourneySinks(config.sinks);
+    }
+    if (config.axios !== undefined) {
+        instrumentAxios(config.axios);
+    }
+    if (config.fetch !== undefined) {
+        instrumentFetch(config.fetch === true ? {} : config.fetch);
+    }
+    if (config.jquery !== undefined) {
+        instrumentJquery(config.jquery);
+    }
+    if (config.exposeAppJourney) {
+        exposeAppJourney(config.exposeAppJourney === true ? undefined : config.exposeAppJourney);
+    }
+}
+export function getRequestTimeouts() {
+    return defaultRuntime.getRequestTimeouts();
+}
+
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"sourcesContent":["import { defaultRuntime } from './core/runtime';\nimport { setJourneySinks, type JourneySink } from './core/registry';\nimport {\n    sortEndpointsByLongestMatch,\n    type AppRequestTimeouts,\n    type EndpointPolicy,\n} from './endpoint-policy';\nimport { instrumentAxios, type AxiosLikeInstance } from './integrations/axios';\nimport { instrumentFetch, type InstrumentFetchOptions } from './integrations/fetch';\nimport {\n    exposeAppJourney,\n    instrumentJquery,\n    type JqueryStatic,\n    type WindowWithAppJourney,\n} from './integrations/jquery';\nimport { sendToDatadog } from './sinks/datadog';\n\nexport { longestEndpointMatch, sortEndpointsByLongestMatch } from './endpoint-policy';\nexport type { AppRequestTimeouts, EndpointPolicy };\n\n/** Optional app-wide / per-bundle configuration. */\nexport interface JourneyConfig {\n    /** App-wide request-timeout fallback. Defaults to { defaultMs: 4000, endpoints: [] }. */\n    requestTimeouts?: AppRequestTimeouts;\n    /**\n     * Replace the sink list used when a journey finishes.\n     * Only applied when provided — omit to leave the current list unchanged.\n     * Package default is `[sendToDatadog]`; pass `[]` to disable emission.\n     */\n    sinks?: readonly JourneySink[];\n    /**\n     * Wire this bundle's axios instance (host or MFE). Same as `instrumentAxios(axios)`.\n     * Register any async request interceptors (e.g. auth) before `configureJourney`.\n     */\n    axios?: AxiosLikeInstance;\n    /**\n     * Wire fetch. `true` wraps `globalThis.fetch`; pass options for a scoped target / baseURL.\n     * Same as `instrumentFetch(...)`.\n     */\n    fetch?: true | InstrumentFetchOptions;\n    /** Wire this bundle's jQuery static. Same as `instrumentJquery($)`. */\n    jquery?: JqueryStatic;\n    /**\n     * Publish `window.App.Journey` for Knockout / legacy hosts.\n     * `true` uses the real window; pass a target object in tests.\n     */\n    exposeAppJourney?: boolean | WindowWithAppJourney;\n}\n\n/*\n * Default emission target. Kept as a module side effect so any import of this file\n * (see index.ts `import './config'`) installs Datadog. configureJourney only replaces\n * sinks when `sinks` is passed explicitly.\n */\nsetJourneySinks([sendToDatadog]);\n\n/**\n * Apply bundle options: request thresholds, sinks, and/or HTTP / legacy wiring.\n * Optional — call once at startup. Pass this bundle's own axios / `$` / fetch target.\n */\nexport function configureJourney(config: JourneyConfig): void {\n    if (config.requestTimeouts !== undefined) {\n        defaultRuntime.setRequestTimeouts({\n            ...config.requestTimeouts,\n            endpoints: sortEndpointsByLongestMatch(config.requestTimeouts.endpoints),\n        });\n    }\n    if (config.sinks !== undefined) {\n        setJourneySinks(config.sinks);\n    }\n    if (config.axios !== undefined) {\n        instrumentAxios(config.axios);\n    }\n    if (config.fetch !== undefined) {\n        instrumentFetch(config.fetch === true ? {} : config.fetch);\n    }\n    if (config.jquery !== undefined) {\n        instrumentJquery(config.jquery);\n    }\n    if (config.exposeAppJourney) {\n        exposeAppJourney(config.exposeAppJourney === true ? undefined : config.exposeAppJourney);\n    }\n}\n\nexport function getRequestTimeouts(): AppRequestTimeouts {\n    return defaultRuntime.getRequestTimeouts();\n}\n"],"names":["defaultRuntime","setJourneySinks","sortEndpointsByLongestMatch","instrumentAxios","instrumentFetch","exposeAppJourney","instrumentJquery","sendToDatadog","longestEndpointMatch","configureJourney","config","requestTimeouts","undefined","setRequestTimeouts","endpoints","sinks","axios","fetch","jquery","getRequestTimeouts"],"mappings":"AAAA,SAASA,cAAc,QAAQ,iBAAiB;AAChD,SAASC,eAAe,QAA0B,kBAAkB;AACpE,SACIC,2BAA2B,QAGxB,oBAAoB;AAC3B,SAASC,eAAe,QAAgC,uBAAuB;AAC/E,SAASC,eAAe,QAAqC,uBAAuB;AACpF,SACIC,gBAAgB,EAChBC,gBAAgB,QAGb,wBAAwB;AAC/B,SAASC,aAAa,QAAQ,kBAAkB;AAEhD,SAASC,oBAAoB,EAAEN,2BAA2B,QAAQ,oBAAoB;AAgCtF;;;;CAIC,GACDD,gBAAgB;IAACM;CAAc;AAE/B;;;CAGC,GACD,OAAO,SAASE,iBAAiBC,MAAqB;IAClD,IAAIA,OAAOC,eAAe,KAAKC,WAAW;QACtCZ,eAAea,kBAAkB,CAAC;YAC9B,GAAGH,OAAOC,eAAe;YACzBG,WAAWZ,4BAA4BQ,OAAOC,eAAe,CAACG,SAAS;QAC3E;IACJ;IACA,IAAIJ,OAAOK,KAAK,KAAKH,WAAW;QAC5BX,gBAAgBS,OAAOK,KAAK;IAChC;IACA,IAAIL,OAAOM,KAAK,KAAKJ,WAAW;QAC5BT,gBAAgBO,OAAOM,KAAK;IAChC;IACA,IAAIN,OAAOO,KAAK,KAAKL,WAAW;QAC5BR,gBAAgBM,OAAOO,KAAK,KAAK,OAAO,CAAC,IAAIP,OAAOO,KAAK;IAC7D;IACA,IAAIP,OAAOQ,MAAM,KAAKN,WAAW;QAC7BN,iBAAiBI,OAAOQ,MAAM;IAClC;IACA,IAAIR,OAAOL,gBAAgB,EAAE;QACzBA,iBAAiBK,OAAOL,gBAAgB,KAAK,OAAOO,YAAYF,OAAOL,gBAAgB;IAC3F;AACJ;AAEA,OAAO,SAASc;IACZ,OAAOnB,eAAemB,kBAAkB;AAC5C"}

package/dist/core/index.d.ts

@@ -0,0 +1,6 @@
+/** Core engine barrel — free helpers over the default runtime, plus handles and types. */
+export { activeJourneyStep, addJourneySink, completeJourney, defineJourney, emitJourneyEvent, excludeJourney, failJourney, firstOpenJourney, journeyMountStep, journeyStep, reportBackendRequest, setJourneySinks, setJourneyTags, startJourney, type JourneyHandle, type JourneySink, } from './registry';
+export { createJourneyRuntime, defaultRuntime, resetJourney, type JourneyRuntime, type JourneyRuntimeOptions, } from './runtime';
+export type { JourneyDef, JourneyEvent, JourneyNameLike, JourneyStepEvent, JourneyStepOptions, JourneyStepRef, JourneyStepTarget, StepHandle, TagValue, } from './types';
+export { JourneyStepTag, resolveJourneyStep } from './step-tag';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,OAAO,EACH,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,WAAW,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC7B,MAAM,WAAW,CAAC;AACnB,YAAY,EACR,UAAU,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,QAAQ,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,5 @@
+/** Core engine barrel — free helpers over the default runtime, plus handles and types. */ export { activeJourneyStep, addJourneySink, completeJourney, defineJourney, emitJourneyEvent, excludeJourney, failJourney, firstOpenJourney, journeyMountStep, journeyStep, reportBackendRequest, setJourneySinks, setJourneyTags, startJourney } from './registry';
+export { createJourneyRuntime, defaultRuntime, resetJourney } from './runtime';
+export { JourneyStepTag, resolveJourneyStep } from './step-tag';
+
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/index.ts"],"sourcesContent":["/** Core engine barrel — free helpers over the default runtime, plus handles and types. */\n\nexport {\n    activeJourneyStep,\n    addJourneySink,\n    completeJourney,\n    defineJourney,\n    emitJourneyEvent,\n    excludeJourney,\n    failJourney,\n    firstOpenJourney,\n    journeyMountStep,\n    journeyStep,\n    reportBackendRequest,\n    setJourneySinks,\n    setJourneyTags,\n    startJourney,\n    type JourneyHandle,\n    type JourneySink,\n} from './registry';\nexport {\n    createJourneyRuntime,\n    defaultRuntime,\n    resetJourney,\n    type JourneyRuntime,\n    type JourneyRuntimeOptions,\n} from './runtime';\nexport type {\n    JourneyDef,\n    JourneyEvent,\n    JourneyNameLike,\n    JourneyStepEvent,\n    JourneyStepOptions,\n    JourneyStepRef,\n    JourneyStepTarget,\n    StepHandle,\n    TagValue,\n} from './types';\nexport { JourneyStepTag, resolveJourneyStep } from './step-tag';\n"],"names":["activeJourneyStep","addJourneySink","completeJourney","defineJourney","emitJourneyEvent","excludeJourney","failJourney","firstOpenJourney","journeyMountStep","journeyStep","reportBackendRequest","setJourneySinks","setJourneyTags","startJourney","createJourneyRuntime","defaultRuntime","resetJourney","JourneyStepTag","resolveJourneyStep"],"mappings":"AAAA,wFAAwF,GAExF,SACIA,iBAAiB,EACjBC,cAAc,EACdC,eAAe,EACfC,aAAa,EACbC,gBAAgB,EAChBC,cAAc,EACdC,WAAW,EACXC,gBAAgB,EAChBC,gBAAgB,EAChBC,WAAW,EACXC,oBAAoB,EACpBC,eAAe,EACfC,cAAc,EACdC,YAAY,QAGT,aAAa;AACpB,SACIC,oBAAoB,EACpBC,cAAc,EACdC,YAAY,QAGT,YAAY;AAYnB,SAASC,cAAc,EAAEC,kBAAkB,QAAQ,aAAa"}

package/dist/core/registry.d.ts

@@ -0,0 +1,50 @@
+import type { JourneyDef, JourneyEvent, JourneyHandle, JourneySink, JourneyState, JourneyStepOptions, JourneyStepRef, JourneyStepTarget, StepHandle, TagValue } from './types';
+export type { JourneyHandle, JourneySink };
+/** Look up an open journey by name. */
+export declare function getOpenJourney(name: string): JourneyState | undefined;
+/** First open journey among `names` (order preserved), or null. */
+export declare function firstOpenJourney(names: readonly string[]): string | null;
+/**
+ * Active step for soft-ambient HTTP attribution, or null when 0 or 2+ steps are in flight
+ * app-wide. Untagged traffic is attributed to that lone step even if unrelated — prefer
+ * `step.tag()` when the page has background instrumented requests. Adapters call this when
+ * a request has no explicit stamp.
+ */
+export declare function activeJourneyStep(): JourneyStepRef | null;
+/**
+ * Record a finished backend request against a captured step.
+ * 5xx / network / slow (over threshold) mark Bad; 4xx is not counted. Fail-fast on breach.
+ */
+export declare function reportBackendRequest(step: JourneyStepRef | undefined, status: number | undefined, durationMs: number, requestKey: string): void;
+/**
+ * Run one step of a named journey. Runs untraced (noop handle) when no matching journey is open.
+ * `journey` may be a name, null, or an ordered candidate list.
+ * Prefer `defineJourney(...).step` when you own the journey config.
+ */
+export declare function journeyStep<T>(journey: JourneyStepTarget, stepName: string, fn: (step: StepHandle) => T | Promise<T>, opts?: JourneyStepOptions): Promise<T>;
+/**
+ * journeyStep deferred by one microtask so a parent `<JourneyScope>` opens first
+ * (React runs child mount effects before parent). Use for mount-effect steps only.
+ */
+export declare function journeyMountStep<T>(journey: JourneyStepTarget, stepName: string, fn: (step: StepHandle) => T | Promise<T>, opts?: JourneyStepOptions): Promise<T>;
+/** Replace the sink list (e.g. host bootstrap or tests). Pass `[]` to disable emission. */
+export declare function setJourneySinks(next: readonly JourneySink[]): void;
+/** Append a sink alongside the current ones. */
+export declare function addJourneySink(sink: JourneySink): void;
+/** Emit a terminal journey event to every configured sink. */
+export declare function emitJourneyEvent(payload: JourneyEvent): void;
+/** Merge custom tags onto an open journey. No-op if not open. Prefer `handle.setTags`. */
+export declare function setJourneyTags(name: string | null, tags: Record<string, TagValue>): void;
+/** Begin a journey. Restarts (closes) an already-open journey of the same name. */
+export declare function startJourney(def: JourneyDef): void;
+/** Fail-fast: record reason and emit immediately. Idempotent via `closed`. */
+export declare function failJourneyNow(journey: JourneyState, reason: string): void;
+/** Mark a named journey Bad for a custom reason (fail-fast). Prefer `handle.fail`. */
+export declare function failJourney(name: string, reason: string): void;
+/** Successful end. Outcome stays Bad if a breach already occurred. No-op when name is null. Prefer `handle.complete`. */
+export declare function completeJourney(name: string | null, tags?: Record<string, TagValue>): void;
+/** User left before finishing. Stays Bad if a breach already occurred (breach-anchored). Prefer `handle.exclude`. */
+export declare function excludeJourney(name: string): void;
+/** Turn a journey config into a handle with bound lifecycle methods. Preferred public API. */
+export declare function defineJourney(def: JourneyDef): JourneyHandle;
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/core/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,UAAU,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,QAAQ,EACX,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;AAE3C,uCAAuC;AACvC,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAErE;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,IAAI,CAEzD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAChC,IAAI,EAAE,cAAc,GAAG,SAAS,EAChC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACnB,IAAI,CAEN;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAC/B,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACxC,IAAI,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACpC,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACxC,IAAI,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI,CAElE;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAEtD;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAE5D;AAED,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,IAAI,CAExF;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAElD;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE1E;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9D;AAED,yHAAyH;AACzH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,IAAI,CAE1F;AAED,qHAAqH;AACrH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,aAAa,CAuC5D"}

package/dist/core/registry.js

@@ -0,0 +1,102 @@
+import { defaultRuntime } from './runtime';
+/** Look up an open journey by name. */ export function getOpenJourney(name) {
+    return defaultRuntime.getOpenJourney(name);
+}
+/** First open journey among `names` (order preserved), or null. */ export function firstOpenJourney(names) {
+    return defaultRuntime.firstOpenJourney(names);
+}
+/**
+ * Active step for soft-ambient HTTP attribution, or null when 0 or 2+ steps are in flight
+ * app-wide. Untagged traffic is attributed to that lone step even if unrelated — prefer
+ * `step.tag()` when the page has background instrumented requests. Adapters call this when
+ * a request has no explicit stamp.
+ */ export function activeJourneyStep() {
+    return defaultRuntime.activeJourneyStep();
+}
+/**
+ * Record a finished backend request against a captured step.
+ * 5xx / network / slow (over threshold) mark Bad; 4xx is not counted. Fail-fast on breach.
+ */ export function reportBackendRequest(step, status, durationMs, requestKey) {
+    defaultRuntime.reportBackendRequest(step, status, durationMs, requestKey);
+}
+/**
+ * Run one step of a named journey. Runs untraced (noop handle) when no matching journey is open.
+ * `journey` may be a name, null, or an ordered candidate list.
+ * Prefer `defineJourney(...).step` when you own the journey config.
+ */ export async function journeyStep(journey, stepName, fn, opts) {
+    return defaultRuntime.journeyStep(journey, stepName, fn, opts);
+}
+/**
+ * journeyStep deferred by one microtask so a parent `<JourneyScope>` opens first
+ * (React runs child mount effects before parent). Use for mount-effect steps only.
+ */ export async function journeyMountStep(journey, stepName, fn, opts) {
+    return defaultRuntime.journeyMountStep(journey, stepName, fn, opts);
+}
+/** Replace the sink list (e.g. host bootstrap or tests). Pass `[]` to disable emission. */ export function setJourneySinks(next) {
+    defaultRuntime.setSinks(next);
+}
+/** Append a sink alongside the current ones. */ export function addJourneySink(sink) {
+    defaultRuntime.addSink(sink);
+}
+/** Emit a terminal journey event to every configured sink. */ export function emitJourneyEvent(payload) {
+    defaultRuntime.emit(payload);
+}
+/** Merge custom tags onto an open journey. No-op if not open. Prefer `handle.setTags`. */ export function setJourneyTags(name, tags) {
+    defaultRuntime.setJourneyTags(name, tags);
+}
+/** Begin a journey. Restarts (closes) an already-open journey of the same name. */ export function startJourney(def) {
+    defaultRuntime.startJourney(def);
+}
+/** Fail-fast: record reason and emit immediately. Idempotent via `closed`. */ export function failJourneyNow(journey, reason) {
+    defaultRuntime.failJourneyNow(journey, reason);
+}
+/** Mark a named journey Bad for a custom reason (fail-fast). Prefer `handle.fail`. */ export function failJourney(name, reason) {
+    defaultRuntime.failJourney(name, reason);
+}
+/** Successful end. Outcome stays Bad if a breach already occurred. No-op when name is null. Prefer `handle.complete`. */ export function completeJourney(name, tags) {
+    defaultRuntime.completeJourney(name, tags);
+}
+/** User left before finishing. Stays Bad if a breach already occurred (breach-anchored). Prefer `handle.exclude`. */ export function excludeJourney(name) {
+    defaultRuntime.excludeJourney(name);
+}
+/** Turn a journey config into a handle with bound lifecycle methods. Preferred public API. */ export function defineJourney(def) {
+    const ensureStarted = ()=>{
+        if (!getOpenJourney(def.name)) {
+            startJourney(def);
+        }
+    };
+    const handle = {
+        ...def,
+        start (tags) {
+            startJourney(def);
+            if (tags) {
+                setJourneyTags(def.name, tags);
+            }
+        },
+        step (stepName, fn, opts) {
+            ensureStarted();
+            return journeyStep(def.name, stepName, fn, opts);
+        },
+        async mountStep (stepName, fn, opts) {
+            // Defer so a parent <JourneyScope> opens first (child effects run before parent).
+            await Promise.resolve();
+            ensureStarted();
+            return journeyStep(def.name, stepName, fn, opts);
+        },
+        complete (tags) {
+            completeJourney(def.name, tags);
+        },
+        fail (reason) {
+            failJourney(def.name, reason);
+        },
+        exclude () {
+            excludeJourney(def.name);
+        },
+        setTags (tags) {
+            setJourneyTags(def.name, tags);
+        }
+    };
+    return handle;
+}
+
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/registry.ts"],"sourcesContent":["import { defaultRuntime } from './runtime';\nimport type {\n    JourneyDef,\n    JourneyEvent,\n    JourneyHandle,\n    JourneySink,\n    JourneyState,\n    JourneyStepOptions,\n    JourneyStepRef,\n    JourneyStepTarget,\n    StepHandle,\n    TagValue,\n} from './types';\n\nexport type { JourneyHandle, JourneySink };\n\n/** Look up an open journey by name. */\nexport function getOpenJourney(name: string): JourneyState | undefined {\n    return defaultRuntime.getOpenJourney(name);\n}\n\n/** First open journey among `names` (order preserved), or null. */\nexport function firstOpenJourney(names: readonly string[]): string | null {\n    return defaultRuntime.firstOpenJourney(names);\n}\n\n/**\n * Active step for soft-ambient HTTP attribution, or null when 0 or 2+ steps are in flight\n * app-wide. Untagged traffic is attributed to that lone step even if unrelated — prefer\n * `step.tag()` when the page has background instrumented requests. Adapters call this when\n * a request has no explicit stamp.\n */\nexport function activeJourneyStep(): JourneyStepRef | null {\n    return defaultRuntime.activeJourneyStep();\n}\n\n/**\n * Record a finished backend request against a captured step.\n * 5xx / network / slow (over threshold) mark Bad; 4xx is not counted. Fail-fast on breach.\n */\nexport function reportBackendRequest(\n    step: JourneyStepRef | undefined,\n    status: number | undefined,\n    durationMs: number,\n    requestKey: string\n): void {\n    defaultRuntime.reportBackendRequest(step, status, durationMs, requestKey);\n}\n\n/**\n * Run one step of a named journey. Runs untraced (noop handle) when no matching journey is open.\n * `journey` may be a name, null, or an ordered candidate list.\n * Prefer `defineJourney(...).step` when you own the journey config.\n */\nexport async function journeyStep<T>(\n    journey: JourneyStepTarget,\n    stepName: string,\n    fn: (step: StepHandle) => T | Promise<T>,\n    opts?: JourneyStepOptions\n): Promise<T> {\n    return defaultRuntime.journeyStep(journey, stepName, fn, opts);\n}\n\n/**\n * journeyStep deferred by one microtask so a parent `<JourneyScope>` opens first\n * (React runs child mount effects before parent). Use for mount-effect steps only.\n */\nexport async function journeyMountStep<T>(\n    journey: JourneyStepTarget,\n    stepName: string,\n    fn: (step: StepHandle) => T | Promise<T>,\n    opts?: JourneyStepOptions\n): Promise<T> {\n    return defaultRuntime.journeyMountStep(journey, stepName, fn, opts);\n}\n\n/** Replace the sink list (e.g. host bootstrap or tests). Pass `[]` to disable emission. */\nexport function setJourneySinks(next: readonly JourneySink[]): void {\n    defaultRuntime.setSinks(next);\n}\n\n/** Append a sink alongside the current ones. */\nexport function addJourneySink(sink: JourneySink): void {\n    defaultRuntime.addSink(sink);\n}\n\n/** Emit a terminal journey event to every configured sink. */\nexport function emitJourneyEvent(payload: JourneyEvent): void {\n    defaultRuntime.emit(payload);\n}\n\n/** Merge custom tags onto an open journey. No-op if not open. Prefer `handle.setTags`. */\nexport function setJourneyTags(name: string | null, tags: Record<string, TagValue>): void {\n    defaultRuntime.setJourneyTags(name, tags);\n}\n\n/** Begin a journey. Restarts (closes) an already-open journey of the same name. */\nexport function startJourney(def: JourneyDef): void {\n    defaultRuntime.startJourney(def);\n}\n\n/** Fail-fast: record reason and emit immediately. Idempotent via `closed`. */\nexport function failJourneyNow(journey: JourneyState, reason: string): void {\n    defaultRuntime.failJourneyNow(journey, reason);\n}\n\n/** Mark a named journey Bad for a custom reason (fail-fast). Prefer `handle.fail`. */\nexport function failJourney(name: string, reason: string): void {\n    defaultRuntime.failJourney(name, reason);\n}\n\n/** Successful end. Outcome stays Bad if a breach already occurred. No-op when name is null. Prefer `handle.complete`. */\nexport function completeJourney(name: string | null, tags?: Record<string, TagValue>): void {\n    defaultRuntime.completeJourney(name, tags);\n}\n\n/** User left before finishing. Stays Bad if a breach already occurred (breach-anchored). Prefer `handle.exclude`. */\nexport function excludeJourney(name: string): void {\n    defaultRuntime.excludeJourney(name);\n}\n\n/** Turn a journey config into a handle with bound lifecycle methods. Preferred public API. */\nexport function defineJourney(def: JourneyDef): JourneyHandle {\n    const ensureStarted = () => {\n        if (!getOpenJourney(def.name)) {\n            startJourney(def);\n        }\n    };\n\n    const handle: JourneyHandle = {\n        ...def,\n        start(tags) {\n            startJourney(def);\n            if (tags) {\n                setJourneyTags(def.name, tags);\n            }\n        },\n        step(stepName, fn, opts) {\n            ensureStarted();\n            return journeyStep(def.name, stepName, fn, opts);\n        },\n        async mountStep(stepName, fn, opts) {\n            // Defer so a parent <JourneyScope> opens first (child effects run before parent).\n            await Promise.resolve();\n            ensureStarted();\n            return journeyStep(def.name, stepName, fn, opts);\n        },\n        complete(tags) {\n            completeJourney(def.name, tags);\n        },\n        fail(reason) {\n            failJourney(def.name, reason);\n        },\n        exclude() {\n            excludeJourney(def.name);\n        },\n        setTags(tags) {\n            setJourneyTags(def.name, tags);\n        },\n    };\n    return handle;\n}\n"],"names":["defaultRuntime","getOpenJourney","name","firstOpenJourney","names","activeJourneyStep","reportBackendRequest","step","status","durationMs","requestKey","journeyStep","journey","stepName","fn","opts","journeyMountStep","setJourneySinks","next","setSinks","addJourneySink","sink","addSink","emitJourneyEvent","payload","emit","setJourneyTags","tags","startJourney","def","failJourneyNow","reason","failJourney","completeJourney","excludeJourney","defineJourney","ensureStarted","handle","start","mountStep","Promise","resolve","complete","fail","exclude","setTags"],"mappings":"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"}

package/dist/core/runtime.d.ts

@@ -0,0 +1,51 @@
+import { type AppRequestTimeouts } from '../endpoint-policy';
+import type { JourneyDef, JourneyEvent, JourneySink, JourneyState, JourneyStepOptions, JourneyStepRef, JourneyStepTarget, StepHandle, TagValue } from './types';
+/** @internal Private — not part of the public package API. */
+export interface JourneyRuntimeOptions {
+    /** Initial sinks. Defaults to `[]` — package bootstrap installs Datadog on the default runtime. */
+    sinks?: readonly JourneySink[];
+    requestTimeouts?: AppRequestTimeouts;
+}
+/**
+ * @internal Private — not part of the public package API.
+ * Isolated journey engine (open journeys, ambient steps, sinks, request thresholds).
+ * App code should keep using free helpers (`defineJourney`, `journeyStep`, …) — they
+ * bind to the process default runtime. Prefer `resetJourney()` in tests.
+ */
+export interface JourneyRuntime {
+    getRequestTimeouts(): AppRequestTimeouts;
+    setRequestTimeouts(next: AppRequestTimeouts): void;
+    setSinks(next: readonly JourneySink[]): void;
+    addSink(sink: JourneySink): void;
+    emit(payload: JourneyEvent): void;
+    getOpenJourney(name: string): JourneyState | undefined;
+    firstOpenJourney(names: readonly string[]): string | null;
+    setJourneyTags(name: string | null, tags: Record<string, TagValue>): void;
+    startJourney(def: JourneyDef): void;
+    failJourneyNow(journey: JourneyState, reason: string): void;
+    failJourney(name: string, reason: string): void;
+    completeJourney(name: string | null, tags?: Record<string, TagValue>): void;
+    excludeJourney(name: string): void;
+    activeJourneyStep(): JourneyStepRef | null;
+    journeyStep<T>(journey: JourneyStepTarget, stepName: string, fn: (step: StepHandle) => T | Promise<T>, opts?: JourneyStepOptions): Promise<T>;
+    journeyMountStep<T>(journey: JourneyStepTarget, stepName: string, fn: (step: StepHandle) => T | Promise<T>, opts?: JourneyStepOptions): Promise<T>;
+    reportBackendRequest(step: JourneyStepRef | undefined, status: number | undefined, durationMs: number, requestKey: string): void;
+    /** Close open journeys, clear ambient steps, restore default timeouts/sinks. */
+    reset(options?: JourneyRuntimeOptions): void;
+}
+/**
+ * @internal Private — not part of the public package API.
+ * Build an isolated engine. Rarely needed — apps use the default via free helpers.
+ */
+export declare function createJourneyRuntime(options?: JourneyRuntimeOptions): JourneyRuntime;
+/**
+ * @internal Private — not part of the public package API.
+ * Process-wide engine used by free helpers. App code does not need to touch this.
+ */
+export declare const defaultRuntime: JourneyRuntime;
+/**
+ * Reset the default engine (open journeys, ambient steps, sinks, request thresholds).
+ * Intended for tests — call in `beforeEach` / `afterEach` instead of manual cleanup.
+ */
+export declare function resetJourney(options?: JourneyRuntimeOptions): void;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/core/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/core/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAGH,KAAK,kBAAkB,EAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EACR,UAAU,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EAEZ,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EAEjB,UAAU,EAEV,QAAQ,EACX,MAAM,SAAS,CAAC;AAiBjB,8DAA8D;AAC9D,MAAM,WAAW,qBAAqB;IAClC,mGAAmG;IACnG,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,eAAe,CAAC,EAAE,kBAAkB,CAAC;CACxC;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC3B,kBAAkB,IAAI,kBAAkB,CAAC;IACzC,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAEnD,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI,CAAC;IAC7C,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAElC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IACvD,gBAAgB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1D,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,IAAI,CAAC;IAC1E,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC;IACpC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5D,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChD,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,IAAI,CAAC;IAC5E,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnC,iBAAiB,IAAI,cAAc,GAAG,IAAI,CAAC;IAC3C,WAAW,CAAC,CAAC,EACT,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACxC,IAAI,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC,CAAC;IACd,gBAAgB,CAAC,CAAC,EACd,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EACxC,IAAI,CAAC,EAAE,kBAAkB,GAC1B,OAAO,CAAC,CAAC,CAAC,CAAC;IAEd,oBAAoB,CAChB,IAAI,EAAE,cAAc,GAAG,SAAS,EAChC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACnB,IAAI,CAAC;IAER,gFAAgF;IAChF,KAAK,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAChD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CA2XxF;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,cAAuC,CAAC;AAErE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAElE"}