raptor-aios 0.1.0

package/dist/_core/dist/verify/stores.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Store permission verification (M1) — measure the DECLARED store permissions
+ * (spec.md `stores.{ios_permissions, android_permissions}`) against the REAL
+ * native manifests: Android `AndroidManifest.xml` (<uses-permission>) and iOS
+ * `Info.plist` (NSxxxUsageDescription keys).
+ *
+ * Declarations are free-form strings (e.g. "android.permission.CAMERA — why");
+ * we extract the canonical identifier from each. Declarations without a
+ * recognizable token (e.g. a push `aps-environment` entitlement) are reported
+ * as `manual` (cannot be statically verified from the manifest), not failed.
+ */
+export declare function extractAndroidPermission(declared: string): string | undefined;
+export declare function extractIosUsageKey(declared: string): string | undefined;
+/** All permission names from a parsed AndroidManifest.xml. */
+export declare function parseManifestPermissions(xml: string): string[];
+/** All NSxxxUsageDescription keys present in an Info.plist. */
+export declare function parseInfoPlistKeys(plist: string): string[];
+export interface StoreCheck {
+    platform: "android" | "ios";
+    declared: string;
+    identifier?: string;
+    status: "present" | "missing" | "manual";
+    detail: string;
+}
+export interface StoresEvaluation {
+    checks: StoreCheck[];
+    /** ok = no `missing` (manual items are warnings, not failures). */
+    ok: boolean;
+    missing: StoreCheck[];
+}
+export declare function evaluateStores(declared: {
+    ios_permissions?: string[];
+    android_permissions?: string[];
+}, native: {
+    androidPerms: string[];
+    iosKeys: string[];
+}): StoresEvaluation;
+//# sourceMappingURL=stores.d.ts.map

package/dist/_core/dist/verify/stores.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stores.d.ts","sourceRoot":"","sources":["../../src/verify/stores.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE7E;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvE;AAED,8DAA8D;AAC9D,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAI9D;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAI1D;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,SAAS,GAAG,KAAK,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,mEAAmE;IACnE,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE;IAAE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,EACxE,MAAM,EAAE;IAAE,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GACpD,gBAAgB,CA2BlB"}

package/dist/_core/dist/verify/stores.js

@@ -0,0 +1,57 @@
+/**
+ * Store permission verification (M1) — measure the DECLARED store permissions
+ * (spec.md `stores.{ios_permissions, android_permissions}`) against the REAL
+ * native manifests: Android `AndroidManifest.xml` (<uses-permission>) and iOS
+ * `Info.plist` (NSxxxUsageDescription keys).
+ *
+ * Declarations are free-form strings (e.g. "android.permission.CAMERA — why");
+ * we extract the canonical identifier from each. Declarations without a
+ * recognizable token (e.g. a push `aps-environment` entitlement) are reported
+ * as `manual` (cannot be statically verified from the manifest), not failed.
+ */
+const ANDROID_PERM_RE = /android\.permission\.[A-Z0-9_]+/;
+const IOS_KEY_RE = /NS[A-Za-z0-9]+UsageDescription/;
+export function extractAndroidPermission(declared) {
+    return declared.match(ANDROID_PERM_RE)?.[0];
+}
+export function extractIosUsageKey(declared) {
+    return declared.match(IOS_KEY_RE)?.[0];
+}
+/** All permission names from a parsed AndroidManifest.xml. */
+export function parseManifestPermissions(xml) {
+    return [...xml.matchAll(/<uses-permission[^>]*android:name="([^"]+)"/g)].map((m) => m[1]);
+}
+/** All NSxxxUsageDescription keys present in an Info.plist. */
+export function parseInfoPlistKeys(plist) {
+    return [...plist.matchAll(/<key>(NS[A-Za-z0-9]+UsageDescription)<\/key>/g)].map((m) => m[1]);
+}
+export function evaluateStores(declared, native) {
+    const checks = [];
+    for (const d of declared.android_permissions ?? []) {
+        const id = extractAndroidPermission(d);
+        if (!id) {
+            checks.push({ platform: "android", declared: d, status: "manual", detail: "No android.permission.* token found — verify manually." });
+        }
+        else if (native.androidPerms.includes(id)) {
+            checks.push({ platform: "android", declared: d, identifier: id, status: "present", detail: "Declared and present in AndroidManifest.xml." });
+        }
+        else {
+            checks.push({ platform: "android", declared: d, identifier: id, status: "missing", detail: `${id} declared but absent from AndroidManifest.xml.` });
+        }
+    }
+    for (const d of declared.ios_permissions ?? []) {
+        const id = extractIosUsageKey(d);
+        if (!id) {
+            checks.push({ platform: "ios", declared: d, status: "manual", detail: "No NSxxxUsageDescription key (e.g. entitlement) — verify manually." });
+        }
+        else if (native.iosKeys.includes(id)) {
+            checks.push({ platform: "ios", declared: d, identifier: id, status: "present", detail: "Declared and present in Info.plist." });
+        }
+        else {
+            checks.push({ platform: "ios", declared: d, identifier: id, status: "missing", detail: `${id} declared but absent from Info.plist.` });
+        }
+    }
+    const missing = checks.filter((c) => c.status === "missing");
+    return { checks, ok: missing.length === 0, missing };
+}
+//# sourceMappingURL=stores.js.map

