planfs-core 1.3.0 → 1.4.0

package/README.md

@@ -8,6 +8,7 @@ Core parsing and validation library for PlanFS.
 
 - **File Discovery** - Discover `.planfs/` files in a repository
 - **Parsing** - Extract YAML frontmatter and markdown body
+- **Semantic Markdown** - Inspect body structure without rewriting source files
 - **Type System** - Strong typing for all entity types
 - **Validation** - Schema validation and constraint checking
 - **Repository API** - Load and query repositories
@@ -59,6 +60,104 @@ const todoTasks = getTasksByStatus(repo, 'todo');
 const myTasks = getTasksByAssignee(repo, 'user@example.com');
 ```
 
+### Inspecting Semantic Markdown
+
+Semantic parsing is explicit and deferred, so loading a repository does not parse every body automatically:
+
+```typescript
+import { parseSemanticDocument } from 'planfs-core';
+
+const semantic = parseSemanticDocument('task', task.body, {
+  filePath: task.filePath
+});
+
+console.log(semantic.preamble.text);
+console.log(semantic.criteria);
+console.log(semantic.findings);
+console.log(semantic.questions);
+console.log(semantic.mentions); // advisory; never authoritative metadata
+```
+
+The result preserves the original Markdown and exact source ranges. It exposes PlanFS concepts rather than the underlying parser's syntax tree.
+
+For a complete read-only entity view with authoritative metadata, content-profile diagnostics, advisory mentions, and optional local analysis, use the inspection API:
+
+```typescript
+import {
+  inspectSemanticEntity,
+  selectSemanticInspectionView
+} from 'planfs-core';
+
+const inspection = await inspectSemanticEntity(task, {
+  analysis: true,
+  language: 'en'
+});
+const criteria = selectSemanticInspectionView(
+  inspection,
+  'acceptance-criteria'
+);
+```
+
+The result keeps authoritative frontmatter relationships separate from advisory body mentions. Core analysis remains explicit; interactive PlanFS inspection enables it by default and offers an opt-out.
+
+### Previewing and Applying Semantic Formatting
+
+Semantic formatting is explicit, source-fingerprinted, and limited to edits proven by the shared semantic model:
+
+```typescript
+import {
+  applySemanticFormats,
+  previewSemanticFormats
+} from 'planfs-core';
+
+const preview = await previewSemanticFormats(rootPath, ['TASK-001']);
+const applied = await applySemanticFormats(
+  rootPath,
+  ['TASK-001'],
+  preview.expectedFingerprints
+);
+```
+
+Preview never writes. Apply refuses stale fingerprints, validates all proposed results before writing, preserves unknown Markdown and frontmatter, and is idempotent.
+
+### Optional Local Prose Analysis
+
+Advisory analysis is explicit and local. Omitting `enabled: true` performs no analysis:
+
+```typescript
+import {
+  parseSemanticDocument,
+  runSemanticAnalysis
+} from 'planfs-core';
+
+const semantic = parseSemanticDocument('task', task.body, {
+  filePath: task.filePath
+});
+const analysis = await runSemanticAnalysis(semantic, {
+  enabled: true,
+  language: 'en'
+});
+```
+
+The built-in analyzer emits only the English-language rule signals promoted by the v1.4 spikes: modality, negation, condition introducers, explicit dates/durations, and possible relationship mentions. Every signal is `nlp-inferred`, includes exact source evidence, and has `authoritative: false`. It never updates frontmatter or repository relationships, makes no network calls, and does not require an NLP model or runtime download. Unsupported languages return an advisory diagnostic and no signals.
+
+### Validating Semantic Content
+
+Semantic validation is explicit and separate from existing schema/repository validation:
+
+```typescript
+import { validateSemanticEntity } from 'planfs-core';
+
+const result = await validateSemanticEntity(task, {
+  tier: 'automation-ready',
+  lifecycle: true,
+  criterionCheckState: 'warning',
+  analysis: false
+});
+```
+
+Baseline, automation-ready, lifecycle, and optional analysis diagnostics retain distinct conformance domains. Results contain stable codes, entity/file identity, source ranges, section keys, provenance, and repair guidance. Validation never changes Markdown, metadata, criterion state, or repository relationships.
+
 ## API Reference
 
 ### Types
@@ -99,6 +198,14 @@ const myTasks = getTasksByAssignee(repo, 'user@example.com');
 
 - `parseFrontmatter(content)` - Parse YAML frontmatter and markdown
 - `normalizeMetadata(metadata)` - Convert kebab-case and snake_case to camelCase
+- `parseSemanticDocument(entityType, body, options)` - Parse a body into the loss-aware semantic document model
+- `runSemanticAnalysis(document, options)` - Explicitly run optional advisory prose analysis
+- `LocalRuleSemanticAnalyzer` - Reusable local analyzer with a bounded content/version-aware cache
+- `validateSemanticDocument(entity, document, options)` - Deterministically validate an already parsed document
+- `validateSemanticEntity(entity, options)` - Parse and validate one loaded entity, optionally including local analysis
+- `validateSemanticRepository(repository, options)` - Validate semantic content across active repository entities
+- `inspectSemanticEntity(entity, options)` - Build a complete read-only semantic inspection result
+- `selectSemanticInspectionView(inspection, view)` - Select a deterministic JSON-ready inspection view
 
 ## Testing
 

package/dist/entity-content.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Serialize PlanFS entities to their Markdown representation.
+ */
+import { Entity } from './types';
+export declare function generateEntityContent(entity: Entity): string;
+//# sourceMappingURL=entity-content.d.ts.map

package/dist/entity-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-content.d.ts","sourceRoot":"","sources":["../src/entity-content.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAY,MAAM,EAAyB,MAAM,SAAS,CAAC;AAElE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA2D5D"}

package/dist/entity-content.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * Serialize PlanFS entities to their Markdown representation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateEntityContent = generateEntityContent;
+const yaml_1 = require("yaml");
+function generateEntityContent(entity) {
+    const metadata = { ...entity.metadata };
+    metadata.id = entity.id;
+    metadata.title = entity.title || '';
+    metadata.status = entity.status || '';
+    if (entity.archive)
+        metadata.archive = entity.archive;
+    switch (entity.type) {
+        case 'task': {
+            const task = entity;
+            if (task.priority)
+                metadata.priority = task.priority;
+            if (task.assignee)
+                metadata.assignee = task.assignee;
+            if (task.epic)
+                metadata.epic = task.epic;
+            if (task.milestone)
+                metadata.milestone = task.milestone;
+            if (task.dependsOn)
+                metadata.dependsOn = task.dependsOn;
+            if (task.tags)
+                metadata.tags = task.tags;
+            if (task.dueDate)
+                metadata.dueDate = task.dueDate;
+            if (task.estimate)
+                metadata.estimate = task.estimate;
+            if (task.refinementState)
+                metadata.refinementState = task.refinementState;
+            if (task.backlogOrder !== undefined)
+                metadata.backlogOrder = task.backlogOrder;
+            if (task.links)
+                metadata.links = task.links;
+            break;
+        }
+        case 'epic': {
+            const epic = entity;
+            if (epic.priority)
+                metadata.priority = epic.priority;
+            if (epic.owner)
+                metadata.owner = epic.owner;
+            if (epic.description)
+                metadata.description = epic.description;
+            if (epic.targetDate)
+                metadata.targetDate = epic.targetDate;
+            if (epic.tags)
+                metadata.tags = epic.tags;
+            if (epic.links)
+                metadata.links = epic.links;
+            break;
+        }
+        case 'milestone': {
+            const milestone = entity;
+            metadata.targetDate = milestone.targetDate;
+            if (milestone.description)
+                metadata.description = milestone.description;
+            if (milestone.owner)
+                metadata.owner = milestone.owner;
+            if (milestone.links)
+                metadata.links = milestone.links;
+            break;
+        }
+        case 'decision': {
+            const decision = entity;
+            if (decision.date)
+                metadata.date = decision.date;
+            if (decision.context)
+                metadata.context = decision.context;
+            if (decision.decision)
+                metadata.decision = decision.decision;
+            if (decision.consequences)
+                metadata.consequences = decision.consequences;
+            if (decision.author)
+                metadata.author = decision.author;
+            if (decision.supersedes)
+                metadata.supersedes = decision.supersedes;
+            if (decision.supersededBy)
+                metadata.supersededBy = decision.supersededBy;
+            break;
+        }
+    }
+    if (entity.createdAt)
+        metadata.createdAt = entity.createdAt;
+    if (entity.updatedAt)
+        metadata.updatedAt = entity.updatedAt;
+    return `---\n${(0, yaml_1.stringify)(metadata).trimEnd()}\n---\n\n${entity.body}`;
+}
+//# sourceMappingURL=entity-content.js.map

package/dist/entity-content.js.map

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

package/dist/entity-factory.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Construct new PlanFS entities and allocate their IDs.
+ */
+import { Decision, Epic, Milestone, Repository, Task } from './types';
+export declare function getNextTaskId(repository: Repository): string;
+export declare function getNextEpicId(repository: Repository, title: string): string;
+export declare function getNextMilestoneId(repository: Repository, title: string): string;
+export declare function getNextDecisionId(repository: Repository, title: string): string;
+export declare function createTaskTemplate(id: string, title: string): Task;
+export declare function createEpicTemplate(id: string, title: string): Epic;
+export declare function createMilestoneTemplate(id: string, title: string, targetDate: string): Milestone;
+export declare function createDecisionTemplate(id: string, title: string): Decision;
+//# sourceMappingURL=entity-factory.d.ts.map

package/dist/entity-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-factory.d.ts","sourceRoot":"","sources":["../src/entity-factory.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAU,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE9E,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAW5D;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAalE;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAalE;AAED,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,SAAS,CAcX;AAED,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAa1E"}

package/dist/entity-factory.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * Construct new PlanFS entities and allocate their IDs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNextTaskId = getNextTaskId;
+exports.getNextEpicId = getNextEpicId;
+exports.getNextMilestoneId = getNextMilestoneId;
+exports.getNextDecisionId = getNextDecisionId;
+exports.createTaskTemplate = createTaskTemplate;
+exports.createEpicTemplate = createEpicTemplate;
+exports.createMilestoneTemplate = createMilestoneTemplate;
+exports.createDecisionTemplate = createDecisionTemplate;
+function getNextTaskId(repository) {
+    let maxNum = 0;
+    for (const id of repository.tasks.keys()) {
+        if (id.startsWith('TASK-')) {
+            const num = parseInt(id.substring(5), 10);
+            if (!isNaN(num) && num > maxNum) {
+                maxNum = num;
+            }
+        }
+    }
+    return `TASK-${String(maxNum + 1).padStart(3, '0')}`;
+}
+function getNextEpicId(repository, title) {
+    return getAvailableSlugId('EPIC', title, repository.epics);
+}
+function getNextMilestoneId(repository, title) {
+    return getAvailableSlugId('MILESTONE', title, repository.milestones);
+}
+function getNextDecisionId(repository, title) {
+    return getAvailableSlugId('DECISION', title, repository.decisions);
+}
+function createTaskTemplate(id, title) {
+    const now = new Date().toISOString();
+    return {
+        id,
+        type: 'task',
+        title,
+        status: 'todo',
+        filePath: '',
+        metadata: {},
+        body: '',
+        createdAt: now,
+        updatedAt: now
+    };
+}
+function createEpicTemplate(id, title) {
+    const now = new Date().toISOString();
+    return {
+        id,
+        type: 'epic',
+        title,
+        status: 'active',
+        filePath: '',
+        metadata: {},
+        body: '',
+        createdAt: now,
+        updatedAt: now
+    };
+}
+function createMilestoneTemplate(id, title, targetDate) {
+    const now = new Date().toISOString();
+    return {
+        id,
+        type: 'milestone',
+        title,
+        status: 'active',
+        targetDate,
+        filePath: '',
+        metadata: {},
+        body: '',
+        createdAt: now,
+        updatedAt: now
+    };
+}
+function createDecisionTemplate(id, title) {
+    const now = new Date().toISOString();
+    return {
+        id,
+        type: 'decision',
+        title,
+        status: 'proposed',
+        filePath: '',
+        metadata: {},
+        body: '',
+        createdAt: now,
+        updatedAt: now
+    };
+}
+function getAvailableSlugId(prefix, title, existing) {
+    const base = `${prefix}-${slugify(title)}`;
+    let candidate = base;
+    let suffix = 2;
+    while (existing.has(candidate)) {
+        candidate = `${base}-${suffix}`;
+        suffix += 1;
+    }
+    return candidate;
+}
+function slugify(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'untitled';
+}
+//# sourceMappingURL=entity-factory.js.map

package/dist/entity-factory.js.map

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

package/dist/index.d.ts

@@ -7,6 +7,8 @@ export * from './files';
 export * from './loader';
 export * from './validator';
 export * from './repository';
+export * from './entity-content';
+export * from './entity-factory';
 export * from './references';
 export * from './graph';
 export * from './git';
@@ -20,4 +22,12 @@ export * from './ai';
 export * from './task-update';
 export * from './format';
 export * from './history';
+export * from './semantic-types';
+export * from './semantic-profiles';
+export * from './semantic';
+export * from './semantic-analyzer';
+export * from './semantic-validator';
+export * from './semantic-inspection';
+export * from './semantic-formatter';
+export * from './semantic-context';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,MAAM,CAAC;AACrB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,MAAM,CAAC;AACrB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -23,6 +23,8 @@ __exportStar(require("./files"), exports);
 __exportStar(require("./loader"), exports);
 __exportStar(require("./validator"), exports);
 __exportStar(require("./repository"), exports);
+__exportStar(require("./entity-content"), exports);
+__exportStar(require("./entity-factory"), exports);
 __exportStar(require("./references"), exports);
 __exportStar(require("./graph"), exports);
 __exportStar(require("./git"), exports);
@@ -36,4 +38,12 @@ __exportStar(require("./ai"), exports);
 __exportStar(require("./task-update"), exports);
 __exportStar(require("./format"), exports);
 __exportStar(require("./history"), exports);
+__exportStar(require("./semantic-types"), exports);
+__exportStar(require("./semantic-profiles"), exports);
+__exportStar(require("./semantic"), exports);
+__exportStar(require("./semantic-analyzer"), exports);
+__exportStar(require("./semantic-validator"), exports);
+__exportStar(require("./semantic-inspection"), exports);
+__exportStar(require("./semantic-formatter"), exports);
+__exportStar(require("./semantic-context"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,0CAAwB;AACxB,2CAAyB;AACzB,0CAAwB;AACxB,2CAAyB;AACzB,8CAA4B;AAC5B,+CAA6B;AAC7B,+CAA6B;AAC7B,0CAAwB;AACxB,wCAAsB;AACtB,2CAAyB;AACzB,8CAA4B;AAC5B,8CAA4B;AAC5B,4CAA0B;AAC1B,yCAAuB;AACvB,iDAA+B;AAC/B,uCAAqB;AACrB,gDAA8B;AAC9B,2CAAyB;AACzB,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,0CAAwB;AACxB,2CAAyB;AACzB,0CAAwB;AACxB,2CAAyB;AACzB,8CAA4B;AAC5B,+CAA6B;AAC7B,mDAAiC;AACjC,mDAAiC;AACjC,+CAA6B;AAC7B,0CAAwB;AACxB,wCAAsB;AACtB,2CAAyB;AACzB,8CAA4B;AAC5B,8CAA4B;AAC5B,4CAA0B;AAC1B,yCAAuB;AACvB,iDAA+B;AAC/B,uCAAqB;AACrB,gDAA8B;AAC9B,2CAAyB;AACzB,4CAA0B;AAC1B,mDAAiC;AACjC,sDAAoC;AACpC,6CAA2B;AAC3B,sDAAoC;AACpC,uDAAqC;AACrC,wDAAsC;AACtC,uDAAqC;AACrC,qDAAmC"}

package/dist/repository.d.ts

@@ -3,7 +3,9 @@
  * Main API for loading and querying a PlanFS repository
  */
 import { PlanfsInitializationResult } from './files';
-import { Entity, Repository, Task, Epic, Milestone, Decision, ValidationResult } from './types';
+import { Entity, Repository, Task, ValidationResult } from './types';
+export { generateEntityContent } from './entity-content';
+export { createDecisionTemplate, createEpicTemplate, createMilestoneTemplate, createTaskTemplate, getNextDecisionId, getNextEpicId, getNextMilestoneId, getNextTaskId } from './entity-factory';
 /**
  * Load a PlanFS repository
  */
@@ -22,10 +24,6 @@ export declare function validateRepositoryState(repository: Repository): Validat
  * Save an entity to disk
  */
 export declare function saveEntity(rootPath: string, entity: Entity): Promise<void>;
-/**
- * Generate file content from an entity
- */
-export declare function generateEntityContent(entity: Entity): string;
 export interface ArchiveEntityOptions {
     includeChildren?: boolean;
     now?: Date;
@@ -60,30 +58,4 @@ export declare function getTasksByEpic(repository: Repository, epicId: string):
  * Initialize a new repository
  */
 export declare function initializeRepository(rootPath: string): Promise<PlanfsInitializationResult>;
-/**
- * Get next task ID
- */
-export declare function getNextTaskId(repository: Repository): string;
-/**
- * Get an available epic ID from a title
- */
-export declare function getNextEpicId(repository: Repository, title: string): string;
-/**
- * Get an available milestone ID from a title
- */
-export declare function getNextMilestoneId(repository: Repository, title: string): string;
-export declare function getNextDecisionId(repository: Repository, title: string): string;
-/**
- * Create a new task template
- */
-export declare function createTaskTemplate(id: string, title: string): Task;
-/**
- * Create a new epic template
- */
-export declare function createEpicTemplate(id: string, title: string): Epic;
-/**
- * Create a new milestone template
- */
-export declare function createMilestoneTemplate(id: string, title: string, targetDate: string): Milestone;
-export declare function createDecisionTemplate(id: string, title: string): Decision;
 //# sourceMappingURL=repository.d.ts.map

package/dist/repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAQL,0BAA0B,EAC3B,MAAM,SAAS,CAAC;AAIjB,OAAO,EACL,MAAM,EACN,UAAU,EACV,IAAI,EAIJ,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAIjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,aAAa,EACd,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA6E1E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1C,MAAM,EAAE,CAaV;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,gBAAgB,CAgBhF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAUf;AAmBD,MAAM,WAAW,oBAAoB;IACnC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE,CAKrE;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAsC9B;AAED,MAAM,WAAW,4BAA4B;IAC3C,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAQjB;AAkBD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,GACrB,IAAI,EAAE,CAIR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,GACf,IAAI,EAAE,CAIR;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,GACb,IAAI,EAAE,CAIR;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,0BAA0B,CAAC,CAErC"}