@rydr/game-sdk 8.22.0 → 9.0.0

package/dist/protocol/version.js

@@ -254,8 +254,52 @@
 // Additive both ways: an older GAME sees a string it does not recognise and does whatever it does
 // for unknown reasons, and an older SHELL never sends it. Unknown close reasons still report as
 // `"dropped"`, which is the honest default for a close nobody labelled.
-export const RYDR_PROTOCOL_VERSION = 34;
+// Bumped 34 → 35: the FTP DIFFICULTY is gone, everywhere (BREAKING).
+//
+// The shell used to carry a rider-chosen difficulty — a level 1→50 stored as watts, nudgeable
+// mid-ride with − / + — and this protocol carried three pieces of it. All three are removed:
+//
+//   1. `rydr/rider.adjustFtp` (game→platform) and the host's `onAdjustFtp`. It relayed the − / +
+//      keys a focused game iframe swallowed before the shell could see them. There is no dial left
+//      to step, so there is nothing to relay. The SDK's own keyboard handler no longer posts it.
+//   2. `BoardEntry.ftpDifficulty` and `BoardEntry.difficultyChanged` — what a run was played at, and
+//      whether the dial moved during it. The platform no longer records either, so on every new
+//      entry they were about to be permanently `undefined`.
+//   3. `AdminSeedEntry.ftpDifficulty` — the same value on an admin-authored seed row.
+//
+// The `@rydr/game-sdk/difficulty` subpath (the 1→50 ladder: `wattsForLevel`, `levelForWatts`,
+// `stepWatts`, `snapWatts`, `visualForLevel`, `FTP_MIN`/`FTP_MAX`/`LEVEL_MIN`/`LEVEL_MAX`) is
+// deleted with them. There is no replacement: watts are no longer a level.
+//
+// `ScopedIdentity.ftp` is UNCHANGED and still sent. What changed is only what it means — it is now
+// the rider's actual FTP, typed into their profile, rather than a difficulty they dialled. A game
+// scaling `%FTP` off it needs no code change.
+// Bumped 35 → 36: adds SEQUENCE STAGES — `rydr/stage.play` (platform→game) and `rydr/stage.report`
+// (game→platform), with the shapes in `./stages.ts` (`StageSpec`, `StageOutcome`, `StageReport`),
+// client `session.onStage`/`session.finishStage`/`session.stage`, and host `sendStage`/`onStageReport`.
+//
+// It makes an authored MASH UP possible: the platform runs several games back to back, handing each
+// one a mode and its settings and being told when that thing ended. Two messages is the whole
+// contract, because everything else already existed — the deep link gets the game to the right
+// screen, `run.start` opens the attempt and its effort window, `run.save` carries the score. What
+// was missing was only "this attempt is over, and how it went", which cannot be inferred: a game
+// saves a lap, visits a menu or finishes an unscored tutorial without any of it meaning "advance".
+//
+// A game opts in by registering an `onStage` handler, which is also how it DECLARES it speaks
+// sequences — the SDK acks the shell on the game's behalf and auto-reports `"unavailable"` for a
+// game with no handler, so an ordinary game needs no sequence code and can never strand a mash up
+// on a stage it was never going to play. The guest→host message carries both the up-front ack and
+// the terminal outcome (`phase`) because the two answer questions on totally different clocks:
+// "will you play this?" in seconds, "did the rider finish?" possibly in minutes.
+//
+// Additive both ways. An older SHELL never sends `stage.play`, so `session.stage` stays `null` and
+// an `onStage` handler simply never fires — the game plays as it always did. An older GAME never
+// answers `stage.play`, which is exactly why a host MUST arm its own accept timeout: there is no
+// "I am an old build" reply, and absence of an ack is the only signal. Nothing existing changed
+// shape, and the `attemptId` round-trip exists so a report arriving after the rider skipped a stage
+// is dropped rather than advancing the sequence twice.
+export const RYDR_PROTOCOL_VERSION = 36;
 /** Semver of this SDK build. Sent in the handshake for telemetry/debugging.
  *  (Bumped to 2.0.0 by `npm version major` on release — see CHANGELOG [Unreleased].) */
-export const RYDR_SDK_VERSION = "8.22.0";
+export const RYDR_SDK_VERSION = "9.0.0";
 //# sourceMappingURL=version.js.map

