openplanr 1.2.8 → 1.4.0

package/dist/services/linear/estimate-resolver.js

@@ -0,0 +1,82 @@
+/**
+ * Scale-aware snapping from OpenPlanr `storyPoints` → Linear `estimate` field.
+ *
+ * Linear's estimate field is numeric and must match the team's configured
+ * scale (`fibonacci`, `linear`, `exponential`, or `tShirt`). A value that
+ * isn't on the scale is rejected by the API, so we snap to the nearest
+ * allowed value before sending. Callers use the returned snap event to emit
+ * a debug log once per transformation.
+ *
+ * Scales mirror Linear's own SDK values — see `LinearIssueEstimationType`
+ * in `src/models/types.ts`.
+ */
+const FIBONACCI_SCALE = [0, 1, 2, 3, 5, 8, 13, 21];
+const LINEAR_SCALE = [0, 1, 2, 3, 4, 5];
+const EXPONENTIAL_SCALE = [0, 1, 2, 4, 8, 16];
+function snapToNearest(value, scale) {
+    let best = scale[0];
+    let bestDistance = Math.abs(value - best);
+    for (const candidate of scale) {
+        const distance = Math.abs(value - candidate);
+        // Break ties toward the larger value — under-estimating is a common
+        // planning bias; snapping up ("4 is really a 5") leans against it.
+        if (distance < bestDistance || (distance === bestDistance && candidate > best)) {
+            best = candidate;
+            bestDistance = distance;
+        }
+    }
+    return best;
+}
+/**
+ * Resolve a local `storyPoints` (or `estimatedPoints`) value to a Linear
+ * `estimate` value given the team's scale.
+ *
+ * Precedence for the raw local value:
+ *   1. `frontmatter.estimatedPoints` — canonical name written by
+ *      `planr estimate --save` (see `src/cli/commands/estimate.ts`).
+ *   2. `frontmatter.storyPoints` — alias accepted for hand-edited files or
+ *      direct AI-response copies that used the schema field name verbatim.
+ *
+ * Returns one of:
+ *   - `mapped` — include `estimate: <value>` in the push input
+ *   - `skip-*` — omit the `estimate` field; `kind` carries the reason for
+ *      logging / dry-run display
+ */
+export function resolveEstimateForPush(frontmatter, scale) {
+    if (scale === 'notUsed' || !scale) {
+        return { kind: 'skip-not-used' };
+    }
+    if (scale === 'tShirt') {
+        // No safe numeric → XS/S/M/L/XL mapping without user config. Skip.
+        return { kind: 'skip-t-shirt' };
+    }
+    const rawLocal = frontmatter.estimatedPoints !== undefined
+        ? frontmatter.estimatedPoints
+        : frontmatter.storyPoints;
+    if (rawLocal === undefined || rawLocal === null || rawLocal === '') {
+        return { kind: 'skip-no-local-value' };
+    }
+    const parsed = typeof rawLocal === 'number' ? rawLocal : Number(rawLocal);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        return { kind: 'skip-invalid-value', rawValue: rawLocal };
+    }
+    const allowed = scale === 'fibonacci'
+        ? FIBONACCI_SCALE
+        : scale === 'linear'
+            ? LINEAR_SCALE
+            : scale === 'exponential'
+                ? EXPONENTIAL_SCALE
+                : undefined;
+    if (!allowed) {
+        // Unknown scale value returned by Linear — skip rather than guess.
+        return { kind: 'skip-not-used' };
+    }
+    const snapped = snapToNearest(parsed, allowed);
+    return {
+        kind: 'mapped',
+        estimate: snapped,
+        originalValue: parsed,
+        snapped: snapped !== parsed,
+    };
+}
+//# sourceMappingURL=estimate-resolver.js.map

package/dist/services/linear/estimate-resolver.js.map

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

