@kynetic-ai/spec 0.1.2 → 0.4.0

package/dist/export/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/export/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/export/json.d.ts

@@ -0,0 +1,24 @@
+/**
+ * JSON Export Module
+ *
+ * Generates JSON snapshots of kspec data for static site hosting.
+ * Handles reference resolution, trait expansion, and validation inclusion.
+ *
+ * AC: @gh-pages-export ac-1, ac-2, ac-3, ac-4, ac-5
+ */
+import type { ExportStats, KspecSnapshot } from "./types.js";
+/**
+ * Generate a JSON snapshot of all kspec data.
+ * AC: @gh-pages-export ac-1, ac-2, ac-3, ac-4, ac-5
+ */
+export declare function generateJsonSnapshot(includeValidation?: boolean): Promise<KspecSnapshot>;
+/**
+ * Calculate export statistics for dry-run.
+ * AC: @gh-pages-export ac-7
+ */
+export declare function calculateExportStats(snapshot: KspecSnapshot): ExportStats;
+/**
+ * Format bytes to human-readable size.
+ */
+export declare function formatBytes(bytes: number): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/export/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/export/json.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqBH,OAAO,KAAK,EAIV,WAAW,EAEX,aAAa,EACd,MAAM,YAAY,CAAC;AA+IpB;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,iBAAiB,UAAQ,GACxB,OAAO,CAAC,aAAa,CAAC,CAoDxB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,aAAa,GAAG,WAAW,CAazE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD"}

package/dist/export/json.js