package/dist/_core/dist/verify/stores.js.map

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

package/dist/_core/dist/version.d.ts

@@ -0,0 +1,8 @@
+/**
+ * VERSION — Read from package.json (single source of truth).
+ *
+ * Both `raptor --version` and `raptor doctor` display this value.
+ * Never hardcode a version string anywhere else.
+ */
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/_core/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,eAAO,MAAM,OAAO,EAAE,MAAoB,CAAC"}

package/dist/_core/dist/version.js

@@ -0,0 +1,11 @@
+import { createRequire } from "node:module";
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
+/**
+ * VERSION — Read from package.json (single source of truth).
+ *
+ * Both `raptor --version` and `raptor doctor` display this value.
+ * Never hardcode a version string anywhere else.
+ */
+export const VERSION = pkg.version;
+//# sourceMappingURL=version.js.map

package/dist/_core/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,CAAC"}

package/dist/_core/dist/workflows/bundled.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Bundled SDD Cycle workflow.
+ *
+ * The canonical SDD workflow: specify → plan → tasks → implement
+ * with human review gates between each phase.
+ *
+ * This is embedded as code rather than a YAML file so it's
+ * always available without filesystem access.
+ */
+import type { WorkflowDefinition } from "./types.js";
+/**
+ * The canonical SDD workflow definition.
+ *
+ * Flow: specify → review_spec → approve_spec → plan → review_plan → approve_plan
+ *       → tasks → review_tasks → approve_tasks → implement → review_implementation.
+ *
+ * Step IDs use underscores because expressions reference them via dot-path
+ * (e.g. `steps.review_spec.output.response`) and DOT_PATH tokens don't permit
+ * hyphens.
+ */
+export declare const SDD_CYCLE: WorkflowDefinition;
+/**
+ * Quick SDD cycle — skips human review gates (for trusted environments).
+ * Still runs approve steps so artifact frontmatter is consistent and the
+ * critical plan.approved gate is satisfied.
+ */
+export declare const SDD_CYCLE_QUICK: WorkflowDefinition;
+/**
+ * Get all bundled workflows.
+ */
+export declare function getBundledWorkflows(): WorkflowDefinition[];
+//# sourceMappingURL=bundled.d.ts.map

package/dist/_core/dist/workflows/bundled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled.d.ts","sourceRoot":"","sources":["../../src/workflows/bundled.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGrD;;;;;;;;;GASG;AACH,eAAO,MAAM,SAAS,EAAE,kBA6JvB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,kBA+E7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,kBAAkB,EAAE,CAE1D"}

package/dist/_core/dist/workflows/bundled.js