package/dist/services/linear/plan-builders.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Pure plan-building for `planr linear push --dry-run`. Takes loaded scopes
+ * and returns `LinearPushPlan` objects with per-kind row counts. No Linear
+ * API calls; no mutations. Epic-scope plans cascade rows for linked QT/BL.
+ */
+import type { Epic, Feature, OpenPlanrConfig, UserStory } from '../../models/types.js';
+import { type ScopedFeature, type ScopedTaskFile } from './scope-loaders.js';
+export type LinearPushItemKind = 'project' | 'feature' | 'story' | 'taskList' | 'quickTask' | 'backlogItem';
+export type LinearPushAction = 'create' | 'update' | 'skip';
+/** Scope of a granular push — what subtree `runLinearPush(artifactId)` touches. */
+export type LinearPushScope = 'epic' | 'feature' | 'story' | 'taskFile' | 'quick' | 'backlog';
+export interface LinearPushPlanRow {
+    kind: LinearPushItemKind;
+    /** Epic id, feature id, story id, or task-file id for this row. */
+    artifactId: string;
+    title: string;
+    action: LinearPushAction;
+    detail?: string;
+}
+export interface LinearPushPlan {
+    /** The artifact the user pointed `planr linear push` at (any supported prefix). */
+    rootArtifactId: string;
+    /** The epic that owns this push's subtree; `undefined` for standalone QT/BL pushes. */
+    epicId?: string;
+    scope: LinearPushScope;
+    rows: LinearPushPlanRow[];
+    /** Counts by kind for non-`skip` rows. Missing kinds are 0. */
+    counts: {
+        project: number;
+        features: number;
+        stories: number;
+        taskLists: number;
+        quickTasks: number;
+        backlogItems: number;
+        total: number;
+    };
+}
+/**
+ * Extract the linked epic id from QT / BL frontmatter. Canonical field is
+ * `epicId`; `parentEpic` is accepted as a compat alias for hand-authored
+ * files. Empty strings are normalised to `undefined`.
+ */
+export declare function getLinkedEpicId(fm: Record<string, unknown>): string | undefined;
+export declare function projectRow(epic: Epic): LinearPushPlanRow;
+export declare function featureRow(f: Feature): LinearPushPlanRow;
+export declare function storyRow(s: UserStory): LinearPushPlanRow;
+export declare function taskListPlanRow(featureId: string, taskFiles: ScopedTaskFile[], hasBody: boolean, hadIssue: boolean): LinearPushPlanRow;
+export declare function applyUpdateOnly(rows: LinearPushPlanRow[], updateOnly: boolean): LinearPushPlanRow[];
+export declare function summarizePlan(rootArtifactId: string, epicId: string | undefined, scope: LinearPushScope, rows: LinearPushPlanRow[]): LinearPushPlan;
+export declare function buildFeaturePlanRows(projectDir: string, config: OpenPlanrConfig, sf: ScopedFeature): Promise<LinearPushPlanRow[]>;
+export declare function buildEpicPlanRows(projectDir: string, config: OpenPlanrConfig, epicScope: {
+    epic: Epic;
+    features: ScopedFeature[];
+}): Promise<LinearPushPlanRow[]>;
+/**
+ * Build a push preview (and counts) for `planr linear push --dry-run` at any
+ * granularity. Accepts any supported artifact id prefix (EPIC/FEAT/US/TASK/
+ * QT/BL); returns `null` when the artifact can't be resolved or is not
+ * pushable (ADR/SPRINT/checklist).
+ */
+export declare function buildLinearPushPlan(projectDir: string, config: OpenPlanrConfig, artifactId: string, options?: {
+    updateOnly?: boolean;
+}): Promise<LinearPushPlan | null>;
+//# sourceMappingURL=plan-builders.d.ts.map

package/dist/services/linear/plan-builders.d.ts.map

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

package/dist/services/linear/plan-builders.js

