@ttctl/core 0.0.0 → 0.1.0-rc.1

package/dist/services/profile/skills/index.js

@@ -0,0 +1,461 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { callGatewayShared } from "../../_shared/transport.js";
+export class SkillsError extends Error {
+    code;
+    name = "SkillsError";
+    constructor(code, message, options) {
+        super(message, options);
+        this.code = code;
+    }
+}
+/**
+ * Thin per-service wrapper around {@link callGatewayShared} (issue
+ * #329). Pins the talent-profile surface and the {@link SkillsError}
+ * domain class. The `variables: unknown` parameter (cast to
+ * `Record<string, unknown>` here) preserves the historical signature
+ * — every leaf in this file constructs a fresh variables literal that
+ * is structurally a `Record` regardless of nominal typing.
+ */
+async function callTalentProfile(token, operationName, query, variables, schema) {
+    return callGatewayShared("talent-profile", token, operationName, query, variables, SkillsError, { schema });
+}
+// -----------------------------------------------------------------------
+// GraphQL operation documents
+//
+// These mirror `research/graphql/talent_profile/operations/*.graphql`,
+// stripped of the unwired fragment dependencies (`MutationResultFragment`,
+// `UserErrorFragment`, `ProfileCompletion`, `RealTimeFields`,
+// `SkillsReadiness`, `ProfileRecommendations`) that the codegen pipeline
+// hasn't yet been pointed at. The fragments are inlined to the minimum
+// shape each leaf consumes — same pattern as `UPDATE_BASIC_INFO_MUTATION`
+// in `profile.basic`.
+//
+// **Operation names are SCREAMING_CASE for mutations and camelCase for
+// queries**, matching the bundle-extracted documents — see
+// `research/notes/05-talent-profile-api.md` for the rationale (the server
+// matches `operationName` literally and the React app sends these forms).
+// -----------------------------------------------------------------------
+const ADD_PROFILE_SKILL_SET_MUTATION = `mutation ADD_PROFILE_SKILL_SET($input: AddProfileSkillSetInput!) {
+  addProfileSkillSet(input: $input) {
+    skillSet {
+      id
+      experience
+      rating
+      public
+      position
+      skill { id name }
+      connections { totalCount }
+    }
+    success
+    notice
+    errors { code key message }
+  }
+}`;
+const REMOVE_PROFILE_SKILL_SET_MUTATION = `mutation REMOVE_PROFILE_SKILL_SET($input: RemoveProfileSkillSetInput!) {
+  removeProfileSkillSet(input: $input) {
+    success
+    notice
+    errors { code key message }
+    profile { id }
+  }
+}`;
+const UPDATE_RATING_MUTATION = `mutation UPDATE_PROFILE_SKILL_SET_RATING($input: UpdateProfileSkillSetRatingInput!) {
+  updateProfileSkillSetRating(input: $input) {
+    skillSet { id rating }
+    success
+    notice
+    errors { code key message }
+  }
+}`;
+const UPDATE_EXPERIENCE_MUTATION = `mutation UPDATE_PROFILE_SKILL_SET_EXPERIENCE($input: UpdateProfileSkillSetExperienceInput!) {
+  updateProfileSkillSetExperience(input: $input) {
+    skillSet { id experience }
+    success
+    notice
+    errors { code key message }
+  }
+}`;
+const UPDATE_PUBLICITY_MUTATION = `mutation UPDATE_PROFILE_SKILL_SET_PUBLICITY($input: UpdateProfileSkillSetPublicityInput!) {
+  updateProfileSkillSetPublicity(input: $input) {
+    skillSet { id public }
+    success
+    notice
+    errors { code key message }
+  }
+}`;
+const GET_SKILL_SET_QUERY = `query GetSkillSetWithConnections($id: ID!) {
+  node(id: $id) {
+    ... on ProfileSkillSet {
+      id
+      experience
+      rating
+      public
+      position
+      skill { id name }
+      connections {
+        totalCount
+        nodes {
+          ... on Node { id }
+        }
+      }
+    }
+  }
+}`;
+const LIST_SKILL_SETS_QUERY = `query getSkillSetsWithConnectionsWithConnectionsCount($profileId: ID!) {
+  profile(id: $profileId) {
+    id
+    skillSets {
+      nodes {
+        id
+        experience
+        rating
+        public
+        position
+        skill { id name }
+        connections { totalCount }
+      }
+    }
+  }
+}`;
+const AUTOCOMPLETE_SKILLS_QUERY = `query GET_SKILLS_FOR_AUTOCOMPLETE($profileId: ID!, $search: String!, $limit: Int!, $withoutIds: [ID!]) {
+  profile(id: $profileId) {
+    id
+    skillsAutocomplete(search: $search, limit: $limit, withoutIds: $withoutIds) {
+      id
+      name
+    }
+  }
+}`;
+const SKILLS_READINESS_QUERY = `query getSkillsReadiness($profileId: ID!) {
+  profile(id: $profileId) {
+    id
+    skillsReadiness {
+      isExpertProficiencyCountSatisfied
+      isHighlightedItemsCountAndExperienceSatisfied
+      isItemsCountSatisfied
+      isProficiencyNotSetCountSatisfied
+      isProgrammingLanguageSatisfied
+    }
+  }
+}`;
+function normaliseSkillSet(wire) {
+    return {
+        id: wire.id,
+        experience: wire.experience,
+        rating: wire.rating,
+        public: wire.public,
+        position: wire.position,
+        skill: wire.skill,
+        connectionsCount: wire.connections.totalCount,
+    };
+}
+function raiseUserErrors(operation, errors) {
+    if (!Array.isArray(errors) || errors.length === 0)
+        return;
+    const first = errors[0];
+    const fieldHint = first?.key ? ` (${first.key})` : "";
+    throw new SkillsError("USER_ERROR", `${operation} rejected${fieldHint}: ${first?.message ?? "unknown error"}`);
+}
+// -----------------------------------------------------------------------
+// add(skillName)
+// -----------------------------------------------------------------------
+/**
+ * Add a skill to the signed-in user's profile. Identifies the skill by
+ * its catalog name (e.g. `"TypeScript"`); the server resolves the name to
+ * a `Skill` id under the hood and returns the newly-attached
+ * `ProfileSkillSet` with default `rating`/`experience`/`public` values.
+ *
+ * Use {@link autocomplete} first if the caller needs to disambiguate
+ * between candidate skills (e.g., "Postgres" vs "PostgreSQL"). Once the
+ * skill is added, configure proficiency via {@link set}.
+ *
+ * Errors:
+ * - `SkillsError` `VALIDATION_ERROR` when `name` is empty or whitespace-only.
+ * - `SkillsError` `USER_ERROR` when the server reports a domain failure
+ *   (e.g., skill already on profile, name not in catalog).
+ * - `AuthRevokedError`, `Cf403Error`, plus the standard
+ *   `GRAPHQL_ERROR`/`NETWORK_ERROR`/`UNKNOWN` codes from the shared
+ *   transport-error path.
+ */
+export async function add(token, name) {
+    const trimmed = name.trim();
+    if (trimmed.length === 0) {
+        throw new SkillsError("VALIDATION_ERROR", "Skill name is required.");
+    }
+    const data = await callTalentProfile(token, "ADD_PROFILE_SKILL_SET", ADD_PROFILE_SKILL_SET_MUTATION, {
+        input: { name: trimmed },
+    });
+    const payload = data.addProfileSkillSet;
+    if (!payload) {
+        throw new SkillsError("UNKNOWN", "ADD_PROFILE_SKILL_SET response had no `data.addProfileSkillSet` field");
+    }
+    raiseUserErrors("Skill add", payload.errors);
+    if (payload.success === false) {
+        throw new SkillsError("USER_ERROR", `Skill add reported success=false${payload.notice ? `: ${payload.notice}` : ""}`);
+    }
+    if (!payload.skillSet) {
+        throw new SkillsError("UNKNOWN", "Skill add succeeded but response had no `skillSet` payload");
+    }
+    return normaliseSkillSet(payload.skillSet);
+}
+// -----------------------------------------------------------------------
+// rm(skillSetId)
+// -----------------------------------------------------------------------
+/**
+ * Remove a skill from the signed-in user's profile by its ProfileSkillSet
+ * id (NOT the Skill catalog id). Removal cascades to any connections the
+ * skill set held to portfolio items, education, employment, or
+ * certifications — the server cleans those up server-side, no per-edge
+ * call required from the client.
+ *
+ * Errors:
+ * - `SkillsError` `VALIDATION_ERROR` when `id` is empty.
+ * - `SkillsError` `USER_ERROR` when the id doesn't match a skill set on
+ *   the user's profile (caller used a stale id).
+ * - Standard transport-error path (auth-revoked / Cf403 / GraphQL /
+ *   network / unknown).
+ */
+export async function rm(token, id) {
+    if (id.trim().length === 0) {
+        throw new SkillsError("VALIDATION_ERROR", "Skill set id is required.");
+    }
+    const data = await callTalentProfile(token, "REMOVE_PROFILE_SKILL_SET", REMOVE_PROFILE_SKILL_SET_MUTATION, { input: { skillSetId: id } });
+    const payload = data.removeProfileSkillSet;
+    if (!payload) {
+        throw new SkillsError("UNKNOWN", "REMOVE_PROFILE_SKILL_SET response had no `data.removeProfileSkillSet` field");
+    }
+    raiseUserErrors("Skill remove", payload.errors);
+    if (payload.success === false) {
+        throw new SkillsError("USER_ERROR", `Skill remove reported success=false${payload.notice ? `: ${payload.notice}` : ""}`);
+    }
+}
+// -----------------------------------------------------------------------
+// set(id, fields)
+// -----------------------------------------------------------------------
+/**
+ * Update one or more fields on an existing skill set. Multi-flag atomic
+ * semantics: each provided field fires its own GraphQL mutation
+ * (`UPDATE_PROFILE_SKILL_SET_RATING` / `_EXPERIENCE` / `_PUBLICITY`)
+ * sequentially. **Partial-failure behavior**: if mutation N succeeds but
+ * mutation N+1 fails, the prior changes are NOT rolled back — the server
+ * lacks a multi-field atomic path, so the client serialises the updates
+ * and reports a `PARTIAL_FAILURE` error carrying which fields landed and
+ * which didn't. Callers re-issue only the missing fields after handling
+ * the failure.
+ *
+ * The mutation order is `rating → experience → public`, deterministic so
+ * tests can predict the call sequence.
+ *
+ * Errors:
+ * - `SkillsError` `VALIDATION_ERROR` when `id` is empty OR no fields
+ *   are supplied.
+ * - `SkillsError` `PARTIAL_FAILURE` when the second or third mutation
+ *   fails after at least one earlier mutation succeeded. The error
+ *   message names the failing field and the underlying message; the
+ *   error's `cause` carries the per-field failure for callers that want
+ *   structured access. The successful fields are reflected in the
+ *   `result` snapshot included on the error.
+ * - `SkillsError` `USER_ERROR` when the FIRST mutation fails — caller
+ *   sees the same shape they'd see from a single-flag invocation.
+ * - Standard transport-error path.
+ */
+export async function set(token, id, fields) {
+    if (id.trim().length === 0) {
+        throw new SkillsError("VALIDATION_ERROR", "Skill set id is required.");
+    }
+    if (fields.rating === undefined && fields.experience === undefined && fields.public === undefined) {
+        throw new SkillsError("VALIDATION_ERROR", "Skill update requires at least one of `rating`, `experience`, or `public`.");
+    }
+    const result = {
+        id,
+        rating: null,
+        experience: null,
+        public: null,
+        notices: [],
+    };
+    const completed = [];
+    // Helper used per-mutation: drives the first call as a normal failure
+    // (USER_ERROR / standard transport error), and any subsequent failure
+    // as PARTIAL_FAILURE so the caller can reason about which writes landed.
+    const runStep = async (field, fire) => {
+        try {
+            await fire();
+            completed.push(field);
+        }
+        catch (err) {
+            if (completed.length === 0)
+                throw err;
+            throw new SkillsError("PARTIAL_FAILURE", `Skill update partially failed: ${completed.join(", ")} succeeded, ${field} failed: ${err.message}`, { cause: err });
+        }
+    };
+    if (fields.rating !== undefined) {
+        const rating = fields.rating;
+        await runStep("rating", async () => {
+            const data = await callTalentProfile(token, "UPDATE_PROFILE_SKILL_SET_RATING", UPDATE_RATING_MUTATION, { input: { skillSetId: id, skillSet: { rating } } });
+            const payload = data.updateProfileSkillSetRating;
+            if (!payload) {
+                throw new SkillsError("UNKNOWN", "UPDATE_PROFILE_SKILL_SET_RATING response had no payload");
+            }
+            raiseUserErrors("Skill rating update", payload.errors);
+            if (payload.success === false) {
+                throw new SkillsError("USER_ERROR", `Skill rating update reported success=false${payload.notice ? `: ${payload.notice}` : ""}`);
+            }
+            result.rating = payload.skillSet?.rating ?? rating;
+            if (payload.notice)
+                result.notices.push(payload.notice);
+        });
+    }
+    if (fields.experience !== undefined) {
+        const experience = fields.experience;
+        await runStep("experience", async () => {
+            const data = await callTalentProfile(token, "UPDATE_PROFILE_SKILL_SET_EXPERIENCE", UPDATE_EXPERIENCE_MUTATION, { input: { skillSetId: id, skillSet: { experience } } });
+            const payload = data.updateProfileSkillSetExperience;
+            if (!payload) {
+                throw new SkillsError("UNKNOWN", "UPDATE_PROFILE_SKILL_SET_EXPERIENCE response had no payload");
+            }
+            raiseUserErrors("Skill experience update", payload.errors);
+            if (payload.success === false) {
+                throw new SkillsError("USER_ERROR", `Skill experience update reported success=false${payload.notice ? `: ${payload.notice}` : ""}`);
+            }
+            result.experience = payload.skillSet?.experience ?? experience;
+            if (payload.notice)
+                result.notices.push(payload.notice);
+        });
+    }
+    if (fields.public !== undefined) {
+        const isPublic = fields.public;
+        await runStep("public", async () => {
+            const data = await callTalentProfile(token, "UPDATE_PROFILE_SKILL_SET_PUBLICITY", UPDATE_PUBLICITY_MUTATION, { input: { skillSetId: id, skillSet: { public: isPublic } } });
+            const payload = data.updateProfileSkillSetPublicity;
+            if (!payload) {
+                throw new SkillsError("UNKNOWN", "UPDATE_PROFILE_SKILL_SET_PUBLICITY response had no payload");
+            }
+            raiseUserErrors("Skill publicity update", payload.errors);
+            if (payload.success === false) {
+                throw new SkillsError("USER_ERROR", `Skill publicity update reported success=false${payload.notice ? `: ${payload.notice}` : ""}`);
+            }
+            result.public = payload.skillSet?.public ?? isPublic;
+            if (payload.notice)
+                result.notices.push(payload.notice);
+        });
+    }
+    return result;
+}
+// -----------------------------------------------------------------------
+// show(id)
+// -----------------------------------------------------------------------
+/**
+ * Fetch a single skill set by its id, including its connection edges to
+ * portfolio items / employment / education / certifications. Useful when
+ * the caller already has the id (from `list()` or a recent mutation) and
+ * needs to display the full detail without paging.
+ *
+ * Errors:
+ * - `SkillsError` `VALIDATION_ERROR` when `id` is empty.
+ * - `SkillsError` `USER_ERROR` when the id doesn't resolve to a
+ *   `ProfileSkillSet` (server returns `node: null`).
+ * - Standard transport-error path.
+ */
+export async function show(token, id) {
+    if (id.trim().length === 0) {
+        throw new SkillsError("VALIDATION_ERROR", "Skill set id is required.");
+    }
+    const data = await callTalentProfile(token, "GetSkillSetWithConnections", GET_SKILL_SET_QUERY, {
+        id,
+    });
+    if (!data.node) {
+        throw new SkillsError("USER_ERROR", `No ProfileSkillSet found with id "${id}".`);
+    }
+    return normaliseSkillSet(data.node);
+}
+// -----------------------------------------------------------------------
+// list(profileId)
+// -----------------------------------------------------------------------
+/**
+ * List every skill set on the signed-in user's profile, with each entry
+ * carrying its connection-count summary (the digits the portal shows next
+ * to "linked to N items"). Order matches the server's `position` field;
+ * callers that need a specific sort apply it after fetching.
+ *
+ * The talent-profile surface keys this query on `profileId` rather than
+ * resolving it server-side from the auth token, so the caller passes the
+ * `profileId` it has on hand (typically obtained from `profile.basic.show`
+ * or cached for the session).
+ *
+ * Errors:
+ * - `SkillsError` `VALIDATION_ERROR` when `profileId` is empty.
+ * - `SkillsError` `USER_ERROR` when the profile id doesn't resolve.
+ * - Standard transport-error path.
+ */
+export async function list(token, profileId) {
+    if (profileId.trim().length === 0) {
+        throw new SkillsError("VALIDATION_ERROR", "Profile id is required.");
+    }
+    const data = await callTalentProfile(token, "getSkillSetsWithConnectionsWithConnectionsCount", LIST_SKILL_SETS_QUERY, { profileId });
+    if (!data.profile) {
+        throw new SkillsError("USER_ERROR", `No profile found with id "${profileId}".`);
+    }
+    return data.profile.skillSets.nodes.filter((n) => n !== null).map(normaliseSkillSet);
+}
+// -----------------------------------------------------------------------
+// autocomplete(profileId, query, options?)
+// -----------------------------------------------------------------------
+/**
+ * Search the global skill catalog for entries matching `search`,
+ * suitable for populating an autocomplete dropdown. The server scopes
+ * results to skills the talent's vertical permits and excludes any ids
+ * passed in `withoutIds` (typically the talent's existing skill-set
+ * skill ids, so the dropdown doesn't suggest skills they already have).
+ *
+ * `limit` defaults to 10 (matches the portal's default page size).
+ *
+ * Errors:
+ * - `SkillsError` `VALIDATION_ERROR` when `profileId` or `search` is empty.
+ * - Standard transport-error path.
+ */
+export async function autocomplete(token, profileId, search, options = {}) {
+    if (profileId.trim().length === 0) {
+        throw new SkillsError("VALIDATION_ERROR", "Profile id is required.");
+    }
+    if (search.trim().length === 0) {
+        throw new SkillsError("VALIDATION_ERROR", "Search query is required.");
+    }
+    const data = await callTalentProfile(token, "GET_SKILLS_FOR_AUTOCOMPLETE", AUTOCOMPLETE_SKILLS_QUERY, {
+        profileId,
+        search: search.trim(),
+        limit: options.limit ?? 10,
+        withoutIds: options.withoutIds ?? [],
+    });
+    if (!data.profile) {
+        throw new SkillsError("USER_ERROR", `No profile found with id "${profileId}".`);
+    }
+    return data.profile.skillsAutocomplete;
+}
+// -----------------------------------------------------------------------
+// readiness(profileId)
+// -----------------------------------------------------------------------
+/**
+ * Fetch the skill-readiness snapshot for the user's profile — the same
+ * heuristics the portal uses to gate the "ready to apply" state on the
+ * skills section. Useful for surfacing a checklist of remaining tasks
+ * via CLI or MCP.
+ *
+ * Errors:
+ * - `SkillsError` `VALIDATION_ERROR` when `profileId` is empty.
+ * - `SkillsError` `USER_ERROR` when the profile id doesn't resolve.
+ * - Standard transport-error path.
+ */
+export async function readiness(token, profileId) {
+    if (profileId.trim().length === 0) {
+        throw new SkillsError("VALIDATION_ERROR", "Profile id is required.");
+    }
+    const data = await callTalentProfile(token, "getSkillsReadiness", SKILLS_READINESS_QUERY, {
+        profileId,
+    });
+    if (!data.profile) {
+        throw new SkillsError("USER_ERROR", `No profile found with id "${profileId}".`);
+    }
+    return data.profile.skillsReadiness;
+}
+//# sourceMappingURL=index.js.map