@@ -0,0 +1,254 @@
+/**
+ * Bundled SDD Cycle workflow.
+ *
+ * The canonical SDD workflow: specify → plan → tasks → implement
+ * with human review gates between each phase.
+ *
+ * This is embedded as code rather than a YAML file so it's
+ * always available without filesystem access.
+ */
+import { WORKFLOW_SCHEMA_V1 } from "./types.js";
+/**
+ * The canonical SDD workflow definition.
+ *
+ * Flow: specify → review_spec → approve_spec → plan → review_plan → approve_plan
+ *       → tasks → review_tasks → approve_tasks → implement → review_implementation.
+ *
+ * Step IDs use underscores because expressions reference them via dot-path
+ * (e.g. `steps.review_spec.output.response`) and DOT_PATH tokens don't permit
+ * hyphens.
+ */
+export const SDD_CYCLE = {
+    schema: WORKFLOW_SCHEMA_V1,
+    workflow: {
+        id: "sdd-cycle",
+        name: "Full SDD Cycle",
+        version: "1.0.0",
+        author: "Raptor",
+        description: "Executes the full Spec-Driven Development cycle: specify → plan → tasks → implement. Each phase is followed by a human review gate and an explicit approve step, plus a final implementation review (11 steps total).",
+    },
+    requires: {
+        raptorVersion: ">=0.7.0",
+        agents: {
+            any: ["claude-code", "cursor", "antigravity", "human"],
+        },
+    },
+    inputs: [
+        {
+            name: "feature",
+            type: "string",
+            required: true,
+            prompt: "Feature slug (kebab-case, e.g. login-biometric)",
+        },
+        {
+            name: "platform",
+            type: "choice",
+            required: false,
+            prompt: "Target platform",
+            choices: ["cross", "ios", "android"],
+            default: "cross",
+        },
+        {
+            name: "agent",
+            type: "choice",
+            required: false,
+            prompt: "Which agent to use? (leave blank for auto-select)",
+            choices: ["auto", "claude-code", "cursor", "antigravity", "human"],
+            default: "auto",
+        },
+    ],
+    steps: [
+        // Phase 1: Specify
+        {
+            id: "specify",
+            type: "command",
+            title: "Generate Feature Specification",
+            command: "raptor.new",
+            input: {
+                slug: "{{ inputs.feature }}",
+                platform: "{{ inputs.platform }}",
+            },
+        },
+        // Gate 1: Review spec
+        {
+            id: "review_spec",
+            type: "gate",
+            title: "Review Specification",
+            message: "Review the generated spec.md. Does it accurately capture all requirements with measurable acceptance criteria?",
+            options: ["approve", "reject", "revise"],
+            onReject: "abort",
+            artifacts: ["specs/{{ feature }}/spec.md"],
+        },
+        // Phase 1b: Approve spec so subsequent phases can proceed
+        {
+            id: "approve_spec",
+            type: "command",
+            title: "Approve Specification",
+            command: "raptor.approve",
+            when: 'steps.review_spec.output.response == "approve"',
+            input: { artifact: "spec" },
+        },
+        // Phase 2: Plan
+        {
+            id: "plan",
+            type: "command",
+            title: "Generate Technical Plan",
+            command: "raptor.plan",
+        },
+        // Gate 2: Review plan
+        {
+            id: "review_plan",
+            type: "gate",
+            title: "Review Technical Plan",
+            message: "Review the generated plan.md. Are the technical decisions justified and aligned with constitutional articles?",
+            options: ["approve", "reject", "revise"],
+            onReject: "abort",
+            artifacts: ["specs/{{ feature }}/plan.md"],
+        },
+        // Phase 2b: Approve plan (critical, requires identifiable human)
+        {
+            id: "approve_plan",
+            type: "command",
+            title: "Approve Technical Plan",
+            command: "raptor.approve",
+            when: 'steps.review_plan.output.response == "approve"',
+            input: {
+                artifact: "plan",
+                "phase-minus-one": "passed",
+            },
+        },
+        // Phase 3: Tasks
+        {
+            id: "tasks",
+            type: "command",
+            title: "Generate Task Decomposition",
+            command: "raptor.tasks",
+        },
+        // Gate 3: Review tasks
+        {
+            id: "review_tasks",
+            type: "gate",
+            title: "Review Task Decomposition",
+            message: "Review the generated tasks.md. Are tasks well-scoped (≤4h each), properly ordered, and mapped to user stories?",
+            options: ["approve", "reject", "revise"],
+            onReject: "abort",
+            artifacts: ["specs/{{ feature }}/tasks.md"],
+        },
+        // Phase 3b: Approve tasks so implement can run
+        {
+            id: "approve_tasks",
+            type: "command",
+            title: "Approve Task Decomposition",
+            command: "raptor.approve",
+            when: 'steps.review_tasks.output.response == "approve"',
+            input: { artifact: "tasks" },
+        },
+        // Phase 4: Implement
+        {
+            id: "implement",
+            type: "command",
+            title: "Implement Tasks",
+            command: "raptor.implement",
+        },
+        // Final gate: Implementation review
+        {
+            id: "review_implementation",
+            type: "gate",
+            title: "Review Implementation",
+            message: "Review the implementation. Are all tasks marked as complete? Do tests pass? Is the audit trail consistent?",
+            options: ["approve", "reject"],
+            onReject: "abort",
+        },
+    ],
+};
+/**
+ * Quick SDD cycle — skips human review gates (for trusted environments).
+ * Still runs approve steps so artifact frontmatter is consistent and the
+ * critical plan.approved gate is satisfied.
+ */
+export const SDD_CYCLE_QUICK = {
+    schema: WORKFLOW_SCHEMA_V1,
+    workflow: {
+        id: "sdd-cycle-quick",
+        name: "Quick SDD Cycle (No Gates)",
+        version: "1.0.0",
+        author: "Raptor",
+        description: "Runs the full SDD cycle without human review gates. Use only in trusted/automated environments.",
+    },
+    inputs: [
+        {
+            name: "feature",
+            type: "string",
+            required: true,
+            prompt: "Feature slug (kebab-case)",
+        },
+        {
+            name: "platform",
+            type: "choice",
+            required: false,
+            choices: ["cross", "ios", "android"],
+            default: "cross",
+        },
+    ],
+    steps: [
+        {
+            id: "specify",
+            type: "command",
+            title: "Generate Feature Specification",
+            command: "raptor.new",
+            input: {
+                slug: "{{ inputs.feature }}",
+                platform: "{{ inputs.platform }}",
+            },
+        },
+        {
+            id: "approve_spec",
+            type: "command",
+            title: "Approve Specification",
+            command: "raptor.approve",
+            input: { artifact: "spec" },
+        },
+        {
+            id: "plan",
+            type: "command",
+            title: "Generate Technical Plan",
+            command: "raptor.plan",
+        },
+        {
+            id: "approve_plan",
+            type: "command",
+            title: "Approve Technical Plan",
+            command: "raptor.approve",
+            input: {
+                artifact: "plan",
+                "phase-minus-one": "passed",
+            },
+        },
+        {
+            id: "tasks",
+            type: "command",
+            title: "Generate Task Decomposition",
+            command: "raptor.tasks",
+        },
+        {
+            id: "approve_tasks",
+            type: "command",
+            title: "Approve Task Decomposition",
+            command: "raptor.approve",
+            input: { artifact: "tasks" },
+        },
+        {
+            id: "implement",
+            type: "command",
+            title: "Implement Tasks",
+            command: "raptor.implement",
+        },
+    ],
+};
+/**
+ * Get all bundled workflows.
+ */
+export function getBundledWorkflows() {
+    return [SDD_CYCLE, SDD_CYCLE_QUICK];
+}
+//# sourceMappingURL=bundled.js.map