@@ -0,0 +1,198 @@
+/**
+ * JSON Export Module
+ *
+ * Generates JSON snapshots of kspec data for static site hosting.
+ * Handles reference resolution, trait expansion, and validation inclusion.
+ *
+ * AC: @gh-pages-export ac-1, ac-2, ac-3, ac-4, ac-5
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { buildIndexes, computeACCoverage, initContext, loadAllItems, loadAllTasks, loadInboxItems, loadMetaContext, scanTestCoverage, validate, } from "../parser/index.js";
+import { loadSessionContext } from "../parser/meta.js";
+/**
+ * Get the kspec version from package.json
+ */
+async function getKspecVersion() {
+    try {
+        // Try to find package.json relative to this module
+        const packagePath = path.resolve(import.meta.dirname || __dirname, "../../package.json");
+        const packageJson = JSON.parse(await fs.readFile(packagePath, "utf-8"));
+        return packageJson.version || "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+/**
+ * Resolve spec_ref to its title for display.
+ * AC: @gh-pages-export ac-3
+ */
+function resolveSpecRefTitle(specRef, items, refIndex) {
+    if (!specRef)
+        return undefined;
+    const result = refIndex.resolve(specRef);
+    if (!result.ok)
+        return undefined;
+    const item = items.find((i) => i._ulid === result.ulid);
+    return item?.title;
+}
+/**
+ * Expand tasks with resolved spec reference titles.
+ * AC: @gh-pages-export ac-3
+ */
+function expandTasks(tasks, items, refIndex) {
+    return tasks.map((task) => {
+        const exportedTask = { ...task };
+        if (task.spec_ref) {
+            const title = resolveSpecRefTitle(task.spec_ref, items, refIndex);
+            if (title) {
+                exportedTask.spec_ref_title = title;
+            }
+        }
+        return exportedTask;
+    });
+}
+/**
+ * Get inherited ACs from traits for a spec item.
+ * AC: @gh-pages-export ac-4
+ */
+function getInheritedACs(item, traitIndex) {
+    const inheritedAC = traitIndex.getInheritedAC(item._ulid);
+    return inheritedAC.map(({ trait, ac }) => ({
+        ...ac,
+        _inherited_from: `@${trait.slug}`,
+    }));
+}
+/**
+ * Expand items with inherited ACs from traits and test coverage.
+ * AC: @gh-pages-export ac-4
+ * AC: @web-dashboard ac-15 - Add test coverage for static mode
+ */
+function expandItems(items, traitIndex, coveredACs) {
+    return items.map((item) => {
+        // Compute coverage for acceptance criteria using shared utility
+        const acWithCoverage = item.acceptance_criteria && item.acceptance_criteria.length > 0
+            ? computeACCoverage(item, coveredACs)
+            : item.acceptance_criteria;
+        const exportedItem = {
+            ...item,
+            acceptance_criteria: acWithCoverage,
+        };
+        // Get inherited ACs from traits
+        const inheritedACs = getInheritedACs(item, traitIndex);
+        if (inheritedACs.length > 0) {
+            exportedItem.inherited_acs = inheritedACs;
+        }
+        return exportedItem;
+    });
+}
+/**
+ * Convert validation result to exported format.
+ * AC: @gh-pages-export ac-5
+ */
+function convertValidationResult(result) {
+    return {
+        valid: result.valid,
+        errorCount: result.schemaErrors.length + result.refErrors.length,
+        warningCount: result.orphans.length + result.completenessWarnings.length,
+        errors: [
+            ...result.schemaErrors.map((e) => ({
+                file: e.file,
+                message: e.message,
+                path: e.path,
+            })),
+            ...result.refErrors.map((e) => ({
+                file: e.sourceFile || "unknown",
+                message: e.message,
+            })),
+        ],
+        warnings: [
+            ...result.orphans.map((o) => ({
+                file: "orphan",
+                message: `Orphaned ${o.type}: ${o.title}`,
+            })),
+            ...result.completenessWarnings.map((w) => ({
+                file: w.itemRef,
+                message: w.message,
+            })),
+        ],
+    };
+}
+/**
+ * Generate a JSON snapshot of all kspec data.
+ * AC: @gh-pages-export ac-1, ac-2, ac-3, ac-4, ac-5
+ */
+export async function generateJsonSnapshot(includeValidation = false) {
+    const ctx = await initContext();
+    // Load all data
+    const tasks = await loadAllTasks(ctx);
+    const items = await loadAllItems(ctx);
+    const inboxItems = await loadInboxItems(ctx);
+    const metaContext = await loadMetaContext(ctx);
+    const sessionContext = await loadSessionContext(ctx);
+    // Build indexes
+    const { refIndex, traitIndex } = await buildIndexes(ctx);
+    // Scan test coverage for AC annotations
+    const coveredACs = await scanTestCoverage(ctx.rootDir);
+    // Expand tasks with resolved spec references
+    const exportedTasks = expandTasks(tasks, items, refIndex);
+    // Expand items with inherited ACs and test coverage
+    const exportedItems = expandItems(items, traitIndex, coveredACs);
+    // Build the snapshot
+    const snapshot = {
+        version: await getKspecVersion(),
+        exported_at: new Date().toISOString(),
+        project: {
+            name: ctx.manifest?.project?.name || "Unknown Project",
+            version: ctx.manifest?.project?.version,
+        },
+        tasks: exportedTasks,
+        items: exportedItems,
+        inbox: inboxItems,
+        session: sessionContext,
+        observations: metaContext.observations,
+        agents: metaContext.agents,
+        workflows: metaContext.workflows,
+        conventions: metaContext.conventions,
+    };
+    // Include validation if requested
+    if (includeValidation) {
+        const validationResult = await validate(ctx, {
+            schema: true,
+            refs: true,
+            orphans: true,
+            completeness: true,
+        });
+        snapshot.validation = convertValidationResult(validationResult);
+    }
+    return snapshot;
+}
+/**
+ * Calculate export statistics for dry-run.
+ * AC: @gh-pages-export ac-7
+ */
+export function calculateExportStats(snapshot) {
+    const jsonString = JSON.stringify(snapshot);
+    return {
+        taskCount: snapshot.tasks.length,
+        itemCount: snapshot.items.length,
+        inboxCount: snapshot.inbox.length,
+        observationCount: snapshot.observations.length,
+        agentCount: snapshot.agents.length,
+        workflowCount: snapshot.workflows.length,
+        conventionCount: snapshot.conventions.length,
+        estimatedSizeBytes: Buffer.byteLength(jsonString, "utf-8"),
+    };
+}
+/**
+ * Format bytes to human-readable size.
+ */
+export function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=json.js.map

package/dist/export/json.js.map

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

package/dist/export/triage.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Triage Export Formatter
+ *
+ * Shared formatter for triage record exports, used by both CLI and daemon API.
+ * Two formats: structured JSON and markdown context block.
+ *
+ * AC: @triage-agent-export ac-1, ac-2, ac-3, ac-4
+ */
+import type { TriageRecord } from "../schema/triage.js";
+/**
+ * Truncate text to a maximum length, taking only the first line.
+ */
+export declare function truncateText(text: string, maxLen?: number): string;
+/**
+ * Format a single triage record as a markdown context block.
+ * AC: @triage-agent-export ac-1
+ * AC: @triage-agent-export ac-3
+ */
+export declare function formatTriageRecordContext(record: TriageRecord): string;
+/**
+ * Export triage records in context (markdown) format.
+ * AC: @triage-agent-export ac-1 — markdown block per record
+ * AC: @triage-agent-export ac-3 — overrides included
+ * AC: @triage-agent-export ac-4 — empty result message
+ */
+export declare function exportTriageAsContext(records: TriageRecord[]): string;
+/**
+ * Export result for JSON format.
+ * AC: @triage-agent-export ac-2 — JSON array with full objects
+ * AC: @triage-agent-export ac-3 — overrides included (full objects)
+ * AC: @triage-agent-export ac-4 — empty array when no records
+ */
+export interface TriageJsonExport {
+    format: "json";
+    items: TriageRecord[];
+    total: number;
+}
+/**
+ * Export result for context format.
+ */
+export interface TriageContextExport {
+    format: "context";
+    content: string;
+}
+export type TriageExportResult = TriageJsonExport | TriageContextExport;
+/**
+ * Export triage records in the requested format.
+ * AC: @triage-agent-export ac-1, ac-2, ac-3, ac-4
+ */
+export declare function exportTriageRecords(records: TriageRecord[], format: "json" | "context"): TriageExportResult;
+//# sourceMappingURL=triage.d.ts.map

package/dist/export/triage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage.d.ts","sourceRoot":"","sources":["../../src/export/triage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAW,GAAG,MAAM,CAItE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAsBtE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CASrE;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;AAExE;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,YAAY,EAAE,EACvB,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,kBAAkB,CAYpB"}

package/dist/export/triage.js

@@ -0,0 +1,83 @@
+/**
+ * Triage Export Formatter
+ *
+ * Shared formatter for triage record exports, used by both CLI and daemon API.
+ * Two formats: structured JSON and markdown context block.
+ *
+ * AC: @triage-agent-export ac-1, ac-2, ac-3, ac-4
+ */
+/**
+ * Truncate text to a maximum length, taking only the first line.
+ */
+export function truncateText(text, maxLen = 60) {
+    const firstLine = text.split("\n")[0].trim();
+    if (firstLine.length <= maxLen)
+        return firstLine;
+    return `${firstLine.slice(0, maxLen - 3)}...`;
+}
+/**
+ * Format a single triage record as a markdown context block.
+ * AC: @triage-agent-export ac-1
+ * AC: @triage-agent-export ac-3
+ */
+export function formatTriageRecordContext(record) {
+    const lines = [];
+    lines.push(`### ${record._ulid.slice(0, 8)} — ${truncateText(record.item_snapshot, 80)}`);
+    lines.push("");
+    lines.push(`**Item:** ${record.item_snapshot}`);
+    lines.push(`**Status:** ${record.status}`);
+    if (record.action)
+        lines.push(`**Action:** ${record.action}`);
+    if (record.reasoning)
+        lines.push(`**Reasoning:** ${record.reasoning}`);
+    if (record.decided_by)
+        lines.push(`**Decided by:** ${record.decided_by}`);
+    if (record.evidence_refs.length > 0) {
+        lines.push(`**Evidence:** ${record.evidence_refs.join(", ")}`);
+    }
+    // AC: @triage-agent-export ac-3 — include override information
+    if (record.override_reasoning) {
+        lines.push(`**Override:** ${record.override_reasoning} (by ${record.override_by || "unknown"})`);
+    }
+    if (record.acted_at) {
+        lines.push(`**Acted at:** ${record.acted_at}`);
+        if (record.result_ref)
+            lines.push(`**Result:** ${record.result_ref}`);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+/**
+ * Export triage records in context (markdown) format.
+ * AC: @triage-agent-export ac-1 — markdown block per record
+ * AC: @triage-agent-export ac-3 — overrides included
+ * AC: @triage-agent-export ac-4 — empty result message
+ */
+export function exportTriageAsContext(records) {
+    if (records.length === 0) {
+        return "No triage decisions recorded.";
+    }
+    let content = "# Triage Decisions\n\n";
+    for (const record of records) {
+        content += formatTriageRecordContext(record);
+    }
+    return content;
+}
+/**
+ * Export triage records in the requested format.
+ * AC: @triage-agent-export ac-1, ac-2, ac-3, ac-4
+ */
+export function exportTriageRecords(records, format) {
+    if (format === "context") {
+        return {
+            format: "context",
+            content: exportTriageAsContext(records),
+        };
+    }
+    return {
+        format: "json",
+        items: records,
+        total: records.length,
+    };
+}
+//# sourceMappingURL=triage.js.map

package/dist/export/triage.js.map

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

package/dist/export/types.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Export Types
+ *
+ * Types for the kspec export functionality.
+ * These define the structure of exported JSON snapshots and related types.
+ * AC: @gh-pages-export ac-2, ac-3, ac-4
+ */
+import type { AcceptanceCriterion, Agent, Convention, InboxItem, Observation, SessionContext, Workflow } from "../schema/index.js";
+import type { LoadedSpecItem, LoadedTask } from "../parser/yaml.js";
+/**
+ * Exported task with resolved spec reference title.
+ * AC: @gh-pages-export ac-3
+ */
+export interface ExportedTask extends LoadedTask {
+    /** Resolved title of the linked spec item (for display) */
+    spec_ref_title?: string;
+}
+/**
+ * Acceptance criterion with inheritance tracking.
+ * AC: @gh-pages-export ac-4
+ */
+export interface InheritedAC extends AcceptanceCriterion {
+    /** Reference to the trait this AC was inherited from */
+    _inherited_from: string;
+}
+/**
+ * Exported spec item with nested hierarchy and inherited ACs.
+ * AC: @gh-pages-export ac-4
+ */
+export interface ExportedItem extends Omit<LoadedSpecItem, 'acceptance_criteria'> {
+    /** Own acceptance criteria */
+    acceptance_criteria?: AcceptanceCriterion[];
+    /** Nested child items */
+    children?: ExportedItem[];
+    /** Acceptance criteria inherited from traits */
+    inherited_acs?: InheritedAC[];
+}
+/**
+ * Project metadata in the snapshot.
+ * AC: @gh-pages-export ac-2
+ */
+export interface ExportedProject {
+    name: string;
+    version?: string;
+    description?: string;
+}
+/**
+ * Validation result included in the snapshot.
+ * AC: @gh-pages-export ac-5
+ */
+export interface ExportedValidation {
+    valid: boolean;
+    errorCount: number;
+    warningCount: number;
+    errors: Array<{
+        file: string;
+        message: string;
+        path?: string;
+    }>;
+    warnings: Array<{
+        file: string;
+        message: string;
+    }>;
+}
+/**
+ * Full kspec snapshot structure.
+ * AC: @gh-pages-export ac-2
+ */
+export interface KspecSnapshot {
+    /** kspec version that generated this snapshot */
+    version: string;
+    /** ISO timestamp when the snapshot was exported */
+    exported_at: string;
+    /** Project metadata */
+    project: ExportedProject;
+    /** All tasks with resolved spec references */
+    tasks: ExportedTask[];
+    /** All spec items with hierarchy and inherited ACs */
+    items: ExportedItem[];
+    /** Inbox items */
+    inbox: InboxItem[];
+    /** Session context */
+    session: SessionContext | null;
+    /** Observations */
+    observations: Observation[];
+    /** Agents */
+    agents: Agent[];
+    /** Workflows */
+    workflows: Workflow[];
+    /** Conventions */
+    conventions: Convention[];
+    /** Validation results (optional) */
+    validation?: ExportedValidation;
+}
+/**
+ * Options for the export command.
+ */
+export interface ExportOptions {
+    /** Output format */
+    format: 'json' | 'html';
+    /** Output path (optional, defaults to stdout for json) */
+    output?: string;
+    /** Include validation results */
+    includeValidation?: boolean;
+    /** Dry run - show stats without writing */
+    dryRun?: boolean;
+}
+/**
+ * Statistics shown during dry-run.
+ * AC: @gh-pages-export ac-7
+ */
+export interface ExportStats {
+    taskCount: number;
+    itemCount: number;
+    inboxCount: number;
+    observationCount: number;
+    agentCount: number;
+    workflowCount: number;
+    conventionCount: number;
+    estimatedSizeBytes: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/export/types.d.ts.map

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

package/dist/export/types.js

@@ -0,0 +1,9 @@
+/**
+ * Export Types
+ *
+ * Types for the kspec export functionality.
+ * These define the structure of exported JSON snapshots and related types.
+ * AC: @gh-pages-export ac-2, ac-3, ac-4
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/export/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/export/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export * from './schema/index.js';
-export * from './parser/index.js';
+export * from "./parser/index.js";
+export * from "./schema/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,5 +1,5 @@
 // Kynetic Spec - Main library entry point
 // Re-export everything for library consumers
-export * from './schema/index.js';
-export * from './parser/index.js';
+export * from "./parser/index.js";
+export * from "./schema/index.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/claude-plugin-registry.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Claude Code plugin marketplace registry library.
+ *
+ * Shared by setup.ts and skill-install.ts for registering the kspec core
+ * skills plugin with Claude Code's global state.
+ *
+ * AC: @core-skill-install ac-6, ac-7, ac-8
+ * AC: @enhanced-setup ac-7, ac-8
+ */
+export interface RegisterResult {
+    success: boolean;
+    action: "registered" | "updated" | "unchanged" | "skipped" | "error";
+    message: string;
+    registeredPath?: string;
+}
+export interface EnableResult {
+    success: boolean;
+    action: "enabled" | "unchanged" | "error";
+    message: string;
+}
+export type MarketplaceHealthStatus = "healthy" | "missing" | "path-broken" | "version-mismatch" | "error";
+export interface MarketplaceHealth {
+    status: MarketplaceHealthStatus;
+    registeredPath?: string;
+    pluginVersion?: string;
+    packageVersion?: string;
+    message: string;
+}
+/**
+ * Get the Claude Code plugins directory.
+ * Respects KSPEC_CLAUDE_HOME env override for test isolation.
+ */
+export declare function getClaudePluginsDir(): string;
+/**
+ * Get the absolute path to the pre-built plugin directory in the npm package.
+ * Uses fs.realpath for symlink/pnpm stability.
+ */
+export declare function getPackagePluginDir(): Promise<string>;
+/**
+ * Register the kspec core plugin marketplace in Claude Code's global state.
+ * Writes kspec-plugins entry to known_marketplaces.json.
+ * Only updates lastUpdated when path actually changes (idempotent).
+ * Validates plugin/.claude-plugin/plugin.json exists before registering.
+ *
+ * AC: @core-skill-install ac-6, ac-8
+ */
+export declare function registerCorePluginMarketplace(opts?: {
+    dryRun?: boolean;
+}): Promise<RegisterResult>;
+/**
+ * Enable the kspec plugin in a project's .claude/settings.json.
+ * Uses strict JSON read to avoid silently discarding hooks config.
+ *
+ * AC: @core-skill-install ac-7
+ */
+export declare function enablePluginInProject(projectDir: string, opts?: {
+    dryRun?: boolean;
+}): Promise<EnableResult>;
+/**
+ * Check the health of the kspec marketplace registration.
+ * Returns status and details for setup --status reporting.
+ *
+ * AC: @enhanced-setup ac-7, ac-8
+ */
+export declare function checkMarketplaceHealth(): Promise<MarketplaceHealth>;
+//# sourceMappingURL=claude-plugin-registry.d.ts.map

package/dist/lib/claude-plugin-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-plugin-registry.d.ts","sourceRoot":"","sources":["../../src/lib/claude-plugin-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,uBAAuB,GAC/B,SAAS,GACT,SAAS,GACT,aAAa,GACb,kBAAkB,GAClB,OAAO,CAAC;AAEZ,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,uBAAuB,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAkBD;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAW3D;AA6GD;;;;;;;GAOG;AACH,wBAAsB,6BAA6B,CACjD,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC,cAAc,CAAC,CAwEzB;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,OAAO,CAAC,YAAY,CAAC,CAoDvB;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAmEzE"}