@@ -0,0 +1,237 @@
+/**
+ * Pure plan-building for `planr linear push --dry-run`. Takes loaded scopes
+ * and returns `LinearPushPlan` objects with per-kind row counts. No Linear
+ * API calls; no mutations. Epic-scope plans cascade rows for linked QT/BL.
+ */
+import { findArtifactTypeById, listArtifacts, readArtifact } from '../artifact-service.js';
+import { buildMergedTaskListBody, toOptionalString } from './body-formatters.js';
+import { loadForBacklogItem, loadForFeature, loadForQuickTask, loadForStory, loadForTaskFile, loadLinearPushScope, } from './scope-loaders.js';
+/**
+ * Extract the linked epic id from QT / BL frontmatter. Canonical field is
+ * `epicId`; `parentEpic` is accepted as a compat alias for hand-authored
+ * files. Empty strings are normalised to `undefined`.
+ */
+export function getLinkedEpicId(fm) {
+    return toOptionalString(fm.epicId) ?? toOptionalString(fm.parentEpic);
+}
+function sortByArtifactId(a, b) {
+    return a.id.localeCompare(b.id, undefined, { numeric: true });
+}
+// ---------------------------------------------------------------------------
+// Per-kind row builders
+// ---------------------------------------------------------------------------
+export function projectRow(epic) {
+    const id = epic.linearProjectId;
+    return {
+        kind: 'project',
+        artifactId: epic.id,
+        title: epic.title.trim() || epic.id,
+        action: id ? 'update' : 'create',
+    };
+}
+export function featureRow(f) {
+    return {
+        kind: 'feature',
+        artifactId: f.id,
+        title: f.title.trim() || f.id,
+        action: f.linearIssueId ? 'update' : 'create',
+    };
+}
+export function storyRow(s) {
+    return {
+        kind: 'story',
+        artifactId: s.id,
+        title: s.title.trim() || s.id,
+        action: s.linearIssueId ? 'update' : 'create',
+    };
+}
+export function taskListPlanRow(featureId, taskFiles, hasBody, hadIssue) {
+    if (!hasBody && !hadIssue) {
+        return {
+            kind: 'taskList',
+            artifactId: featureId,
+            title: `Tasks (${featureId})`,
+            action: 'skip',
+            detail: 'No task checkbox lines in task file(s) for this feature.',
+        };
+    }
+    const label = taskFiles[0]?.id ?? featureId;
+    return {
+        kind: 'taskList',
+        artifactId: label,
+        title: `Tasks: ${featureId}`,
+        action: hadIssue ? 'update' : 'create',
+    };
+}
+export function applyUpdateOnly(rows, updateOnly) {
+    if (!updateOnly)
+        return rows;
+    return rows.map((r) => r.action === 'create'
+        ? {
+            ...r,
+            action: 'skip',
+            detail: r.detail
+                ? `${r.detail} (not created: --update-only)`
+                : 'not created: --update-only',
+        }
+        : r);
+}
+export function summarizePlan(rootArtifactId, epicId, scope, rows) {
+    const countKind = (k) => rows.filter((r) => r.kind === k && r.action !== 'skip').length;
+    const project = countKind('project');
+    const features = countKind('feature');
+    const stories = countKind('story');
+    const taskLists = countKind('taskList');
+    const quickTasks = countKind('quickTask');
+    const backlogItems = countKind('backlogItem');
+    return {
+        rootArtifactId,
+        epicId,
+        scope,
+        rows,
+        counts: {
+            project,
+            features,
+            stories,
+            taskLists,
+            quickTasks,
+            backlogItems,
+            total: project + features + stories + taskLists + quickTasks + backlogItems,
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Scope-level row assembly
+// ---------------------------------------------------------------------------
+export async function buildFeaturePlanRows(projectDir, config, sf) {
+    const rows = [];
+    rows.push(featureRow(sf.data));
+    for (const st of sf.stories) {
+        rows.push(storyRow(st.data));
+    }
+    const withLinear = await Promise.all(sf.taskFiles.map(async (tf) => {
+        const a = await readArtifact(projectDir, config, 'task', tf.id);
+        return { tf, issueId: toOptionalString(a?.data.linearIssueId) };
+    }));
+    const hadIssue = Boolean(withLinear.find((x) => x.issueId)?.issueId);
+    const body = await buildMergedTaskListBody(projectDir, config, sf.data.id, sf.taskFiles);
+    const hasBody = body.trim().length > 0;
+    rows.push(taskListPlanRow(sf.data.id, sf.taskFiles, hasBody, hadIssue));
+    return rows;
+}
+export async function buildEpicPlanRows(projectDir, config, epicScope) {
+    const rows = [];
+    rows.push(projectRow(epicScope.epic));
+    for (const sf of epicScope.features) {
+        rows.push(...(await buildFeaturePlanRows(projectDir, config, sf)));
+    }
+    // Linked QT / BL artifacts get their own rows so `--dry-run` matches what
+    // `runLinearPush` would actually touch.
+    const quicks = await listArtifacts(projectDir, config, 'quick');
+    for (const q of quicks.sort(sortByArtifactId)) {
+        const art = await readArtifact(projectDir, config, 'quick', q.id);
+        if (!art || getLinkedEpicId(art.data) !== epicScope.epic.id)
+            continue;
+        const hasId = Boolean(toOptionalString(art.data.linearIssueId));
+        rows.push({
+            kind: 'quickTask',
+            artifactId: q.id,
+            title: art.data.title?.trim() || q.title || q.id,
+            action: hasId ? 'update' : 'create',
+        });
+    }
+    const backlogs = await listArtifacts(projectDir, config, 'backlog');
+    for (const b of backlogs.sort(sortByArtifactId)) {
+        const art = await readArtifact(projectDir, config, 'backlog', b.id);
+        if (!art || getLinkedEpicId(art.data) !== epicScope.epic.id)
+            continue;
+        const hasId = Boolean(toOptionalString(art.data.linearIssueId));
+        rows.push({
+            kind: 'backlogItem',
+            artifactId: b.id,
+            title: art.data.title?.trim() || b.title || b.id,
+            action: hasId ? 'update' : 'create',
+        });
+    }
+    return rows;
+}
+/**
+ * Build a push preview (and counts) for `planr linear push --dry-run` at any
+ * granularity. Accepts any supported artifact id prefix (EPIC/FEAT/US/TASK/
+ * QT/BL); returns `null` when the artifact can't be resolved or is not
+ * pushable (ADR/SPRINT/checklist).
+ */
+export async function buildLinearPushPlan(projectDir, config, artifactId, options) {
+    const updateOnly = options?.updateOnly === true;
+    const type = findArtifactTypeById(artifactId);
+    if (!type)
+        return null;
+    if (type === 'epic') {
+        const scope = await loadLinearPushScope(projectDir, config, artifactId);
+        if (!scope)
+            return null;
+        const rows = applyUpdateOnly(await buildEpicPlanRows(projectDir, config, scope), updateOnly);
+        return summarizePlan(artifactId, scope.epic.id, 'epic', rows);
+    }
+    if (type === 'feature') {
+        const ctx = await loadForFeature(projectDir, config, artifactId);
+        if (!ctx)
+            return null;
+        const rows = applyUpdateOnly(await buildFeaturePlanRows(projectDir, config, ctx.sf), updateOnly);
+        return summarizePlan(artifactId, ctx.epic.id, 'feature', rows);
+    }
+    if (type === 'story') {
+        const ctx = await loadForStory(projectDir, config, artifactId);
+        if (!ctx)
+            return null;
+        const rows = applyUpdateOnly([storyRow(ctx.story.data)], updateOnly);
+        return summarizePlan(artifactId, ctx.epic.id, 'story', rows);
+    }
+    if (type === 'task') {
+        const ctx = await loadForTaskFile(projectDir, config, artifactId);
+        if (!ctx)
+            return null;
+        const withLinear = await Promise.all(ctx.sf.taskFiles.map(async (tf) => {
+            const a = await readArtifact(projectDir, config, 'task', tf.id);
+            return { tf, issueId: toOptionalString(a?.data.linearIssueId) };
+        }));
+        const hadIssue = Boolean(withLinear.find((x) => x.issueId)?.issueId);
+        const body = await buildMergedTaskListBody(projectDir, config, ctx.sf.data.id, ctx.sf.taskFiles);
+        const hasBody = body.trim().length > 0;
+        const rows = applyUpdateOnly([taskListPlanRow(ctx.sf.data.id, ctx.sf.taskFiles, hasBody, hadIssue)], updateOnly);
+        return summarizePlan(artifactId, ctx.epic.id, 'taskFile', rows);
+    }
+    if (type === 'quick') {
+        const qt = await loadForQuickTask(projectDir, config, artifactId);
+        if (!qt)
+            return null;
+        const hasId = Boolean(toOptionalString(qt.frontmatter.linearIssueId));
+        const rows = applyUpdateOnly([
+            {
+                kind: 'quickTask',
+                artifactId,
+                title: qt.title.trim() || qt.id,
+                action: hasId ? 'update' : 'create',
+            },
+        ], updateOnly);
+        return summarizePlan(artifactId, undefined, 'quick', rows);
+    }
+    if (type === 'backlog') {
+        const bl = await loadForBacklogItem(projectDir, config, artifactId);
+        if (!bl)
+            return null;
+        const hasId = Boolean(toOptionalString(bl.frontmatter.linearIssueId));
+        const rows = applyUpdateOnly([
+            {
+                kind: 'backlogItem',
+                artifactId,
+                title: bl.title.trim() || bl.id,
+                action: hasId ? 'update' : 'create',
+            },
+        ], updateOnly);
+        return summarizePlan(artifactId, undefined, 'backlog', rows);
+    }
+    // sprint / adr / checklist — not supported.
+    return null;
+}
+//# sourceMappingURL=plan-builders.js.map

package/dist/services/linear/plan-builders.js.map

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

package/dist/services/linear/scope-loaders.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Pure data loaders that hydrate OpenPlanr artifacts into the shapes the
+ * Linear push expects. No Linear API calls, no mutations — just filesystem
+ * reads + frontmatter parsing. Every scope-level push function routes
+ * through one of these loaders first.
+ */
+import type { Epic, Feature, OpenPlanrConfig, UserStory } from '../../models/types.js';
+export interface ScopedTaskFile {
+    id: string;
+    title: string;
+}
+export interface ScopedStory {
+    id: string;
+    title: string;
+    data: UserStory;
+    /** Raw YAML frontmatter — carries fields not mapped onto the typed `data`
+     * (e.g. `estimatedPoints`, `storyPoints` for Linear estimate sync). */
+    frontmatter: Record<string, unknown>;
+}
+export interface ScopedFeature {
+    id: string;
+    title: string;
+    data: Feature;
+    /** Raw YAML frontmatter — same purpose as ScopedStory.frontmatter. */
+    frontmatter: Record<string, unknown>;
+    stories: ScopedStory[];
+    taskFiles: ScopedTaskFile[];
+}
+/**
+ * Shape needed to push a standalone artifact (QT or BL) — the raw markdown
+ * (so QT can parse + re-render its checkbox list) plus the frontmatter
+ * record (linear* fields, epicId link, etc.).
+ */
+export interface ScopedStandaloneArtifact {
+    id: string;
+    title: string;
+    raw: string;
+    frontmatter: Record<string, unknown>;
+}
+/**
+ * Load the full epic subtree (epic frontmatter + features + stories per
+ * feature + task-file ids per feature). Filters by `epicId` on each child
+ * artifact.
+ */
+export declare function loadLinearPushScope(projectDir: string, config: OpenPlanrConfig, epicId: string): Promise<{
+    epic: Epic;
+    features: ScopedFeature[];
+} | null>;
+/**
+ * Parent-chain context needed to push a feature: the feature itself (with
+ * its stories and task files) plus its parent epic. Returns `null` if the
+ * feature can't be resolved or has no valid `epicId` pointer.
+ */
+export declare function loadForFeature(projectDir: string, config: OpenPlanrConfig, featureId: string): Promise<{
+    epic: Epic;
+    sf: ScopedFeature;
+} | null>;
+/**
+ * Parent-chain context needed to push a story: the story itself, its
+ * feature (with sibling stories + tasklists) and the containing epic.
+ * Returns `null` if any link in the chain is missing.
+ */
+export declare function loadForStory(projectDir: string, config: OpenPlanrConfig, storyId: string): Promise<{
+    epic: Epic;
+    sf: ScopedFeature;
+    story: ScopedStory;
+} | null>;
+/**
+ * Parent-chain context needed to push a task file: the containing feature
+ * (with all its task files merged into one Linear sub-issue body) and the
+ * epic.
+ */
+export declare function loadForTaskFile(projectDir: string, config: OpenPlanrConfig, taskId: string): Promise<{
+    epic: Epic;
+    sf: ScopedFeature;
+} | null>;
+export declare function loadForQuickTask(projectDir: string, config: OpenPlanrConfig, qtId: string): Promise<ScopedStandaloneArtifact | null>;
+export declare function loadForBacklogItem(projectDir: string, config: OpenPlanrConfig, blId: string): Promise<ScopedStandaloneArtifact | null>;
+//# sourceMappingURL=scope-loaders.d.ts.map

package/dist/services/linear/scope-loaders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-loaders.d.ts","sourceRoot":"","sources":["../../../src/services/linear/scope-loaders.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAc,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAkBnG,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB;2EACuE;IACvE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,aAAa,EAAE,CAAA;CAAE,GAAG,IAAI,CAAC,CA8G3D;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,aAAa,CAAA;CAAE,GAAG,IAAI,CAAC,CAUnD;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IACT,IAAI,EAAE,IAAI,CAAC;IACX,EAAE,EAAE,aAAa,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;CACpB,GAAG,IAAI,CAAC,CAUR;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,aAAa,CAAA;CAAE,GAAG,IAAI,CAAC,CAMnD;AAwBD,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAW1C;AAED,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAW1C"}