package/dist/_core/dist/workflows/bundled.js.map

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

package/dist/_core/dist/workflows/engine.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Workflow Execution Engine — resumable state machine.
+ *
+ * Executes workflow steps sequentially, persists state after each step,
+ * and supports pause/resume for gates and interruptions.
+ *
+ * Blueprint ref: 05 §5 — "Modelo de execução".
+ *
+ * Properties:
+ *   - Resumable: state persisted after each step.
+ *   - Accumulative context: each step sees all previous outputs.
+ *   - Gates pause: execution freezes until human input.
+ *   - Clean abort: state preserved for diagnosis.
+ */
+import type { WorkflowDefinition, WorkflowRunState, WorkflowContext, WorkflowEventHandler, CommandExecutorResult, ShellExecOptions, ShellExecResult } from "./types.js";
+import type { HookOutcome } from "../hooks/types.js";
+export interface EngineOptions {
+    /** Project root path (used for state persistence). */
+    projectRoot: string;
+    /** Feature slug (optional, for SDD workflows). */
+    feature?: string;
+    /** Pre-resolved input values. */
+    inputs?: Record<string, unknown>;
+    /** Event handler for observability. */
+    onEvent?: WorkflowEventHandler;
+    /** Command executor (injectable for testing). */
+    commandExecutor?: CommandExecutor;
+    /** Gate responder (injectable for testing / automation). */
+    gateResponder?: GateResponder;
+    /** Shell executor (injectable for testing). */
+    shellExecutor?: ShellExecutor;
+    /**
+     * Synchronous hook runner override. When provided, workflow engine
+     * will call this instead of `runHooksAsync()` — useful for tests
+     * that inject a fake synchronous hook runner.
+     */
+    hookRunner?: (ctx: import("../hooks/types.js").HookContext) => HookOutcome;
+    /** Hook outcome reporter (called once for before_workflow and once for after_workflow). */
+    onHookOutcome?: (outcome: HookOutcome) => void;
+    /** Skip before_/after_workflow hooks entirely (for tests). */
+    skipWorkflowHooks?: boolean;
+    /** Actor metadata for hook env contract. */
+    actor?: {
+        user: string;
+        via: "human" | "agent" | "ci" | "system";
+    };
+}
+export type CommandExecutor = (command: string, input: Record<string, string>, ctx: WorkflowContext) => Promise<CommandExecutorResult>;
+export type GateResponder = (stepId: string, message: string, options: string[], artifacts: string[]) => Promise<string>;
+export type ShellExecutor = (cmd: string, cwd: string, opts?: ShellExecOptions) => Promise<ShellExecResult>;
+/**
+ * Load a persisted workflow run state.
+ */
+export declare function loadRunState(projectRoot: string, runId: string): WorkflowRunState | null;
+/**
+ * List all persisted run states.
+ */
+export declare function listRunStates(projectRoot: string): WorkflowRunState[];
+/**
+ * Start executing a workflow from the beginning.
+ *
+ * Fires `before_workflow` hook first (can abort). Fires `after_workflow`
+ * hook once the run reaches a terminal state (completed/failed/aborted).
+ * Does NOT fire `after_workflow` on pause — only when the run is final.
+ */
+export declare function executeWorkflow(workflow: WorkflowDefinition, opts: EngineOptions): Promise<WorkflowRunState>;
+/**
+ * Resume a paused workflow execution.
+ */
+export declare function resumeWorkflow(workflow: WorkflowDefinition, state: WorkflowRunState, opts: EngineOptions, gateResponse?: {
+    stepId: string;
+    response: string;
+}): Promise<WorkflowRunState>;
+//# sourceMappingURL=engine.d.ts.map