package/dist/services/profile/skills/index.js.map

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

package/dist/services/profile/visas/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Visas sub-domain error codes. Cross-cutting auth/Cloudflare failures
+ * propagate as `TtctlError` subclasses unchanged.
+ */
+export type VisasErrorCode = "NO_VIEWER" | "GRAPHQL_ERROR" | "NETWORK_ERROR" | "USER_ERROR" | "VALIDATION_ERROR" | "WIRE_SHAPE_ERROR" | "UNKNOWN";
+export declare class VisasError extends Error {
+    readonly code: VisasErrorCode;
+    readonly name = "VisasError";
+    constructor(code: VisasErrorCode, message: string, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * Read-side `TravelVisa` shape. Mirrors the `TravelVisa` fragment in
+ * `research/graphql/talent_profile/fragments/TravelVisa.graphql`. The
+ * server names the country sub-object — TTCtl flattens it onto the
+ * top-level shape for ergonomic access at the CLI layer.
+ */
+export interface TravelVisa {
+    id: string;
+    countryId: string;
+    countryName: string;
+    visaType: string;
+    expiryDate: string | null;
+}
+/**
+ * Write-side `TravelVisaInput`. The country reference uses `countryId`
+ * (the ID returned by the read-side `country.id`); `visaType` is a free
+ * string the server validates against its catalog of known visa types.
+ *
+ * **[INFERRED]** Wrapper key `travelVisa` (Pattern 1/2 from
+ * `research/notes/10-mutation-input-patterns.md`); falsifiable by live
+ * capture if the server rejects the wrapper.
+ */
+export interface TravelVisaInput {
+    countryId?: string;
+    visaType?: string;
+    expiryDate?: string;
+}
+/**
+ * Fetch the signed-in user's travel-visa records. Empty list returns `[]`,
+ * never `null`.
+ */
+export declare function list(token: string): Promise<TravelVisa[]>;
+/**
+ * Create a new travel-visa record.
+ *
+ * Both `countryId` and `visaType` are required by the AC; `expiryDate`
+ * is optional. The wire-side error path returns `errors[]` on the
+ * mutation payload when the server rejects (e.g. unknown country,
+ * malformed date) — those collapse into `USER_ERROR`.
+ */
+export declare function add(token: string, input: TravelVisaInput): Promise<TravelVisa[]>;
+/**
+ * Update a travel-visa record by id.
+ *
+ * `UpdateTravelVisaInput.travelVisa` is treated as a **full-document
+ * replacement** by the server — `countryId` and `visaType` are
+ * non-nullable on the input even when the caller doesn't want to change
+ * them. Sending only the patched field returns
+ * `Variable $input of type UpdateTravelVisaInput! was provided invalid
+ * value for travelVisa.countryId/visaType (Expected value to not be
+ * null)` (verified live 2026-05-15, see #317).
+ *
+ * To preserve the partial-update UX over the full-replace wire shape,
+ * this function does read-modify-write: fetch the current record via
+ * {@link list}, merge caller's `changes` on top of the current state,
+ * then send the merged input. Same pattern as
+ * `services/profile/portfolio/index.ts` `update` (PR #323 / #314).
+ */
+export declare function update(token: string, id: string, changes: TravelVisaInput): Promise<TravelVisa[]>;
+/** Remove a travel-visa record by id. */
+export declare function remove(token: string, id: string): Promise<TravelVisa[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/services/profile/visas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/profile/visas/index.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,eAAe,GACf,eAAe,GACf,YAAY,GACZ,kBAAkB,GAClB,kBAAkB,GAClB,SAAS,CAAC;AAEd,qBAAa,UAAW,SAAQ,KAAK;aAGjB,IAAI,EAAE,cAAc;IAFtC,SAAkB,IAAI,gBAAgB;gBAEpB,IAAI,EAAE,cAAc,EACpC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAIhC;AAaD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA2GD;;;GAGG;AACH,wBAAsB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAkB/D;AAoCD;;;;;;;GAOG;AACH,wBAAsB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CA4BtF;AA+BD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAsCvG;AA0BD,yCAAyC;AACzC,wBAAsB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAmB7E"}