alchemy 2.0.0-beta.74 → 2.0.0-beta.76

package/lib/Railway/Project.d.ts

@@ -0,0 +1,192 @@
+import type { ProjectCreateResponse } from "@distilled.cloud/railway";
+import * as railway from "@distilled.cloud/railway";
+import * as Effect from "effect/Effect";
+import * as Provider from "../Provider.ts";
+import { Resource } from "../Resource.ts";
+import { RailwayEnvironment } from "./Environment.ts";
+import type { Providers } from "./Providers.ts";
+export interface ProjectProps {
+    /**
+     * Project name. Unique per workspace. If omitted, a unique name is
+     * generated from the stack, stage and logical ID. Changing it updates
+     * the project in place.
+     */
+    name?: string;
+    /**
+     * Workspace to create the project in. Defaults to the current token's
+     * workspace (`me.workspace ?? me.workspaces[0]`). Changing it replaces
+     * the project.
+     */
+    workspaceId?: string;
+    /**
+     * Human-readable description. Updates in place.
+     */
+    description?: string;
+    /**
+     * Name of the environment created with the project (Railway's default
+     * is `production`). Create-only; ignored on update.
+     */
+    defaultEnvironmentName?: string;
+}
+export type Project = Resource<"Railway.Project", ProjectProps, {
+    /** Railway project id. */
+    projectId: string;
+    /** Physical project name (unique per workspace). */
+    name: string;
+    /** Workspace the project lives in. */
+    workspaceId: string;
+    /** Primary / base environment id created with the project. */
+    environmentId: string;
+    /** Dashboard URL (`https://railway.com/project/{projectId}`). */
+    url: string;
+}, never, Providers>;
+/**
+ * A Railway.Project is a workspace-scoped namespace. It owns environments
+ * and services. Names are unique per workspace.
+ *
+ * @see https://docs.railway.com/guides/projects
+ *
+ * ### Create a Project
+ * Alchemy generates a unique name unless you pass one. `url` is the
+ * dashboard URL. A production environment is created with the project —
+ * do not recreate it as an Environment resource.
+ *
+ * **Example:** Generated name
+ * ```typescript
+ * const site = yield* Railway.Project("Site");
+ * ```
+ *
+ * :::note
+ * Prefer omitting `name` in tests and CI so names stay unique and
+ * reclaimable.
+ * :::
+ *
+ * ### A stable name
+ * Pass `name` when you need a stable project name. Changing it later
+ * updates the project in place.
+ *
+ * **Example:** Explicit name
+ * ```typescript
+ * const site = yield* Railway.Project("Site", {
+ *   name: "my-site",
+ * });
+ * ```
+ *
+ * ### Description
+ * `description` is optional and updates in place.
+ *
+ * **Example:** With description
+ * ```typescript
+ * const site = yield* Railway.Project("Site", {
+ *   description: "production web app",
+ * });
+ * ```
+ *
+ * ### Workspace
+ * Workspace defaults to the current token. Pass `workspaceId` to pin it.
+ *
+ * **Example:** Pin a workspace
+ * ```typescript
+ * const site = yield* Railway.Project("Site", {
+ *   workspaceId: "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
+ * });
+ * ```
+ *
+ * :::caution[Changing `workspaceId` replaces the Project]
+ * The Project is created in the new workspace. The old Project is deleted.
+ * :::
+ *
+ * ### Default environment name
+ * `defaultEnvironmentName` is create-only. Railway's default is
+ * `production`. Extra environments (staging) are a separate Environment
+ * resource.
+ *
+ * **Example:** Custom default environment
+ * ```typescript
+ * const site = yield* Railway.Project("Site", {
+ *   defaultEnvironmentName: "production",
+ * });
+ * ```
+ *
+ * ### Module-scope declarations
+ * Declare the Project once. Pass it into every child. Resource-valued
+ * props accept the resource or an Effect producing it.
+ *
+ * **Example:** Module-scope Project
+ * ```typescript
+ * // src/project.ts
+ * import * as Railway from "alchemy/Railway";
+ *
+ * export const Site = Railway.Project("Site");
+ * ```
+ *
+ * @resource
+ */
+export declare const Project: import("../Resource.ts").ResourceClass<Project>;
+declare const ProjectNotCreated_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Railway.ProjectNotCreated";
+} & Readonly<A>;
+export declare class ProjectNotCreated extends ProjectNotCreated_base<{
+    name: string;
+}> {
+}
+/** Workspace id from a get-by-id or list-node Project payload. */
+export declare const workspaceIdOf: (project: {
+    readonly workspaceId?: string | null;
+    readonly workspace?: {
+        readonly id?: string | null;
+    } | null;
+}, fallback?: string) => string;
+/** Primary environment id from a get-by-id or list-node Project payload. */
+export declare const environmentIdOf: (project: {
+    readonly primaryEnvironmentId?: string | null;
+    readonly baseEnvironmentId?: string | null;
+    readonly baseEnvironment?: {
+        readonly id?: string | null;
+    } | null;
+}) => string;
+export declare const createProject: (input: {
+    name: string;
+    workspaceId: string;
+    description?: string;
+    defaultEnvironmentName?: string;
+}) => Effect.Effect<ProjectCreateResponse, railway.RailwayOpError, railway.RailwayOpContext>;
+/**
+ * Workspace projects Alchemy owns. Distilled `projects.items` plus the
+ * physical-name filter — Railway has no tags. No lock, no retry override.
+ */
+export declare const ownedProjects: () => Effect.Effect<{
+    /** Railway project id. */
+    projectId: string;
+    /** Physical project name (unique per workspace). */
+    name: string;
+    /** Workspace the project lives in. */
+    workspaceId: string;
+    /** Primary / base environment id created with the project. */
+    environmentId: string;
+    /** Dashboard URL (`https://railway.com/project/{projectId}`). */
+    url: string;
+}[], railway.RailwayOpError, RailwayEnvironment | railway.RailwayOpContext>;
+export declare const listOwnedProjects: () => Effect.Effect<{
+    /** Railway project id. */
+    projectId: string;
+    /** Physical project name (unique per workspace). */
+    name: string;
+    /** Workspace the project lives in. */
+    workspaceId: string;
+    /** Primary / base environment id created with the project. */
+    environmentId: string;
+    /** Dashboard URL (`https://railway.com/project/{projectId}`). */
+    url: string;
+}[], railway.RailwayOpError, RailwayEnvironment | railway.RailwayOpContext>;
+/**
+ * Live environment ids under a project, including the stamped primary.
+ * `list()` walks these so partition environments are not invisible.
+ */
+export declare const projectEnvironmentIds: (project: {
+    projectId: string;
+    environmentId: string;
+}) => Effect.Effect<string[], railway.BadRequest | railway.Conflict | railway.Forbidden | import("effect/unstable/http/HttpClientError").HttpClientError | railway.Locked | railway.RailwayForbidden | railway.RailwayInternalError | railway.RailwayParseError | railway.RailwayPlanLimitExceeded | railway.RailwayRateLimited | railway.RailwayServiceDomainCreateFailed | railway.RailwayUnauthenticated | railway.RailwayValidationError | railway.UnknownRailwayError | railway.UnprocessableEntity | import("@distilled.cloud/axiom").DefaultErrors, railway.RailwayOpContext>;
+export declare const ProjectProvider: () => import("effect/Layer").Layer<Provider.Provider<Project>, never, RailwayEnvironment | import("../Stack.ts").Stack | import("../Stage.ts").Stage | railway.RailwayOpContext>;
+export {};
+//# sourceMappingURL=Project.d.ts.map