package/dist/protocol/version.js.map

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

package/dist/three/character/kit.d.ts

@@ -3,7 +3,7 @@
  *
  * The platform built a procedural humanoid rider — skeleton, proportions, and five art directions —
  * with no assets and no build step. The rider rig needs exactly that, so it is published here rather
- * than re-invented: the same argument as `@rydr/game-sdk/difficulty`, where a hand-ported copy of the
+ * than re-invented: the same argument as every other shared contract here, where a hand-ported copy of the
  * shell's ladder drifted until one rider's badge disagreed with the chrome.
  *
  * What came across: the SKELETON and the LOOK. What stayed behind: the walk cycle, the weapon mounts,

package/dist/three/character/kit.js

@@ -3,7 +3,7 @@
  *
  * The platform built a procedural humanoid rider — skeleton, proportions, and five art directions —
  * with no assets and no build step. The rider rig needs exactly that, so it is published here rather
- * than re-invented: the same argument as `@rydr/game-sdk/difficulty`, where a hand-ported copy of the
+ * than re-invented: the same argument as every other shared contract here, where a hand-ported copy of the
  * shell's ladder drifted until one rider's badge disagreed with the chrome.
  *
  * What came across: the SKELETON and the LOOK. What stayed behind: the walk cycle, the weapon mounts,

package/dist/three/character/riders.d.ts

@@ -3,7 +3,7 @@
  *
  * The platform built a procedural humanoid rider — skeleton, proportions, and five art directions —
  * with no assets and no build step. The rider rig needs exactly that, so it is published here rather
- * than re-invented: the same argument as `@rydr/game-sdk/difficulty`, where a hand-ported copy of the
+ * than re-invented: the same argument as every other shared contract here, where a hand-ported copy of the
  * shell's ladder drifted until one rider's badge disagreed with the chrome.
  *
  * What came across: the SKELETON and the LOOK. What stayed behind: the walk cycle, the weapon mounts,

package/dist/three/character/riders.js

@@ -3,7 +3,7 @@
  *
  * The platform built a procedural humanoid rider — skeleton, proportions, and five art directions —
  * with no assets and no build step. The rider rig needs exactly that, so it is published here rather
- * than re-invented: the same argument as `@rydr/game-sdk/difficulty`, where a hand-ported copy of the
+ * than re-invented: the same argument as every other shared contract here, where a hand-ported copy of the
  * shell's ladder drifted until one rider's badge disagreed with the chrome.
  *
  * What came across: the SKELETON and the LOOK. What stayed behind: the walk cycle, the weapon mounts,

package/dist/three/character/skeleton.d.ts

@@ -3,7 +3,7 @@
  *
  * The platform built a procedural humanoid rider — skeleton, proportions, and five art directions —
  * with no assets and no build step. The rider rig needs exactly that, so it is published here rather
- * than re-invented: the same argument as `@rydr/game-sdk/difficulty`, where a hand-ported copy of the
+ * than re-invented: the same argument as every other shared contract here, where a hand-ported copy of the
  * shell's ladder drifted until one rider's badge disagreed with the chrome.
  *
  * What came across: the SKELETON and the LOOK. What stayed behind: the walk cycle, the weapon mounts,

package/dist/three/character/skeleton.js

@@ -3,7 +3,7 @@
  *
  * The platform built a procedural humanoid rider — skeleton, proportions, and five art directions —
  * with no assets and no build step. The rider rig needs exactly that, so it is published here rather
- * than re-invented: the same argument as `@rydr/game-sdk/difficulty`, where a hand-ported copy of the
+ * than re-invented: the same argument as every other shared contract here, where a hand-ported copy of the
  * shell's ladder drifted until one rider's badge disagreed with the chrome.
  *
  * What came across: the SKELETON and the LOOK. What stayed behind: the walk cycle, the weapon mounts,

package/dist/training/compile.d.ts

@@ -2,7 +2,7 @@
  * Compiling a workout: authored segments → a flat, time-addressable timeline.
  *
  * This is where percentages of FTP finally become watts, and it happens **once**,