package/dist/_core/dist/workflows/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/workflows/engine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAYH,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAEhB,eAAe,EAIf,oBAAoB,EAOpB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EAChB,MAAM,YAAY,CAAC;AAIpB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrD,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,uCAAuC;IACvC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,iDAAiD;IACjD,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,4DAA4D;IAC5D,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,+CAA+C;IAC/C,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,mBAAmB,EAAE,WAAW,KAAK,WAAW,CAAC;IAC3E,2FAA2F;IAC3F,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IAC/C,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,4CAA4C;IAC5C,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,GAAG,QAAQ,CAAC;KAC1C,CAAC;CACH;AAED,MAAM,MAAM,eAAe,GAAG,CAC5B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,GAAG,EAAE,eAAe,KACjB,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAEpC,MAAM,MAAM,aAAa,GAAG,CAC1B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,EAAE,KAChB,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,MAAM,MAAM,aAAa,GAAG,CAC1B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,gBAAgB,KACpB,OAAO,CAAC,eAAe,CAAC,CAAC;AAyB9B;;GAEG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,gBAAgB,GAAG,IAAI,CAIzB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAgBrE;AAqHD;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,kBAAkB,EAC5B,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,gBAAgB,CAAC,CA4E3B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,aAAa,EACnB,YAAY,CAAC,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAClD,OAAO,CAAC,gBAAgB,CAAC,CAwE3B"}