@chief-clancy/core 0.1.0

package/dist/board/jira/jira-board.js

@@ -0,0 +1,112 @@
+import { buildAuthHeader, fetchTickets, isSafeJqlValue, pingJira, transitionIssue, } from './api/index.js';
+import { addLabel, removeLabel } from './labels/index.js';
+import { fetchBlockerStatus, fetchChildrenStatus } from './relations/index.js';
+/** Map a JiraTicket to the normalised FetchedTicket shape. */
+function toFetchedTicket(ticket, statusName) {
+    const blockerStr = ticket.blockers.length
+        ? `Blocked by: ${ticket.blockers.join(', ')}`
+        : 'None';
+    return {
+        key: ticket.key,
+        title: ticket.title,
+        description: ticket.description,
+        parentInfo: ticket.epicKey ?? 'none',
+        blockers: blockerStr,
+        issueId: ticket.key,
+        labels: ticket.labels ?? [],
+        status: statusName,
+    };
+}
+/** Validate JQL-interpolated env values. */
+function validateJqlInputs(env) {
+    if (!isSafeJqlValue(env.JIRA_PROJECT_KEY)) {
+        return '✗ JIRA_PROJECT_KEY contains invalid characters';
+    }
+    if (env.CLANCY_LABEL && !isSafeJqlValue(env.CLANCY_LABEL)) {
+        return '✗ CLANCY_LABEL contains invalid characters';
+    }
+    if (env.CLANCY_JQL_STATUS && !isSafeJqlValue(env.CLANCY_JQL_STATUS)) {
+        return '✗ CLANCY_JQL_STATUS contains invalid characters';
+    }
+    return undefined;
+}
+/** Fetch and normalise Jira tickets into FetchedTickets. */
+async function fetchJiraTickets(ctx, opts, env) {
+    const tickets = await fetchTickets({
+        baseUrl: ctx.baseUrl,
+        auth: ctx.auth,
+        projectKey: ctx.projectKey,
+        status: ctx.statusName,
+        sprint: env.CLANCY_JQL_SPRINT,
+        label: opts.buildLabel ?? env.CLANCY_LABEL,
+        excludeHitl: opts.excludeHitl,
+        fetcher: ctx.fetcher,
+    });
+    return tickets.map((t) => toFetchedTicket(t, ctx.statusName));
+}
+/** Transition a Jira issue and log on success. */
+async function doTransition(ctx, ticket, status) {
+    const ok = await transitionIssue({
+        baseUrl: ctx.baseUrl,
+        auth: ctx.auth,
+        issueKey: ticket.key,
+        statusName: status,
+        fetcher: ctx.fetcher,
+    });
+    if (ok)
+        console.log(`  → Transitioned to ${status}`);
+    return ok;
+}
+/**
+ * Create a Board implementation for Jira.
+ *
+ * @param env - The validated Jira environment variables.
+ * @param fetcher - Optional custom fetch function for DI in tests.
+ * @returns A Board object that delegates to Jira API functions.
+ */
+export function createJiraBoard(env, fetcher) {
+    const ctx = {
+        baseUrl: env.JIRA_BASE_URL,
+        auth: buildAuthHeader(env.JIRA_USER, env.JIRA_API_TOKEN),
+        projectKey: env.JIRA_PROJECT_KEY,
+        statusName: env.CLANCY_JQL_STATUS ?? 'To Do',
+        fetcher,
+    };
+    const labelCtx = {
+        baseUrl: ctx.baseUrl,
+        auth: ctx.auth,
+        fetcher: ctx.fetcher,
+    };
+    const doFetch = (opts) => fetchJiraTickets(ctx, opts, env);
+    return {
+        ping: () => pingJira({
+            baseUrl: ctx.baseUrl,
+            projectKey: ctx.projectKey,
+            auth: ctx.auth,
+            fetcher: ctx.fetcher,
+        }),
+        validateInputs: () => validateJqlInputs(env),
+        fetchTicket: async (opts) => (await doFetch(opts))[0],
+        fetchTickets: doFetch,
+        fetchBlockerStatus: (ticket) => fetchBlockerStatus({
+            baseUrl: ctx.baseUrl,
+            auth: ctx.auth,
+            key: ticket.key,
+            fetcher: ctx.fetcher,
+        }),
+        fetchChildrenStatus: (parentKey) => fetchChildrenStatus({
+            baseUrl: ctx.baseUrl,
+            auth: ctx.auth,
+            parentKey,
+            fetcher: ctx.fetcher,
+        }),
+        transitionTicket: (ticket, status) => doTransition(ctx, ticket, status),
+        ensureLabel: async () => {
+            // No-op — Jira auto-creates labels on use.
+        },
+        addLabel: (issueKey, label) => addLabel(labelCtx, issueKey, label),
+        removeLabel: (issueKey, label) => removeLabel(labelCtx, issueKey, label),
+        sharedEnv: () => env,
+    };
+}
+//# sourceMappingURL=jira-board.js.map