package/lib/Railway/Project.d.ts.map

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

package/lib/Railway/Project.js

@@ -0,0 +1,272 @@
+import * as railway from "@distilled.cloud/railway";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Schedule from "effect/Schedule";
+import * as Stream from "effect/Stream";
+import { Unowned } from "../AdoptPolicy.js";
+import { isResolved } from "../Diff.js";
+import * as Provider from "../Provider.js";
+import { Resource } from "../Resource.js";
+import { RailwayEnvironment } from "./Environment.js";
+import { waitOutCreateRateLimit } from "./transient.js";
+import { createRailwayName, matchesAlchemyPhysicalName, sanitizeRailwayName, } from "./Metadata.js";
+/**
+ * A Railway.Project is a workspace-scoped namespace. It owns environments
+ * and services. Names are unique per workspace.
+ *
+ * @see https://docs.railway.com/guides/projects
+ *
+ * ### Create a Project
+ * Alchemy generates a unique name unless you pass one. `url` is the
+ * dashboard URL. A production environment is created with the project —
+ * do not recreate it as an Environment resource.
+ *
+ * **Example:** Generated name
+ * ```typescript
+ * const site = yield* Railway.Project("Site");
+ * ```
+ *
+ * :::note
+ * Prefer omitting `name` in tests and CI so names stay unique and
+ * reclaimable.
+ * :::
+ *
+ * ### A stable name
+ * Pass `name` when you need a stable project name. Changing it later
+ * updates the project in place.
+ *
+ * **Example:** Explicit name
+ * ```typescript
+ * const site = yield* Railway.Project("Site", {
+ *   name: "my-site",
+ * });
+ * ```
+ *
+ * ### Description
+ * `description` is optional and updates in place.
+ *
+ * **Example:** With description
+ * ```typescript
+ * const site = yield* Railway.Project("Site", {
+ *   description: "production web app",
+ * });
+ * ```
+ *
+ * ### Workspace
+ * Workspace defaults to the current token. Pass `workspaceId` to pin it.
+ *
+ * **Example:** Pin a workspace
+ * ```typescript
+ * const site = yield* Railway.Project("Site", {
+ *   workspaceId: "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
+ * });
+ * ```
+ *
+ * :::caution[Changing `workspaceId` replaces the Project]
+ * The Project is created in the new workspace. The old Project is deleted.
+ * :::
+ *
+ * ### Default environment name
+ * `defaultEnvironmentName` is create-only. Railway's default is
+ * `production`. Extra environments (staging) are a separate Environment
+ * resource.
+ *
+ * **Example:** Custom default environment
+ * ```typescript
+ * const site = yield* Railway.Project("Site", {
+ *   defaultEnvironmentName: "production",
+ * });
+ * ```
+ *
+ * ### Module-scope declarations
+ * Declare the Project once. Pass it into every child. Resource-valued
+ * props accept the resource or an Effect producing it.
+ *
+ * **Example:** Module-scope Project
+ * ```typescript
+ * // src/project.ts
+ * import * as Railway from "alchemy/Railway";
+ *
+ * export const Site = Railway.Project("Site");
+ * ```
+ *
+ * @resource
+ */
+export const Project = Resource("Railway.Project");
+export class ProjectNotCreated extends Data.TaggedError("Railway.ProjectNotCreated") {
+}
+/** Workspace id from a get-by-id or list-node Project payload. */
+export const workspaceIdOf = (project, fallback) => project.workspaceId ?? project.workspace?.id ?? fallback ?? "";
+/** Primary environment id from a get-by-id or list-node Project payload. */
+export const environmentIdOf = (project) => project.primaryEnvironmentId ??
+    project.baseEnvironmentId ??
+    project.baseEnvironment?.id ??
+    "";
+const toAttrs = (project, fallback) => {
+    const name = project.name || fallback?.name || "";
+    return {
+        projectId: project.id,
+        name,
+        workspaceId: workspaceIdOf(project, fallback?.workspaceId),
+        environmentId: environmentIdOf(project) || fallback?.environmentId || "",
+        url: `https://railway.com/project/${project.id}`,
+    };
+};
+const fillEnvironmentId = (attrs) => {
+    if (attrs.environmentId.length > 0)
+        return Effect.succeed(attrs);
+    return railway.environments
+        .items({ projectId: attrs.projectId, first: 5 })
+        .pipe(Stream.filter((env) => env.deletedAt == null), Stream.take(1), Stream.runHead, Effect.map((option) => option._tag === "Some"
+        ? { ...attrs, environmentId: option.value.id }
+        : attrs), Effect.catchTag(["RailwayNotFound", "NotFound"], () => Effect.succeed(attrs)));
+};
+const resolveName = (id, name, existing) => Effect.gen(function* () {
+    if (name !== undefined)
+        return sanitizeRailwayName(name);
+    if (existing !== undefined)
+        return existing;
+    return yield* createRailwayName(id);
+});
+const isGone = (project) => project === undefined || project.deletedAt != null;
+const getById = (projectId) => railway.project({ id: projectId }).pipe(Effect.map((project) => (isGone(project) ? undefined : project)), Effect.catchTag(["RailwayNotFound", "NotFound"], () => Effect.succeed(undefined)));
+const currentWorkspaceId = Effect.fn(function* () {
+    const env = yield* yield* RailwayEnvironment;
+    return env.workspaceId;
+});
+export const createProject = (input) => waitOutCreateRateLimit(railway.projectCreate({
+    input: {
+        name: input.name,
+        workspaceId: input.workspaceId,
+        ...(input.description !== undefined
+            ? { description: input.description }
+            : {}),
+        ...(input.defaultEnvironmentName !== undefined
+            ? { defaultEnvironmentName: input.defaultEnvironmentName }
+            : {}),
+    },
+}));
+const findByName = (workspaceId, name) => railway.projects
+    .items({ workspaceId, first: 50, includeDeleted: false })
+    .pipe(Stream.filter((project) => !isGone(project) && project.name === name), Stream.take(1), Stream.runHead, Effect.map((option) => option._tag === "Some" ? option.value : undefined));
+/**
+ * Workspace projects Alchemy owns. Distilled `projects.items` plus the
+ * physical-name filter — Railway has no tags. No lock, no retry override.
+ */
+export const ownedProjects = Effect.fn(function* () {
+    const workspaceId = yield* currentWorkspaceId();
+    const projects = yield* railway.projects
+        .items({ workspaceId, first: 50, includeDeleted: false })
+        .pipe(Stream.runCollect);
+    return Array.from(projects)
+        .filter((project) => !isGone(project) && matchesAlchemyPhysicalName(project.name))
+        .map((project) => toAttrs(project, { workspaceId }));
+});
+export const listOwnedProjects = ownedProjects;
+/**
+ * Live environment ids under a project, including the stamped primary.
+ * `list()` walks these so partition environments are not invisible.
+ */
+export const projectEnvironmentIds = (project) => railway.environments.items({ projectId: project.projectId, first: 50 }).pipe(Stream.filter((env) => env.deletedAt == null), Stream.map((env) => env.id), Stream.runCollect, Effect.map((ids) => {
+    const set = new Set(Array.from(ids));
+    if (project.environmentId.length > 0) {
+        set.add(project.environmentId);
+    }
+    return Array.from(set);
+}), Effect.catchTag(["RailwayNotFound", "NotFound"], () => Effect.succeed(project.environmentId.length > 0 ? [project.environmentId] : [])));
+export const ProjectProvider = () => Provider.succeed(Project, {
+    stables: ["projectId", "workspaceId", "environmentId"],
+    diff: Effect.fn(function* ({ news, output }) {
+        if (news === undefined || !isResolved(news))
+            return undefined;
+        if (output === undefined)
+            return undefined;
+        const workspaceChanged = news.workspaceId !== undefined &&
+            news.workspaceId !== output.workspaceId;
+        if (workspaceChanged) {
+            return { action: "replace" };
+        }
+        return undefined;
+    }),
+    read: Effect.fn(function* ({ id, olds, output }) {
+        const name = yield* resolveName(id, olds?.name, output?.name);
+        const workspaceId = output?.workspaceId ??
+            olds?.workspaceId ??
+            (yield* currentWorkspaceId());
+        const found = (output?.projectId !== undefined
+            ? yield* getById(output.projectId)
+            : undefined) ?? (yield* findByName(workspaceId, name));
+        if (found === undefined)
+            return undefined;
+        const attrs = yield* fillEnvironmentId(toAttrs(found, {
+            name,
+            workspaceId,
+            environmentId: output?.environmentId,
+        }));
+        if (output !== undefined)
+            return attrs;
+        return matchesAlchemyPhysicalName(found.name) ? attrs : Unowned(attrs);
+    }),
+    list: listOwnedProjects,
+    reconcile: Effect.fn(function* ({ id, news, output }) {
+        const props = news ?? {};
+        const name = yield* resolveName(id, props.name, output?.name);
+        const workspaceId = props.workspaceId ??
+            output?.workspaceId ??
+            (yield* currentWorkspaceId());
+        let current = output?.projectId !== undefined
+            ? yield* getById(output.projectId)
+            : undefined;
+        if (current === undefined) {
+            current = yield* findByName(workspaceId, name);
+        }
+        if (current === undefined) {
+            const created = yield* createProject({
+                name,
+                workspaceId,
+                ...(props.description !== undefined
+                    ? { description: props.description }
+                    : {}),
+                ...(props.defaultEnvironmentName !== undefined
+                    ? { defaultEnvironmentName: props.defaultEnvironmentName }
+                    : {}),
+            }).pipe(Effect.catchTag("RailwayValidationError", () => Effect.succeed(undefined)));
+            current = created ?? (yield* findByName(workspaceId, name));
+        }
+        if (current === undefined || isGone(current)) {
+            return yield* new ProjectNotCreated({ name });
+        }
+        const nameChanged = current.name !== name;
+        const observedDescription = current.description ?? undefined;
+        const descriptionChanged = props.description !== undefined &&
+            props.description !== observedDescription;
+        if (nameChanged || descriptionChanged) {
+            current = yield* railway.projectUpdate({
+                id: current.id,
+                input: {
+                    ...(nameChanged ? { name } : {}),
+                    ...(descriptionChanged ? { description: props.description } : {}),
+                },
+            });
+        }
+        return yield* fillEnvironmentId(toAttrs(current, {
+            name,
+            workspaceId,
+            environmentId: output?.environmentId,
+        }));
+    }),
+    delete: Effect.fn(function* ({ output }) {
+        const projectId = output.projectId;
+        if (projectId.length === 0)
+            return;
+        yield* railway
+            .projectDelete({ id: projectId })
+            .pipe(Effect.catchTag(["RailwayNotFound", "NotFound"], () => Effect.void));
+        yield* getById(projectId).pipe(Effect.map((project) => project === undefined), Effect.repeat({
+            schedule: Schedule.spaced("1 second"),
+            until: (gone) => gone,
+            times: 8,
+        }));
+    }),
+});
+//# sourceMappingURL=Project.js.map