- * at the start of a ride (and again if the rider moves their difficulty dial
+ * at the start of a ride (and again if the rider edits their FTP
  * mid-session). Everything downstream — the engine's clock, the chart, the ERG
  * target — then addresses the timeline by *time* rather than re-walking the
  * segment tree, which is what keeps a 3x13x30/15 workout (78 efforts, 157

package/dist/training/compile.js

@@ -2,7 +2,7 @@
  * Compiling a workout: authored segments → a flat, time-addressable timeline.
  *
  * This is where percentages of FTP finally become watts, and it happens **once**,
- * at the start of a ride (and again if the rider moves their difficulty dial
+ * at the start of a ride (and again if the rider edits their FTP
  * mid-session). Everything downstream — the engine's clock, the chart, the ERG
  * target — then addresses the timeline by *time* rather than re-walking the
  * segment tree, which is what keeps a 3x13x30/15 workout (78 efforts, 157

package/dist/training/zones.d.ts

@@ -4,8 +4,8 @@
  *
  * These are a *coaching* convention, not a platform scale, which is why they live
  * here and not in `@rydr/game-sdk`. (The platform's own ladder — the 1→50 rider
- * difficulty level — is a different thing entirely and comes from
- * `@rydr/game-sdk/difficulty`; never mix the two.)
+ * rider's own FTP — is a different thing entirely and arrives on the scoped
+ * identity as `ftp`; never mix the two.)
  *
  * Nothing outside this file should hardcode a zone colour: a chart, a badge and a
  * live readout showing the same effort in three different colours is exactly the

package/dist/training/zones.js

@@ -4,8 +4,8 @@
  *
  * These are a *coaching* convention, not a platform scale, which is why they live
  * here and not in `@rydr/game-sdk`. (The platform's own ladder — the 1→50 rider
- * difficulty level — is a different thing entirely and comes from
- * `@rydr/game-sdk/difficulty`; never mix the two.)
+ * rider's own FTP — is a different thing entirely and arrives on the scoped
+ * identity as `ftp`; never mix the two.)
  *
  * Nothing outside this file should hardcode a zone colour: a chart, a badge and a
  * live readout showing the same effort in three different colours is exactly the

package/dist/ui/README.md

@@ -133,7 +133,7 @@ handlers go quiet, `isDown`/`stick` read resting, and anything held is released
 **It also does NOT touch the trainer.** The activity state is left exactly as your game set it, so a
 rider who opens this mid-run keeps the resistance they were riding. This menu is an overlay over LIVE
 gameplay, not a screen they navigated to — they're still on the bike with their legs turning, and
-easing under them (then snapping back on Resume) would change the difficulty of the run they're
+easing under them (then snapping back on Resume) would change the intensity of the run they're
 deciding whether to restart. If your game does want easing while it's up, call
 `session.setActivity("menu")` in `onOpen` and `"playing"` in `onClose` — each game decides.
 
@@ -495,8 +495,7 @@ The scale runs `0 → 1.5 × ftp`, with the rider's threshold marked at two thir
 above it for a sprint. Pass `ftp` (from `session.identity.ftp`) and never hard-code a raw-watt scale —
 the same rule as `createPowerRace`. The effort colour is a **continuous ramp** over %FTP — grey-blue →
 blue → violet → pink → red, interpolated rather than banded, so it never jumps mid-surge — and is **local to this
-component**: they are deliberately not `@rydr/game-sdk/difficulty`'s ramp, which colours the rider's
-chosen *calibration level* and is a different quantity that happens to be measured in watts too.
+component**, not a shared ramp.
 
 Feed it **raw `power`**. It keeps both numbers: the readout shows the true instantaneous value while
 the bar follows an internal EMA so it climbs smoothly between the trainer's sparse (~1–4 Hz) updates.

package/dist/ui/option-menu.d.ts

@@ -45,7 +45,7 @@
  * game left it — a rider who opens it mid-run keeps the resistance they were riding. That is
  * deliberate: this menu is a transient overlay over LIVE gameplay, not a screen the rider navigated
  * to, and they are still on the bike with their legs turning. Dropping to the eased menu resistance
- * and snapping back on `Resume` would change the difficulty of the very run they are deciding
+ * and snapping back on `Resume` would change the intensity of the very run they are deciding
  * whether to restart. (Contrast the PLATFORM overlay, which is the shell's own and does ease.)
  * A game that genuinely wants easing here can still do it itself in `onOpen`/`onClose` —
  * `session.setActivity("menu")` / `("playing")` — which is more flexible than an option anyway.

package/dist/ui/option-menu.js

@@ -45,7 +45,7 @@
  * game left it — a rider who opens it mid-run keeps the resistance they were riding. That is
  * deliberate: this menu is a transient overlay over LIVE gameplay, not a screen the rider navigated
  * to, and they are still on the bike with their legs turning. Dropping to the eased menu resistance
- * and snapping back on `Resume` would change the difficulty of the very run they are deciding
+ * and snapping back on `Resume` would change the intensity of the very run they are deciding
  * whether to restart. (Contrast the PLATFORM overlay, which is the shell's own and does ease.)
  * A game that genuinely wants easing here can still do it itself in `onOpen`/`onClose` —
  * `session.setActivity("menu")` / `("playing")` — which is more flexible than an option anyway.

package/dist/ui/rider-rig.d.ts

@@ -62,7 +62,7 @@
  * 350 W rider therefore see the same gauge do the same thing for the same effort — never hard-code a
  * raw-watt scale (the same rule as {@link createPowerRace}). The effort colour is a continuous ramp
  * over %FTP — grey-blue, blue, violet, pink, red, with no band boundaries to jump at — and is
- * are **local to this component**: they are deliberately NOT `@rydr/game-sdk/difficulty`'s ramp, which
+ * are **local to this component**: they are deliberately NOT a shared ramp, which
  * colours the rider's *chosen calibration level* and would be a different quantity wearing the same
  * paint.
  *

package/dist/ui/rider-rig.js

@@ -62,7 +62,7 @@
  * 350 W rider therefore see the same gauge do the same thing for the same effort — never hard-code a
  * raw-watt scale (the same rule as {@link createPowerRace}). The effort colour is a continuous ramp
  * over %FTP — grey-blue, blue, violet, pink, red, with no band boundaries to jump at — and is
- * are **local to this component**: they are deliberately NOT `@rydr/game-sdk/difficulty`'s ramp, which
+ * are **local to this component**: they are deliberately NOT a shared ramp, which
  * colours the rider's *chosen calibration level* and would be a different quantity wearing the same
  * paint.
  *
@@ -293,7 +293,7 @@ const FLY_GEAR = 2.1;
 const STREAK_FULL_RPM = 95;
 /**
  * %FTP effort colours — LOCAL to this component. See the module header on why this is not
- * `@rydr/game-sdk/difficulty`'s ramp.
+ * this component's own ramp.
  *
  * A CONTINUOUS ramp, not a table of zones. It was six discrete bands (recovery, endurance, tempo,
  * threshold, VO2, anaerobic) and every boundary was a jump: the bar changed colour in one frame while

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rydr/game-sdk",
-  "version": "8.22.0",
+  "version": "9.0.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/bdefrenne/rydr-game-sdk.git"
@@ -44,10 +44,6 @@
       "types": "./dist/overlay/index.d.ts",
       "import": "./dist/overlay/index.js"
     },
-    "./difficulty": {
-      "types": "./dist/difficulty/index.d.ts",
-      "import": "./dist/difficulty/index.js"
-    },
     "./sounds": {
       "types": "./dist/sounds/index.d.ts",
       "import": "./dist/sounds/index.js"

package/dist/difficulty/index.d.ts

@@ -1,141 +0,0 @@
-/**
- * The **FTP-difficulty ladder** — levels 1 → 50, and the watts each one means.
- *
- * This is the rider's chosen calibration: the number every game's `%FTP` demands are a percentage
- * of. It is **not** a measurement of anyone's fitness, and it is not the rank of a score.
- *
- * ## Why this lives in the SDK
- *
- * A leaderboard row carries watts — `BoardEntry.ftpDifficulty` in `src/protocol/boards.ts` — and
- * nothing else. Any game that draws a rider's badge next to their score therefore has to turn those
- * watts into a level and a colour, and a game cannot import the shell's copy across the iframe
- * boundary. Before this module existed the only way through that was to hand-port the ladder into
- * each game, which is exactly what happened: guitar hero shipped a private copy that kept rendering
- * a retired 36-rung metal ladder long after the shell had moved on, so one rider's `ftpDifficulty`
- * produced a bronze "3" in-game and a ramp-coloured "26" in the chrome. **The interpretation of a
- * protocol field belongs to the protocol.** The shell imports this module too — there is one ladder,
- * published once, and both sides read it.
- *
- * Pure by design: no `lit`, no `three`, no DOM. {@link visualForLevel} returns CSS strings, which any
- * renderer can use — a Lit component's `style`, an `innerHTML` template, a canvas fill.
- *
- * ## The scale
- *
- * **Watts are what get stored; the level is derived here.** Every persisted copy of the dial (the
- * shell's `profile.ftpDifficulty`, a leaderboard entry's `ftp_difficulty`) holds watts, and every
- * client computes the level from it through {@link levelForWatts}. That's what lets this scale be
- * redrawn — floor, band widths, tier count — without migrating or reinterpreting a single stored row.
- * The cost, accepted: redrawing it re-labels history, so a shift in the levels reported by analytics
- * can mean the ladder moved rather than the riders.
- *
- * ```
- * watts = level ≤ 9 ? 50 + 5 × (level − 1)   // 50, 55, 60 … 90
- *                   : level × 10             // 100, 110 … 500
- * ```
- *
- * `level × 10 = watts` holds exactly from 100 W up, where essentially every rider sits — that
- * relationship is the point of the number, since it makes "22" readable as "~220 W" with no lookup.
- * Below 100 W the steps are finer because a flat 10 W step there is a **20%** jump where at 400 W
- * it's 2.5%. The floor of 50 W is the researched floor for a deconditioned adult; the ceiling of
- * 500 W is beyond any realistic rider on purpose, so nobody is ever pinned at either end.
- *
- * **There is deliberately no watts-per-press constant** (see {@link stepWatts}): the watts a − / +
- * press moves are whatever the neighbouring rung is — 5 W inside levels 1 → 9, 10 W from level 10
- * up, and 10 W across the 9 → 10 boundary. Any single constant is wrong in one of those bands by
- * construction, which is the bug that convention replaced.
- *
- * The rationale for the whole design, including the colour ramp below, is written up in the platform
- * repo: `rydr-platform/docs/run-level-and-leaderboards.md`.
- */
-/** Weakest level. The ladder is **1-based** — there is no level 0. */
-export declare const LEVEL_MIN = 1;
-/** Strongest level. */
-export declare const LEVEL_MAX = 50;
-/** Watts of the fine band's first rung, i.e. of {@link LEVEL_MIN}. */
-export declare const FTP_MIN = 50;
-/** Watts at {@link LEVEL_MAX}. A real ceiling, not a bucket: nobody is meant to reach it. */
-export declare const FTP_MAX = 500;
-/** Levels per tier badge. Ten tiers × five levels covers 1 → 50 exactly. */
-export declare const LEVELS_PER_TIER = 5;
-/** Number of tier badges. */
-export declare const TIER_COUNT: number;
-/** One rung of the ladder. */
-export interface FtpLevel {
-    /** The level itself, 1 (weakest) → 50 (strongest). This is the number riders see. */
-    level: number;
-    /** What the level means in watts — the value that actually gets stored. */
-    watts: number;
-    /**
-     * Band index, 0 → 9 — five levels each. Purely structural: it exists so a ladder picker can
-     * group 50 rungs into scannable rows, and it carries **no meaning of its own**. The metal and gem
-     * names it used to have (Iron → Diamond) were dropped with the tier colours, because a named tier
-     * reads as a club to belong to and the level is a dial the rider sets, not a rank they earned.
-     * Label a band with {@link rangeLabelForTier}, never with a name.
-     */
-    tier: number;
-}
-/** The pill's visual styling for a level. */
-export interface LevelVisual {
-    /** CSS `background` for the pill — a translucent two-stop gradient of the level's colour. */
-    fill: string;
-    /** Keyline colour. Held at a higher alpha than the fill so the hue stays crisp. */
-    accent: string;
-    /** Shadow/glow colour under the pill. */
-    glow: string;
-    /** Colour for the numeral — the level's own hue, brightened until it's legible on the fill. */
-    ink: string;
-}
-/** Clamp any number to a whole level inside the ladder. */
-export declare function clampLevel(level: number): number;
-/** The watts a level means. Clamps, so it's safe to call with arithmetic results. */
-export declare function wattsForLevel(level: number): number;
-/**
- * The level a watts value sits at — the **nearest** rung, so any number (a legacy profile, the
- * weight-relative result of an onboarding questionnaire, one day a measured estimate) has a level.
- * Ties round up, which matters only for values landing exactly between two rungs.
- *
- * Each band's formula is inverted, then whichever candidate rung is genuinely closer wins. Trusting
- * one formula by a `watts < 100` branch is wrong **at the seam**, because the gap from level 9 (90 W)
- * to level 10 (100 W) is 10 W while the low-band formula divides by 5: it read 98 W as level 11 and
- * snapped it up to 110 W — a 12% jump — and 93 W as level 10. Only 93, 94, 98 and 99 W were affected,
- * which is exactly why it took a brute-force sweep against {@link FTP_LEVELS} to notice.
- */
-export declare function levelForWatts(watts: number): number;
-/** Snap arbitrary watts onto the ladder — `wattsForLevel(levelForWatts(w))`. Idempotent. */
-export declare function snapWatts(watts: number): number;
-/**
- * Move one level from wherever `watts` is, and return the new **watts**.
- *
- * This is the only correct way to step the dial: it derives the level, moves it by one, and reads
- * that level's watts back. Off-ladder input snaps to its nearest rung on the first press, then
- * steps from there. At either end of the ladder it returns the end.
- */
-export declare function stepWatts(watts: number, direction: 1 | -1): number;
-/** The tier badge index (0 → 9) a level belongs to. */
-export declare function tierForLevel(level: number): number;
-/**
- * A level's ramp colour as one flat hex.
- *
- * {@link visualForLevel} returns a translucent CSS gradient, which is right for a pill and useless
- * to anything that needs a single value — a gradient stop, a chart series, a canvas fill. Callers
- * wanting to draw the ramp itself (e.g. a results-screen level track) sample this per level.
- */
-export declare function colourForLevel(level: number): string;
-/** The pill styling for a level — its position on the ramp. */
-export declare function visualForLevel(level: number): LevelVisual;
-/** Every rung, weakest → strongest (level 1 → 50). */
-export declare const FTP_LEVELS: readonly FtpLevel[];
-/** The rung a watts value sits on — the whole {@link FtpLevel}, for UI that needs its parts. */
-export declare function levelAt(watts: number): FtpLevel;
-/** Watts label for a level — "255 W". */
-export declare function wattsLabel(level: number): string;
-/**
- * Level-range label for a band — "26-30". This is what a band gets called now that the metal names
- * are gone: a band is a group of five rungs on a dial, so its honest label is which rungs it spans.
- */
-export declare function levelRangeLabelForTier(tier: number): string;
-/** Watts-range label for a whole tier badge — "270-310 W". */
-export declare function rangeLabelForTier(tier: number): string;
-/** The levels belonging to a tier badge, weakest → strongest. */
-export declare function levelsInTier(tier: number): readonly FtpLevel[];
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/difficulty/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AAEH,sEAAsE;AACtE,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,uBAAuB;AACvB,eAAO,MAAM,SAAS,KAAK,CAAC;AAG5B,sEAAsE;AACtE,eAAO,MAAM,OAAO,KAAK,CAAC;AAG1B,6FAA6F;AAC7F,eAAO,MAAM,OAAO,MAAM,CAAC;AAE3B,4EAA4E;AAC5E,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,6BAA6B;AAC7B,eAAO,MAAM,UAAU,QAA8B,CAAC;AAEtD,8BAA8B;AAC9B,MAAM,WAAW,QAAQ;IACvB,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC1B,6FAA6F;IAC7F,IAAI,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,+FAA+F;IAC/F,GAAG,EAAE,MAAM,CAAC;CACb;AAID,2DAA2D;AAC3D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQnD;AAED,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAElE;AAsLD,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CASzD;AAID,sDAAsD;AACtD,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAGxC,CAAC;AAEH,gGAAgG;AAChG,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAE/C;AAED,yCAAyC;AACzC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,QAAQ,EAAE,CAE9D"}