@cmodjs/core 0.3.0 → 1.5.0

package/src/utils/metadata.ts

@@ -1,4 +1,4 @@
-export type MetadataFormat = { readonly kind: 'frontmatter' } | { readonly kind: 'comment'; readonly prefix: string } | { readonly kind: 'sidecar' }
+export type MetadataFormat = { readonly type: 'frontmatter' } | { readonly type: 'comment'; readonly prefix: string } | { readonly type: 'sidecar' }
 
 export type ReadMetadata = {
   readonly metadata: Readonly<Record<string, string>>
@@ -26,12 +26,12 @@ export function formatOf(path: string, firstLine: string | undefined): MetadataF
   const name = path.slice(path.lastIndexOf('/') + 1)
   const dot = name.lastIndexOf('.')
   const extension = dot <= 0 ? '' : name.slice(dot + 1).toLowerCase()
-  if (markdown.includes(extension)) return { kind: 'frontmatter' }
-  if (hashComments.includes(extension) || hashCommentNames.includes(name)) return { kind: 'comment', prefix: '#' }
-  if (slashComments.includes(extension)) return { kind: 'comment', prefix: '//' }
-  if (dashComments.includes(extension)) return { kind: 'comment', prefix: '--' }
-  if (extension === '' && firstLine?.startsWith('#!') === true) return { kind: 'comment', prefix: '#' }
-  return { kind: 'sidecar' }
+  if (markdown.includes(extension)) return { type: 'frontmatter' }
+  if (hashComments.includes(extension) || hashCommentNames.includes(name)) return { type: 'comment', prefix: '#' }
+  if (slashComments.includes(extension)) return { type: 'comment', prefix: '//' }
+  if (dashComments.includes(extension)) return { type: 'comment', prefix: '--' }
+  if (extension === '' && firstLine?.startsWith('#!') === true) return { type: 'comment', prefix: '#' }
+  return { type: 'sidecar' }
 }
 
 type Region = { readonly start: number; readonly end: number; readonly lines: readonly string[] }