package/lib/Railway/Project.js.map

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

package/lib/Railway/ProjectEnvironment.d.ts

@@ -0,0 +1,127 @@
+import * as railway from "@distilled.cloud/railway";
+import * as Effect from "effect/Effect";
+import * as Provider from "../Provider.ts";
+import { Resource } from "../Resource.ts";
+import { type Project } from "./Project.ts";
+import type { Providers } from "./Providers.ts";
+/**
+ * A resource-valued prop: the resource itself, or an Effect that produces
+ * it (so `yield* Project(...)` and `Project(...)` both type-check).
+ */
+type Ref<T> = T | Effect.Effect<T, never, Providers>;
+export interface EnvironmentProps {
+    /**
+     * Parent Railway Project. Accepts a `Railway.Project` resource or an
+     * Effect that produces one. Changing it replaces the Environment.
+     */
+    project: Ref<Project>;
+    /**
+     * Environment name. Unique per project. If omitted, a unique name is
+     * generated from the stack, stage and logical ID. Changing it updates
+     * the environment in place via `environmentRename`.
+     */
+    name?: string;
+    /**
+     * Fork this environment from an existing one (`sourceEnvironmentId`).
+     * Create-only; ignored on update. Pass the project's `environmentId` to
+     * copy production's services, volumes, and variables.
+     */
+    sourceEnvironmentId?: string;
+}
+export type Environment = Resource<"Railway.Environment", EnvironmentProps, {
+    /** Railway environment id. */
+    environmentId: string;
+    /** Physical environment name (unique per project). */
+    name: string;
+    /** Parent Railway project id. */
+    projectId: string;
+    /** Whether this is an ephemeral (PR) environment. */
+    isEphemeral: boolean;
+    /** Dashboard URL for this environment. */
+    url: string;
+}, never, Providers>;
+declare const EnvironmentResource: import("../Resource.ts").ResourceClass<Environment>;
+/**
+ * A Railway.Environment is an extra deploy environment under a Project
+ * (staging, preview, …). The production environment is created with the
+ * Project — do not recreate it as an Environment resource.
+ *
+ * @see https://docs.railway.com/guides/environments
+ *
+ * ### Create an extra environment
+ * Alchemy generates a unique name unless you pass one. Production is
+ * already on the Project as `environmentId`.
+ *
+ * **Example:** Staging next to production
+ * ```typescript
+ * const site = yield* Railway.Project("Site");
+ * const staging = yield* Railway.Environment("Staging", {
+ *   project: site,
+ * });
+ * ```
+ *
+ * :::note
+ * Prefer omitting `name` in tests and CI so names stay unique and
+ * reclaimable.
+ * :::
+ *
+ * ### A stable name
+ * Pass `name` when you need a stable environment name (`staging`).
+ * Changing it later updates the environment in place.
+ *
+ * **Example:** Explicit name
+ * ```typescript
+ * const staging = yield* Railway.Environment("Staging", {
+ *   project: site,
+ *   name: "staging",
+ * });
+ * ```
+ *
+ * ### Fork from production
+ * `sourceEnvironmentId` copies services, volumes, configuration, and
+ * variables from another environment. Create-only.
+ *
+ * **Example:** Fork production
+ * ```typescript
+ * const staging = yield* Railway.Environment("Staging", {
+ *   project: site,
+ *   sourceEnvironmentId: site.environmentId,
+ * });
+ * ```
+ *
+ * ### Module-scope declarations
+ * Declare the Project once. Pass it into every child. Resource-valued
+ * props accept the resource or an Effect producing it.
+ *
+ * **Example:** Module-scope Environment
+ * ```typescript
+ * // src/project.ts
+ * import * as Railway from "alchemy/Railway";
+ *
+ * export const Site = Railway.Project("Site");
+ * export const Staging = Railway.Environment("Staging", {
+ *   project: Site,
+ * });
+ * ```
+ *
+ * @resource
+ */
+export declare const Environment: typeof EnvironmentResource;
+declare const EnvironmentNotCreated_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Railway.EnvironmentNotCreated";
+} & Readonly<A>;
+export declare class EnvironmentNotCreated extends EnvironmentNotCreated_base<{
+    name: string;
+    projectId: string;
+}> {
+}
+declare const EnvironmentProjectRequired_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Railway.EnvironmentProjectRequired";
+} & Readonly<A>;
+export declare class EnvironmentProjectRequired extends EnvironmentProjectRequired_base<{
+    message: string;
+}> {
+}
+export declare const EnvironmentProvider: () => import("effect/Layer").Layer<Provider.Provider<Environment>, never, import("./Environment.ts").RailwayEnvironment | import("../Stack.ts").Stack | import("../Stage.ts").Stage | railway.RailwayOpContext>;
+export {};
+//# sourceMappingURL=ProjectEnvironment.d.ts.map

package/lib/Railway/ProjectEnvironment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectEnvironment.d.ts","sourceRoot":"","sources":["../../src/Railway/ProjectEnvironment.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,OAAO,MAAM,0BAA0B,CAAC;AAEpD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAM1C,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD;;;GAGG;AACH,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACtB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,CAChC,qBAAqB,EACrB,gBAAgB,EAChB;IACE,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,WAAW,EAAE,OAAO,CAAC;IACrB,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;CACb,EACD,KAAK,EACL,SAAS,CACV,CAAC;AAEF,QAAA,MAAM,mBAAmB,qDAA+C,CAAC;AAczE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,eAAO,MAAM,WAAW,EAAE,OAAO,mBAMhC,CAAC;;;;AAEF,qBAAa,qBAAsB,SAAQ,2BAEzC;IACA,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;CAAG;;;;AAEL,qBAAa,0BAA2B,SAAQ,gCAE9C;IACA,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;CAAG;AA0EL,eAAO,MAAM,mBAAmB,iNAoI5B,CAAC"}