package/dist/board/jira/jira-board.js.map

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

package/dist/board/jira/labels/index.d.ts

@@ -0,0 +1,2 @@
+export { addLabel, removeLabel } from './labels.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/board/jira/labels/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/board/jira/labels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/board/jira/labels/index.js

@@ -0,0 +1,2 @@
+export { addLabel, removeLabel } from './labels.js';
+//# sourceMappingURL=index.js.map

package/dist/board/jira/labels/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/board/jira/labels/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/board/jira/labels/labels.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Jira issue label operations.
+ *
+ * Uses read-modify-write via {@link modifyLabelList} because Jira's
+ * label API requires reading the current labels and writing the full
+ * list back. Wrapped in {@link safeLabel} for best-effort error handling.
+ */
+import type { Fetcher } from '../../../shared/http/index.js';
+/** Context for Jira label operations. */
+type JiraLabelContext = {
+    readonly baseUrl: string;
+    readonly auth: string;
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Add a label to a Jira issue (best-effort).
+ *
+ * @param ctx - Jira connection context.
+ * @param issueKey - The Jira issue key.
+ * @param label - The label to add.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export declare function addLabel(ctx: JiraLabelContext, issueKey: string, label: string): Promise<void>;
+/**
+ * Remove a label from a Jira issue (best-effort).
+ *
+ * @param ctx - Jira connection context.
+ * @param issueKey - The Jira issue key.
+ * @param label - The label to remove.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export declare function removeLabel(ctx: JiraLabelContext, issueKey: string, label: string): Promise<void>;
+export {};
+//# sourceMappingURL=labels.d.ts.map

package/dist/board/jira/labels/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../../src/board/jira/labels/labels.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAOxD,yCAAyC;AACzC,KAAK,gBAAgB,GAAG;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AA4CF;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAWf;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/board/jira/labels/labels.js

@@ -0,0 +1,69 @@
+import { jiraIssueLabelsResponseSchema } from '../../../schemas/index.js';
+import { modifyLabelList, safeLabel } from '../../../shared/label-helpers/index.js';
+import { isValidIssueKey, jiraHeaders } from '../api/index.js';
+/** Fetch current labels for a Jira issue. */
+async function fetchLabels(ctx, issueKey) {
+    const doFetch = ctx.fetcher ?? fetch;
+    const res = await doFetch(`${ctx.baseUrl}/rest/api/3/issue/${encodeURIComponent(issueKey)}?fields=labels`, { headers: jiraHeaders(ctx.auth) });
+    if (!res.ok) {
+        console.warn(`⚠ label GET ${issueKey} failed: HTTP ${res.status}`);
+        return undefined;
+    }
+    const parsed = jiraIssueLabelsResponseSchema.safeParse(await res.json());
+    if (!parsed.success)
+        return undefined;
+    return parsed.data.fields?.labels ?? [];
+}
+/** Write updated labels to a Jira issue. */
+async function writeLabels(ctx, issueKey, labels) {
+    const doFetch = ctx.fetcher ?? fetch;
+    const res = await doFetch(`${ctx.baseUrl}/rest/api/3/issue/${encodeURIComponent(issueKey)}`, {
+        method: 'PUT',
+        headers: { ...jiraHeaders(ctx.auth), 'Content-Type': 'application/json' },
+        body: JSON.stringify({ fields: { labels } }),
+    });
+    if (!res.ok) {
+        console.warn(`⚠ label PUT ${issueKey} returned HTTP ${res.status}`);
+    }
+}
+/**
+ * Add a label to a Jira issue (best-effort).
+ *
+ * @param ctx - Jira connection context.
+ * @param issueKey - The Jira issue key.
+ * @param label - The label to add.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export async function addLabel(ctx, issueKey, label) {
+    await safeLabel(async () => {
+        if (!isValidIssueKey(issueKey))
+            return;
+        await modifyLabelList({
+            fetchCurrent: () => fetchLabels(ctx, issueKey),
+            writeUpdated: (labels) => writeLabels(ctx, issueKey, labels),
+            target: label,
+            mode: 'add',
+        });
+    }, 'addLabel');
+}
+/**
+ * Remove a label from a Jira issue (best-effort).
+ *
+ * @param ctx - Jira connection context.
+ * @param issueKey - The Jira issue key.
+ * @param label - The label to remove.
+ * @returns Resolves when complete (best-effort — never throws).
+ */
+export async function removeLabel(ctx, issueKey, label) {
+    await safeLabel(async () => {
+        if (!isValidIssueKey(issueKey))
+            return;
+        await modifyLabelList({
+            fetchCurrent: () => fetchLabels(ctx, issueKey),
+            writeUpdated: (labels) => writeLabels(ctx, issueKey, labels),
+            target: label,
+            mode: 'remove',
+        });
+    }, 'removeLabel');
+}
+//# sourceMappingURL=labels.js.map

package/dist/board/jira/labels/labels.js.map

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

package/dist/board/jira/relations/index.d.ts

@@ -0,0 +1,2 @@
+export { fetchBlockerStatus, fetchChildrenStatus } from './relations.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/board/jira/relations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/board/jira/relations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/board/jira/relations/index.js

@@ -0,0 +1,2 @@
+export { fetchBlockerStatus, fetchChildrenStatus } from './relations.js';
+//# sourceMappingURL=index.js.map

package/dist/board/jira/relations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/board/jira/relations/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/board/jira/relations/relations.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Jira issue relationship functions.
+ *
+ * Checks blocker status (via issue links) and children status
+ * (via Epic: text convention + native parent JQL).
+ */
+import type { Fetcher } from '../../../shared/http/index.js';
+import type { ChildrenStatus } from '../../../types/index.js';
+/** Options for {@link fetchBlockerStatus}. */
+type FetchBlockerOpts = {
+    readonly baseUrl: string;
+    readonly auth: string;
+    readonly key: string;
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Check whether a Jira issue is blocked by unresolved blockers.
+ *
+ * Fetches the issue's links and checks for inward "Blocks"
+ * relationships where the blocking issue is not done.
+ *
+ * @param opts - Connection details and issue key.
+ * @returns `true` if any blocker is unresolved, `false` otherwise.
+ */
+export declare function fetchBlockerStatus(opts: FetchBlockerOpts): Promise<boolean>;
+/** Options for {@link fetchChildrenStatus}. */
+type FetchChildrenOpts = {
+    readonly baseUrl: string;
+    readonly auth: string;
+    readonly parentKey: string;
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Fetch the children status of a Jira epic (dual-mode).
+ *
+ * Tries the `Epic: {key}` text convention first. Falls back to
+ * the native `parent = {key}` JQL for backward compatibility.
+ *
+ * @param opts - Connection details and parent issue key.
+ * @returns The children status, or `undefined` on failure.
+ */
+export declare function fetchChildrenStatus(opts: FetchChildrenOpts): Promise<ChildrenStatus | undefined>;
+export {};
+//# sourceMappingURL=relations.d.ts.map

package/dist/board/jira/relations/relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.d.ts","sourceRoot":"","sources":["../../../../src/board/jira/relations/relations.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AASzD,8CAA8C;AAC9C,KAAK,gBAAgB,GAAG;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,OAAO,CAAC,CA+BlB;AAED,+CAA+C;AAC/C,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAwBrC"}

package/dist/board/jira/relations/relations.js

@@ -0,0 +1,111 @@
+import { jiraIssueLinksResponseSchema } from '../../../schemas/index.js';
+import { z } from 'zod/mini';
+import { isValidIssueKey, jiraHeaders } from '../api/index.js';
+const jiraSearchCountSchema = z.object({ total: z.optional(z.number()) });
+/**
+ * Check whether a Jira issue is blocked by unresolved blockers.
+ *
+ * Fetches the issue's links and checks for inward "Blocks"
+ * relationships where the blocking issue is not done.
+ *
+ * @param opts - Connection details and issue key.
+ * @returns `true` if any blocker is unresolved, `false` otherwise.
+ */
+export async function fetchBlockerStatus(opts) {
+    const { baseUrl, auth, key, fetcher } = opts;
+    if (!isValidIssueKey(key))
+        return false;
+    const doFetch = fetcher ?? fetch;
+    try {
+        const response = await doFetch(`${baseUrl}/rest/api/3/issue/${key}?fields=issuelinks`, { headers: jiraHeaders(auth) });
+        if (!response.ok)
+            return false;
+        const json = await response.json();
+        const parsed = jiraIssueLinksResponseSchema.safeParse(json);
+        if (!parsed.success)
+            return false;
+        const links = parsed.data.fields?.issuelinks ?? [];
+        return links.some((link) => {
+            if (link.type?.name !== 'Blocks')
+                return false;
+            if (!link.inwardIssue?.key)
+                return false;
+            const categoryKey = link.inwardIssue.fields?.status?.statusCategory?.key;
+            return categoryKey ? categoryKey !== 'done' : false;
+        });
+    }
+    catch (err) {
+        console.warn(`⚠ fetchBlockerStatus failed: ${err instanceof Error ? err.message : String(err)}`);
+        return false;
+    }
+}
+/**
+ * Fetch the children status of a Jira epic (dual-mode).
+ *
+ * Tries the `Epic: {key}` text convention first. Falls back to
+ * the native `parent = {key}` JQL for backward compatibility.
+ *
+ * @param opts - Connection details and parent issue key.
+ * @returns The children status, or `undefined` on failure.
+ */
+export async function fetchChildrenStatus(opts) {
+    const { baseUrl, auth, parentKey, fetcher } = opts;
+    if (!isValidIssueKey(parentKey))
+        return undefined;
+    try {
+        const projectPrefix = parentKey.split('-')[0];
+        const shared = { baseUrl, auth, fetcher };
+        const epicResult = await fetchChildrenByJql({
+            ...shared,
+            jql: `project = "${projectPrefix}" AND description ~ "Epic: ${parentKey}"`,
+        });
+        if (epicResult && epicResult.total > 0)
+            return epicResult;
+        return await fetchChildrenByJql({
+            ...shared,
+            jql: `parent = ${parentKey}`,
+        });
+    }
+    catch (err) {
+        console.warn(`⚠ fetchChildrenStatus failed: ${err instanceof Error ? err.message : String(err)}`);
+        return undefined;
+    }
+}
+/** Fetch children status using a JQL query. */
+async function fetchChildrenByJql(opts) {
+    const { baseUrl, auth, jql, fetcher } = opts;
+    const headers = {
+        ...jiraHeaders(auth),
+        'Content-Type': 'application/json',
+    };
+    const doFetch = fetcher ?? fetch;
+    const totalResponse = await doFetch(`${baseUrl}/rest/api/3/search/jql`, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify({ jql, maxResults: 0 }),
+    });
+    if (!totalResponse.ok)
+        return undefined;
+    const totalParsed = jiraSearchCountSchema.safeParse(await totalResponse.json());
+    if (!totalParsed.success)
+        return undefined;
+    const total = totalParsed.data.total ?? 0;
+    if (total === 0)
+        return { total: 0, incomplete: 0 };
+    const incompleteResponse = await doFetch(`${baseUrl}/rest/api/3/search/jql`, {
+        method: 'POST',
+        headers,
+        body: JSON.stringify({
+            jql: `${jql} AND statusCategory != "done"`,
+            maxResults: 0,
+        }),
+    });
+    if (!incompleteResponse.ok)
+        return undefined;
+    const incParsed = jiraSearchCountSchema.safeParse(await incompleteResponse.json());
+    return {
+        total,
+        incomplete: incParsed.success ? (incParsed.data.total ?? 0) : total,
+    };
+}
+//# sourceMappingURL=relations.js.map

package/dist/board/jira/relations/relations.js.map

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

package/dist/board/linear/api/api.d.ts

@@ -0,0 +1,68 @@
+import type { Fetcher } from '../../../shared/http/index.js';
+import type { PingResult } from '../../../types/index.js';
+/**
+ * Build standard Linear API request headers.
+ *
+ * Personal API keys do NOT use "Bearer" prefix — only OAuth tokens do.
+ *
+ * @param apiKey - The Linear personal API key.
+ * @returns Headers object for Linear GraphQL requests.
+ */
+export declare function linearHeaders(apiKey: string): Record<string, string>;
+/**
+ * Validate that a team ID is safe for use in GraphQL variables.
+ *
+ * @param teamId - The Linear team ID to validate.
+ * @returns `true` if the ID matches the safe pattern.
+ */
+export declare function isValidTeamId(teamId: string): boolean;
+/** Options for {@link linearGraphql}. */
+type LinearGraphqlOpts = {
+    readonly apiKey: string;
+    readonly query: string;
+    readonly variables?: Record<string, unknown>;
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Make a GraphQL request to the Linear API.
+ *
+ * @param opts - API key, query, optional variables, and optional fetcher.
+ * @returns The raw JSON response, or `undefined` on failure.
+ */
+export declare function linearGraphql(opts: LinearGraphqlOpts): Promise<unknown>;
+/**
+ * Ping the Linear API to verify connectivity and credentials.
+ *
+ * @param apiKey - The Linear personal API key.
+ * @param fetcher - Optional custom fetch function for DI in tests.
+ * @returns Ping result with `ok` and optional `error`.
+ */
+export declare function pingLinear(apiKey: string, fetcher?: Fetcher): Promise<PingResult>;
+/** Linear ticket with issue ID, optional parent info, and labels. */
+type LinearTicket = {
+    readonly key: string;
+    readonly title: string;
+    readonly description: string;
+    readonly provider: 'linear';
+    readonly issueId: string;
+    readonly parentIdentifier?: string;
+    readonly labels?: readonly string[];
+};
+/** Options for {@link fetchIssues}. */
+type FetchIssuesOpts = {
+    readonly apiKey: string;
+    readonly teamId: string;
+    readonly label?: string;
+    readonly excludeHitl?: boolean;
+    readonly limit?: number;
+    readonly fetcher?: Fetcher;
+};
+/**
+ * Fetch candidate issues from Linear.
+ *
+ * @param opts - API key, team ID, and optional filters.
+ * @returns Array of fetched tickets (may be empty).
+ */
+export declare function fetchIssues(opts: FetchIssuesOpts): Promise<readonly LinearTicket[]>;
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/board/linear/api/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../src/board/linear/api/api.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAYrD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKpE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErD;AAeD,yCAAyC;AACzC,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CA0B7E;AAUD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,UAAU,CAAC,CAqBrB;AAED,qEAAqE;AACrE,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAiBF,uCAAuC;AACvC,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AA4DF;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAoBlC"}