@@ -42,21 +42,21 @@ type Block = { readonly start: number; readonly end: number; readonly entries: r
 
 export function readMetadata(text: string, format: MetadataFormat): ReadMetadata {
   const lines = text.split('\n')
-  if (format.kind === 'comment') {
+  if (format.type === 'comment') {
     const region = commentRegion(lines, format.prefix)
     return { metadata: region === undefined ? {} : asRecord(mapEntries(region.lines, region.start + 2, 0)) }
   }
-  const region = format.kind === 'frontmatter' ? frontmatterRegion(lines) : { start: -1, end: lines.length, lines }
+  const region = format.type === 'frontmatter' ? frontmatterRegion(lines) : { start: -1, end: lines.length, lines }
   if (region === undefined) return { metadata: {} }
   const block = metadataBlock(region)
-  const name = format.kind === 'frontmatter' ? topLevelScalar(region, 'name') : undefined
+  const name = format.type === 'frontmatter' ? topLevelScalar(region, 'name') : undefined
   return { metadata: block === undefined ? {} : asRecord(block.entries), ...(name === undefined ? {} : { name }) }
 }
 
 export function writeMetadata(text: string, format: MetadataFormat, metadata: Readonly<Record<string, string>>): string {
   const lines = text.split('\n')
   const entries = Object.entries(metadata)
-  if (format.kind === 'comment') {
+  if (format.type === 'comment') {
     const { prefix } = format
     const block = entries.length === 0 ? [] : [`${prefix} /// metadata`, ...entries.map(([key, value]) => `${prefix} ${scalar(key)}: ${scalar(value)}`), `${prefix} ///`]
     const region = commentRegion(lines, prefix)
@@ -66,7 +66,7 @@ export function writeMetadata(text: string, format: MetadataFormat, metadata: Re
     return [...lines.slice(0, at), ...block, ...lines.slice(at)].join('\n')
   }
   const map = entries.length === 0 ? [] : ['metadata:', ...entries.map(([key, value]) => `  ${scalar(key)}: ${scalar(value)}`)]
-  if (format.kind === 'sidecar') {
+  if (format.type === 'sidecar') {
     const block = metadataBlock({ start: -1, end: lines.length, lines })
     const rest = block === undefined ? lines : [...lines.slice(0, block.start), ...lines.slice(block.end)]
     const kept = rest.join('\n').trim()
@@ -206,7 +206,8 @@ function unquoted(text: string, lineNumber: number): string {
     if (!text.endsWith('"') || text.length < 2) throw new MetadataError(lineNumber, `${text} opens a double quote that never closes.`)
     try {
       return JSON.parse(text) as string
-    } catch {
+    } catch (error) {
+      if (!(error instanceof SyntaxError)) throw error
       throw new MetadataError(lineNumber, `${text} is not a double-quoted text. Escape a " inside it as \\".`)
     }
   }
@@ -224,8 +225,9 @@ function topLevelScalar(region: Region, key: string): string | undefined {
   if (text === '') return undefined
   try {
     return unquoted(text, region.start + 2 + at)
-  } catch {
-    return undefined
+  } catch (error) {
+    if (error instanceof MetadataError) return undefined
+    throw error
   }
 }
 

package/src/utils/parse-shell.ts

@@ -18,7 +18,7 @@ type Scan = { text: string; markers: Marker[]; end: number }
 type Redirect = { operator: string; target: Word }
 type Pipe = { writer: number | undefined }
 type Command = { words: Word[]; redirects: Redirect[]; pipe: Pipe | undefined }
-type Stdin = { kind: 'text'; text: string } | { kind: 'pipe' }
+type Stdin = { type: 'text'; text: string } | { type: 'pipe' }
 type Access = 'reads' | 'writes'
 type OptionSpec = { valued?: string; optional?: string; longValued?: readonly string[] }
 type Option = { name: string; value: Word | undefined }
@@ -211,7 +211,8 @@ function parseLine(line: string, folder: string, result: ParsedShell): void {
   try {
     const { text, markers } = scan(line, 0, false)
     walk(parse(text, (name) => (name === '' ? undefined : `$${name}`)), markers, folder, result)
-  } catch {
+  } catch (error) {
+    if (!(error instanceof SyntaxError) && !(error instanceof Error && error.message.startsWith('Bad substitution: '))) throw error
     result.isFullyParsed = false
   }
 }
@@ -546,7 +547,7 @@ function finish(command: Command, operator: string, folder: string, result: Pars
   const [first, ...args] = words
   if (first === undefined || first.text === 'for' || first.text === 'select') return folder
   const here = command.redirects.findLast((redirect) => redirect.operator === '<<<')
-  const stdin: Stdin | undefined = here !== undefined ? { kind: 'text', text: here.target.text } : command.pipe !== undefined ? { kind: 'pipe' } : undefined
+  const stdin: Stdin | undefined = here !== undefined ? { type: 'text', text: here.target.text } : command.pipe !== undefined ? { type: 'pipe' } : undefined
   const reader = result.commands.length
   const changed = addCommand(first, args, folder, stdin, result)
   const read = result.commands[reader]
@@ -629,7 +630,7 @@ function findStarts(args: Word[]): Word[] {
 
 function addWrapper(first: Word, program: string, args: Word[], folder: string, stdin: Stdin | undefined, result: ParsedShell): void {
   const wrapper = wrappers.get(program)!
-  if (program === 'xargs' && stdin?.kind !== 'text') result.isFullyParsed = false
+  if (program === 'xargs' && stdin?.type !== 'text') result.isFullyParsed = false
   const { options, operands } = readArguments(args, wrapper, true)
   let start = args.length - operands.length
   if (options.some((option) => wrapper.stops?.includes(option.name) === true)) start = args.length
@@ -669,8 +670,8 @@ function addEffects(program: string, args: Word[], flags: string[], folder: stri
   else if (inlineFlags !== undefined) {
     if (program === 'perl' && readArguments(args, perl, false).options.some((option) => option.name === '-i')) addFileArguments(perl, args, folder, result)
     const script = args.find((word) => !word.text.startsWith('-') || word.text === '-')
-    const readsCodeFromPipe = stdin?.kind === 'pipe' && (script === undefined || script.text === '-')
-    if (flags.some((flag) => inlineFlags.includes(flag)) || stdin?.kind === 'text' || readsCodeFromPipe) result.isFullyParsed = false
+    const readsCodeFromPipe = stdin?.type === 'pipe' && (script === undefined || script.text === '-')
+    if (flags.some((flag) => inlineFlags.includes(flag)) || stdin?.type === 'text' || readsCodeFromPipe) result.isFullyParsed = false
   }
 }
 
@@ -701,8 +702,8 @@ function addFetches(fetcher: OptionSpec, args: Word[], result: ParsedShell): voi
 }
 
 function addStdinCode(stdin: Stdin | undefined, folder: string, result: ParsedShell): void {
-  if (stdin?.kind === 'text') parseLine(stdin.text, folder, result)
-  if (stdin?.kind === 'pipe') result.isFullyParsed = false
+  if (stdin?.type === 'text') parseLine(stdin.text, folder, result)
+  if (stdin?.type === 'pipe') result.isFullyParsed = false
 }
 
 function addCopy(program: CopyProgram, args: Word[], folder: string, result: ParsedShell): void {

package/src/utils/paths.ts

@@ -1,4 +1,18 @@
 import { basename, dirname, resolve } from '../vendor.js'
+import { messageOf } from './text.js'
+
+const missingPath = /(?:^|: )(?:ENOENT|ENOTDIR)\b/
+
+export function isMissing(error: unknown): boolean {
+  return missingPath.test(messageOf(error))
+}
+
+export function ifMissing<Value>(value: Value): (error: unknown) => Value {
+  return (error) => {
+    if (isMissing(error)) return value
+    throw error
+  }
+}
 
 export type FileSystem = {
   read: (path: string) => Promise<string>
@@ -6,9 +20,12 @@ export type FileSystem = {
   exists: (path: string) => Promise<boolean>
 }
 
-export function expandHome(path: string, home: string): string {
-  const prefix = /^(~|\$HOME)(?=\/|$)/.exec(path)?.[0]
-  return prefix === undefined ? path : `${home}${path.slice(prefix.length)}`
+export const homePrefix = /^(~|\$HOME|\$CLAUDE_CONFIG_DIR)(?=\/|$)/
+
+export function expandHome(path: string, home: string, configRoot = `${home}/.claude`): string {
+  const prefix = homePrefix.exec(path)?.[0]
+  if (prefix === undefined) return path
+  return `${prefix === '$CLAUDE_CONFIG_DIR' ? configRoot : home}${path.slice(prefix.length)}`
 }
 
 export function relativePath(base: string, path: string): string | undefined {
@@ -18,7 +35,7 @@ export function relativePath(base: string, path: string): string | undefined {
 }
 
 export async function realPathOf(path: string, fs: FileSystem): Promise<string | undefined> {
-  const stat = await fs.stat(path).catch(() => undefined)
+  const stat = await fs.stat(path).catch(ifMissing(undefined))
   if (stat !== undefined || path === '/') return stat?.realPath
   const folder = await realPathOf(dirname(path), fs)
   return folder === undefined ? undefined : resolve(folder, basename(path))

package/src/utils/text.ts

@@ -3,6 +3,10 @@ export function listed(items: readonly string[]): string {
   return `${items.slice(0, -1).join(', ')} and ${items.at(-1)}`
 }
 
+export function firstLine(text: string): string {
+  return text.split('\n').find((line) => line.trim() !== '')?.trim() ?? ''
+}
+
 export function messageOf(error: unknown): string {
   return error instanceof Error ? error.message : String(error)
 }

package/testing/fake-claude.d.ts

@@ -1,3 +1,4 @@
+import type { EventResult } from 'claude-code';
 import type { Claude } from '../runtime/claude.js';
 export type TestCall = {
     readonly call: string;
@@ -28,10 +29,13 @@ export type Fakes = {
         ask?: Claude['ui']['ask'];
         open?: Claude['ui']['open'];
         scroll?: Claude['ui']['scroll'];
+        copy?: Claude['ui']['copy'];
+        focus?: Claude['ui']['focus'];
     };
     session: {
         messages?: Claude['session']['messages'];
         append?: Claude['session']['append'];
+        send?: Claude['session']['send'];
     };
     prompt: {
         submit?: Claude['prompt']['submit'];
@@ -60,7 +64,6 @@ export type ShownSchedule = {
     readonly prompt: string;
 };
 export type Shown = {
-    readonly toasts: string[];
     readonly notes: string[];
     readonly prompts: string[];
     readonly logs: string[];
@@ -79,6 +82,7 @@ export type FakeClaude = {
     readonly store: Map<string, unknown>;
     settle(): Promise<void>;
 };
+export declare function calledAnswer(caller: string, answer: EventResult<'cmod.call'>): unknown;
 export declare function fakeClaude(plugin: {
     readonly name: string;
     readonly root: string;

package/testing/fake-claude.d.ts.map

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

package/testing/fake-claude.js

@@ -1,8 +1,16 @@
+import { isObject } from '../records.js';
 import { elements } from './fake-elements.js';
+import { fakeFiles } from './fake-files.js';
+export function calledAnswer(caller, answer) {
+    if (isObject(answer) && typeof answer['deny'] === 'string')
+        throw new Error(`${caller}: $.cmod.call: ${answer['deny']}`);
+    return isObject(answer) ? answer['value'] : undefined;
+}
 export function fakeClaude(plugin) {
     const calls = [];
     const fakes = { process: {}, fs: {}, http: {}, settings: {}, config: {}, ui: {}, session: {}, prompt: {}, model: {}, agent: {}, clock: {}, cmod: {}, tool: {} };
-    const shown = { toasts: [], notes: [], prompts: [], logs: [], debug: [], statuses: [], openPanes: new Set(), commands: [], tools: [], schedules: [] };
+    const emptyDisk = fakeFiles({});
+    const shown = { notes: [], prompts: [], logs: [], debug: [], statuses: [], openPanes: new Set(), commands: [], tools: [], schedules: [] };
     const unplacedPanes = new Set();
     let focusedPane;
     const store = new Map();
@@ -49,9 +57,6 @@ export function fakeClaude(plugin) {
     const claude = {
         plugin,
         ui: {
-            toast: (text) => {
-                shown.toasts.push(text);
-            },
             status: (text) => {
                 shown.statuses.push(text);
             },
@@ -66,6 +71,7 @@ export function fakeClaude(plugin) {
                 calls.push({ call: 'ui.open', args: [pane] });
                 const answer = fakes.ui.open === undefined ? { isPlaced: true } : await fakes.ui.open(pane);
                 if (answer.isPlaced) {
+                    shown.openPanes.delete(pane.id);
                     shown.openPanes.add(pane.id);
                     unplacedPanes.delete(pane.id);
                     if (pane.focus === true)
@@ -84,10 +90,12 @@ export function fakeClaude(plugin) {
                     focusedPane = undefined;
             },
             panes: async () => [
-                ...[...shown.openPanes].map((id) => ({ id, title: id, isShown: true, isFocused: id === focusedPane, isPlaced: true })),
+                ...[...shown.openPanes].map((id) => ({ id, title: id, isShown: id === [...shown.openPanes].at(-1), isFocused: id === focusedPane, isPlaced: true })),
                 ...[...unplacedPanes].map((id) => ({ id, title: id, isShown: false, isFocused: false, isPlaced: false })),
             ],
             scroll: rejected('ui.scroll', () => fakes.ui.scroll ?? (async () => ({}))),
+            copy: rejected('ui.copy', () => fakes.ui.copy ?? (async () => ({ isCopied: true }))),
+            focus: rejected('ui.focus', () => fakes.ui.focus ?? (async () => ({}))),
             resolve: () => elements,
         },
         process: {
@@ -95,14 +103,14 @@ export function fakeClaude(plugin) {
             spawn: faked('process.spawn', () => fakes.process.spawn),
         },
         fs: {
-            read: rejected('fs.read', () => fakes.fs.read),
-            write: rejected('fs.write', () => fakes.fs.write),
-            list: rejected('fs.list', () => fakes.fs.list),
-            exists: rejected('fs.exists', () => fakes.fs.exists ?? (async () => false)),
-            stat: rejected('fs.stat', () => fakes.fs.stat),
+            read: rejected('fs.read', () => fakes.fs.read ?? emptyDisk.read),
+            write: rejected('fs.write', () => fakes.fs.write ?? emptyDisk.write),
+            list: rejected('fs.list', () => fakes.fs.list ?? emptyDisk.list),
+            exists: rejected('fs.exists', () => fakes.fs.exists ?? emptyDisk.exists),
+            stat: rejected('fs.stat', () => fakes.fs.stat ?? emptyDisk.stat),
         },
         http: { fetch: rejected('http.fetch', () => fakes.http.fetch) },
-        settings: { read: rejected('settings.read', () => fakes.settings.read) },
+        settings: { read: rejected('settings.read', () => fakes.settings.read ?? (async () => ({}))) },
         config: {
             list: rejected('config.list', () => fakes.config.list ?? (async () => [])),
         },
@@ -130,10 +138,11 @@ export function fakeClaude(plugin) {
             root: async () => plugin.root,
             cwd: async () => plugin.root,
             model: async () => 'test-model',
-            usage: async () => ({ context: { window: 200000 }, rateLimits: {}, cost: { usd: 0 } }),
+            usage: async () => ({ startedAt: Date.parse('2026-01-01T00:00:00.000Z'), context: { window: 200000 }, rateLimits: [], cost: { usd: 0 } }),
             surfaces: async () => ['terminal'],
             messages: rejected('session.messages', () => fakes.session.messages),
             append: rejected('session.append', () => fakes.session.append ?? appendNote),
+            send: rejected('session.send', () => fakes.session.send ?? (async () => ({ isDelivered: true }))),
         },
         prompt: { submit: rejected('prompt.submit', () => fakes.prompt.submit ?? submitPrompt) },
         model: { complete: rejected('model.complete', () => fakes.model.complete) },

package/testing/fake-elements.js

@@ -119,8 +119,10 @@ function sideBySide(children, width, gap) {
 function minWidthOf(node) {
     if (typeof node === 'string')
         return 0;
-    const minWidth = insideOf(node).props['minWidth'];
-    return typeof minWidth === 'number' ? minWidth : 0;
+    const { props } = insideOf(node);
+    if (props['flexShrink'] === 0)
+        return Number.POSITIVE_INFINITY;
+    return typeof props['minWidth'] === 'number' ? props['minWidth'] : 0;
 }
 function blankRows(count) {
     return Array.from({ length: count }, () => '');

package/testing/fake-files.js

@@ -37,7 +37,7 @@ export function fakeFiles(files, links = {}) {
         },
         list: async (path) => {
             if (path === undefined)
-                throw new Error('fs.list() lists the working folder, which the fake files do not know. Name the folder, such as fs.list(mod.cwd).');
+                throw new Error('fs.list() lists the working folder, which the fake files do not know. Name the folder, such as fs.list(sessions.current.cwd).');
             const folder = realPathOf(path);
             if (kindOf(folder) !== 'dir')
                 throw new Error(`ENOENT: no such directory, list '${path}'`);

package/testing/fake-sessions.d.ts

@@ -0,0 +1,81 @@
+import { Document } from '../session/context/turn/message/document.js';
+import { Message } from '../session/context/turn/message/message.js';
+import { Note } from '../session/context/turn/message/note.js';
+import { Notice } from '../session/context/turn/message/notice.js';
+import { Prompt } from '../session/context/turn/message/prompt.js';
+import { Reply } from '../session/context/turn/message/reply.js';
+import { type Sender } from '../session/context/turn/message/sender.js';
+import { Skill } from '../session/context/turn/message/skill.js';
+import { ToolCall } from '../session/context/turn/message/tool-call.js';
+import { ToolResult } from '../session/context/turn/message/tool-result.js';
+import { type SessionChange, type SessionData } from '../session/conversation.js';
+import type { Place } from '../runtime/before.js';
+import type { Claude } from '../runtime/claude.js';
+export type MessageDraft = {
+    readonly type: typeof Prompt;
+    readonly text: string;
+    readonly from?: Sender;
+} | {
+    readonly type: typeof Note;
+    readonly text: string;
+    readonly from?: Sender;
+} | {
+    readonly type: typeof Reply;
+    readonly text: string;
+} | {
+    readonly type: typeof ToolCall;
+    readonly name: string;
+    readonly input?: Readonly<Record<string, unknown>>;
+    readonly callId?: string;
+} | {
+    readonly type: typeof ToolResult;
+    readonly callId: string;
+    readonly text: string;
+    readonly isError?: boolean;
+} | {
+    readonly type: typeof Skill;
+    readonly name: string;
+    readonly text: string;
+} | {
+    readonly type: typeof Document;
+    readonly path: string;
+    readonly text: string;
+} | {
+    readonly type: typeof Notice;
+    readonly text: string;
+};
+export type FakeSession = Partial<Omit<SessionData, 'id'>> & {
+    readonly id: string;
+    readonly messages?: readonly MessageDraft[];
+    readonly goal?: string;
+};
+export type FakeSessions = {
+    answer(caller: string, method: string, input: unknown): unknown;
+    add(draft: MessageDraft, task?: string): Message[];
+    place(): Place;
+    wants(mod: string, event: string): boolean;
+    endTurn(): void;
+    compact(): void;
+    startTask(task: {
+        readonly title: string;
+        readonly agentType?: string;
+        readonly model?: string;
+        readonly openedBy?: string;
+        readonly parent?: string;
+    }): string;
+    start(id: string): void;
+    readonly sent: {
+        readonly session: string;
+        readonly task?: string;
+        readonly type: string;
+        readonly text: string;
+        readonly as?: string;
+    }[];
+};
+export declare function fakeSessions({ project, given, push, callTool }: {
+    readonly project: () => string;
+    readonly given: readonly FakeSession[];
+    readonly push: (mod: string, session: string, change: SessionChange) => void;
+    readonly callTool: Claude['tool']['call'];
+}): FakeSessions;
+//# sourceMappingURL=fake-sessions.d.ts.map

package/testing/fake-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-sessions.d.ts","sourceRoot":"","sources":["../src/testing/fake-sessions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAA;AACtE,OAAO,EAAE,OAAO,EAAqC,MAAM,4CAA4C,CAAA;AACvG,OAAO,EAAE,IAAI,EAAE,MAAM,yCAAyC,CAAA;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAClE,OAAO,EAAE,KAAK,EAAE,MAAM,0CAA0C,CAAA;AAChE,OAAO,EAAyB,KAAK,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAG9F,OAAO,EAAE,KAAK,EAAE,MAAM,0CAA0C,CAAA;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,8CAA8C,CAAA;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,gDAAgD,CAAA;AAC3E,OAAO,EAA2F,KAAK,aAAa,EAAE,KAAK,WAAW,EAAgC,MAAM,4BAA4B,CAAA;AACxM,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAKlD,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/E;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7E;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACvI;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAChH;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7E;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,QAAQ,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChF;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAE3D,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,GAAG;IAC3D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IAC3C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAcD,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAA;IAC/D,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAAA;IAClD,KAAK,IAAI,KAAK,CAAA;IACd,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IAC1C,OAAO,IAAI,IAAI,CAAA;IACf,OAAO,IAAI,IAAI,CAAA;IACf,SAAS,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAA;IAC/J,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC1I,CAAA;AAED,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;CAAE,GAAG,YAAY,CA0MlR"}