@appinternalleads/ui 0.2.0

package/dist/esm/components/checklist/process.js

@@ -0,0 +1,65 @@
+import { allTasks, validateChecklistConfig, validateChecklistRules, } from './contract';
+import { normalizeChecklistDocument } from './engine';
+/** Shape checks that belong to neither validator: identity and uniqueness. */
+function documentIssues(checklist) {
+    const issues = [];
+    if (checklist.title.trim() === '') {
+        issues.push({ stage: 'document', message: 'Add a title before generating the checklist.' });
+    }
+    if (checklist.sections.length === 0) {
+        issues.push({ stage: 'document', message: 'Add at least one section before generating the checklist.' });
+    }
+    /* Ids are the vocabulary every rule and every change names. A duplicate makes `findTask`
+       ambiguous and an inverse unreliable, so it is caught before anything is generated. */
+    const seen = new Set();
+    const dupes = new Set();
+    for (const id of [...checklist.sections.map(s => s.id), ...allTasks(checklist).map(t => t.id)]) {
+        if (id.trim() === '')
+            dupes.add('(blank)');
+        else if (seen.has(id))
+            dupes.add(id);
+        else
+            seen.add(id);
+    }
+    for (const id of dupes) {
+        issues.push({ stage: 'document', message: `Two things share the id “${id}”. Give each section and task its own.` });
+    }
+    const untitled = allTasks(checklist).filter(t => t.title.trim() === '').length;
+    if (untitled > 0) {
+        issues.push({
+            stage: 'document',
+            message: untitled === 1 ? 'One task has no title. Name it before generating.'
+                : `${untitled} tasks have no title. Name them before generating.`,
+        });
+    }
+    return issues;
+}
+/**
+ * Normalise, then validate, then generate. The stages are separable on purpose: the Playground's
+ * inspector shows candidate → normalized → validated → generated, and each of those is a real
+ * value rather than a label.
+ */
+export function processChecklistDocument(candidate, opts = {}) {
+    const normalized = normalizeChecklistDocument(candidate);
+    const issues = [
+        ...documentIssues(normalized.checklist),
+        ...validateChecklistConfig(normalized.config, {
+            checklist: normalized.checklist, rules: normalized.rules, capabilities: opts.capabilities,
+        }).map((message) => ({ stage: 'config', message })),
+        ...validateChecklistRules(normalized.rules, normalized.checklist, opts.capabilities).rejected
+            .map(({ rule, message }) => ({
+            stage: 'rules',
+            message: `Resolve the invalid rule “${rule.id}” before generating: ${message}.`,
+        })),
+    ];
+    if (issues.length)
+        return { ok: false, normalized, document: null, issues };
+    return { ok: true, normalized, document: normalized, issues: [] };
+}
+/** A blank, valid-shaped starting point: one untitled section, which is how `checklist/1` spells
+    "ungrouped". Deliberately **without** a title — naming it is the creator's first act, and the
+    processing pipeline says so until they do. */
+export function blankChecklist(id) {
+    return { id, title: '', sections: [{ id: `${id}-s1`, tasks: [] }] };
+}
+//# sourceMappingURL=process.js.map

package/dist/esm/components/checklist/process.js.map

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

package/dist/esm/components/checklist/runtime.d.ts

@@ -0,0 +1,117 @@
+import { type AppError } from '../../runtime/operations';
+import { type Checklist, type ChecklistCapabilities, type ChecklistChange, type ChecklistChangeBody, type ChecklistConfig, type ChecklistEffect, type ChecklistOperations, type ChecklistRule, type FilterAuthor, type ChecklistRuleRejection, type ShareRequest, type ShareResult } from './contract';
+import { type ChangeRejection } from './engine';
+/**
+ * **The Checklist runtime — §7, §15, §16.**
+ *
+ * `Data + Config + Rules → Runtime → UI`. It owns exactly three things: the authoritative
+ * document, the lifecycle of every change in flight, and the lifecycle of the two boundary
+ * operations. It owns no progress, no completion count and no section status — those are derived
+ * (`derive.ts`), which is what makes §15's invariant a property of the architecture rather than a
+ * promise.
+ *
+ * **It is not a query machine.** There is no epoch and no single in-flight slot: every change has
+ * its own independent lifecycle through `src/runtime/operations`, so ticking three tasks quickly
+ * is three independent facts and the third does not cancel the first.
+ */
+/** §16: no spinner before this. Below it a spinner is a flash that makes a fast system look unreliable. */
+export declare const SLOW_THRESHOLD_MS = 500;
+export type PendingChange = {
+    change: ChecklistChange;
+    status: 'pending' | 'error';
+    error: AppError | null;
+    /**
+     * Has this change been in flight past `SLOW_THRESHOLD_MS`? The *only* timer outside the mock
+     * operations, and it is a presentation threshold rather than transport simulation: the view must
+     * stay a pure render of runtime state, so the clock that decides "this is slow now" belongs here
+     * and not in a row component.
+     */
+    slow: boolean;
+};
+export type RejectedRule = {
+    rule: ChecklistRule;
+    author: FilterAuthor;
+    reason: ChecklistRuleRejection;
+    message: string;
+};
+/**
+ * `pending` here means "decided due and not yet settled" — which covers both *in flight at the
+ * host* and *no host took it*. Delivery state never enters the document; this is session state.
+ */
+export type EffectRecord = {
+    effect: ChecklistEffect;
+    status: 'pending' | 'ok' | 'error';
+    error: AppError | null;
+};
+/**
+ * One share operation. A share to three people with different tasks each is **three requests**,
+ * because `ShareRequest` carries one `taskIds[]` for all its `recipients[]` — so per-recipient
+ * scoping is one request per recipient rather than a contract change (Phase 2, P2-5).
+ */
+export type SharePart = {
+    request: ShareRequest;
+    status: 'pending' | 'ok' | 'error';
+    result: ShareResult | null;
+    error: AppError | null;
+};
+export type ShareState = {
+    /** The aggregate: pending while any part is, error if any failed, ok when all landed. */
+    status: 'idle' | 'pending' | 'ok' | 'error';
+    /** The first request of the batch — the shape V1 exposed, unchanged for a single share. */
+    request: ShareRequest | null;
+    /** Aggregated across parts: everyone the host confirmed, deduplicated. */
+    result: ShareResult | null;
+    error: AppError | null;
+    /** Per-request detail. One entry for a whole-checklist share; one per recipient otherwise. */
+    parts: SharePart[];
+};
+export type ChecklistRuntimeState = {
+    /** The authoritative document, optimistically up to date. */
+    doc: Checklist;
+    /** One entry per change still in flight or failed. Empty in the happy, settled case. */
+    pending: PendingChange[];
+    /** Rules refused by `validateChecklistRule` — reported, never swallowed. */
+    rejectedRules: RejectedRule[];
+    /** The notifications the rules decided were due, and what became of each. */
+    effects: EffectRecord[];
+    share: ShareState;
+    /** Every change the runtime has attempted, newest last — the inspector's log. */
+    log: {
+        change: ChecklistChange;
+        outcome: 'ok' | 'error' | 'pending' | 'refused';
+        message?: string;
+    }[];
+};
+export type ChecklistRuntimeOptions = {
+    checklist: Checklist;
+    config: ChecklistConfig;
+    rules?: ChecklistRule[];
+    operations?: ChecklistOperations;
+    capabilities?: ChecklistCapabilities;
+    /** A session fact, never document state (§10) — who this checklist is currently shared with. */
+    sharedWith?: string[];
+    onChange?: (doc: Checklist, change: ChecklistChange) => void;
+};
+export type ChecklistRuntime = {
+    state: ChecklistRuntimeState;
+    /** The rules that survived validation. The view renders gates from these, never from the raw set. */
+    rules: ChecklistRule[];
+    /**
+     * Attempt a change. Returns `null` when it was accepted (and is now optimistically applied), or
+     * the rejection when the document itself refused it — a gate, a vanished id, a capability that
+     * is off. A refusal never reaches the host: nothing is sent.
+     */
+    apply: (body: ChecklistChangeBody, author?: FilterAuthor) => ChangeRejection | null;
+    /** Re-attempt a failed change. The same change, attempted afresh — not a reload. */
+    retry: (changeId: string) => void;
+    /** Drop a failed change from view. The rollback already happened; this clears the message. */
+    dismiss: (changeId: string) => void;
+    share: (req: ShareRequest) => void;
+    /** Several requests as one batch — how per-recipient task scoping is expressed. */
+    shareEach: (requests: ShareRequest[]) => void;
+    retryShare: () => void;
+    dismissShare: () => void;
+    retryEffect: (effectId: string) => void;
+};
+export declare function useChecklistRuntime(opts: ChecklistRuntimeOptions): ChecklistRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/esm/components/checklist/runtime.d.ts.map

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

package/dist/esm/components/checklist/runtime.js

@@ -0,0 +1,253 @@
+'use client';
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { useOperationRunner } from '../../runtime/operations';
+import { validateChecklistRules, } from './contract';
+import { applyChange } from './engine';
+/**
+ * **The Checklist runtime — §7, §15, §16.**
+ *
+ * `Data + Config + Rules → Runtime → UI`. It owns exactly three things: the authoritative
+ * document, the lifecycle of every change in flight, and the lifecycle of the two boundary
+ * operations. It owns no progress, no completion count and no section status — those are derived
+ * (`derive.ts`), which is what makes §15's invariant a property of the architecture rather than a
+ * promise.
+ *
+ * **It is not a query machine.** There is no epoch and no single in-flight slot: every change has
+ * its own independent lifecycle through `src/runtime/operations`, so ticking three tasks quickly
+ * is three independent facts and the third does not cancel the first.
+ */
+/** §16: no spinner before this. Below it a spinner is a flash that makes a fast system look unreliable. */
+export const SLOW_THRESHOLD_MS = 500;
+/** Roll the parts up into the four fields a reader sees. */
+function aggregateShare(parts) {
+    if (!parts.length)
+        return { status: 'idle', request: null, result: null, error: null, parts };
+    const status = parts.some(p => p.status === 'pending') ? 'pending'
+        : parts.some(p => p.status === 'error') ? 'error' : 'ok';
+    const sharedWith = [...new Set(parts.flatMap(p => p.result?.sharedWith ?? []))];
+    const url = parts.find(p => p.result?.url)?.result?.url;
+    return {
+        status,
+        request: parts[0].request,
+        result: status === 'ok' ? { sharedWith, ...(url ? { url } : {}) } : null,
+        error: parts.find(p => p.error)?.error ?? null,
+        parts,
+    };
+}
+let instances = 0;
+export function useChecklistRuntime(opts) {
+    const { checklist, config, operations, capabilities, sharedWith, onChange } = opts;
+    const rawRules = useMemo(() => opts.rules ?? [], [opts.rules]);
+    /**
+     * **One primitive, two authors, and rejections are reported.** The rule set is validated against
+     * the document before anything renders — an agent cannot name a task that does not exist any more
+     * than a person can, and a rule that names one is surfaced in `rejectedRules` rather than
+     * silently dropped (`docs/architecture/FILTER-CONTRACT.md` N1, clause 5).
+     */
+    const validated = useMemo(() => validateChecklistRules(rawRules, checklist, capabilities), [rawRules, checklist, capabilities]);
+    const [doc, setDoc] = useState(checklist);
+    const [pending, setPending] = useState([]);
+    const [effects, setEffects] = useState([]);
+    const [share, setShare] = useState(aggregateShare([]));
+    const [log, setLog] = useState([]);
+    const docRef = useRef(doc);
+    docRef.current = doc;
+    const runner = useOperationRunner();
+    /* Ids are per-runtime and monotonic — never `Date.now()`/`Math.random()`, so a story, a test and
+       an SSR pass all produce the same log. The instance prefix keeps two mounted checklists apart
+       in one inspector. */
+    const prefix = useMemo(() => { instances += 1; return `c${instances}`; }, []);
+    const counter = useRef(0);
+    const nextId = () => { counter.current += 1; return `${prefix}-${counter.current}`; };
+    /**
+     * Reseed when the document handed in genuinely differs from the one held. The builder owns the
+     * document in the Playground and edits it structurally; its own `onChange` echo produces a new
+     * reference with identical content, which must NOT reseed or the two would fight.
+     */
+    const seeded = useRef(JSON.stringify(checklist));
+    useEffect(() => {
+        const incoming = JSON.stringify(checklist);
+        if (incoming === seeded.current)
+            return;
+        seeded.current = incoming;
+        if (incoming === JSON.stringify(docRef.current))
+            return;
+        setDoc(checklist);
+    }, [checklist]);
+    /* The slow threshold. One timer per pending change, cleared when it settles. */
+    const timers = useRef(new Map());
+    useEffect(() => {
+        const live = timers.current;
+        return () => { for (const t of live.values())
+            clearTimeout(t); live.clear(); };
+    }, []);
+    const clearTimer = useCallback((id) => {
+        const t = timers.current.get(id);
+        if (t) {
+            clearTimeout(t);
+            timers.current.delete(id);
+        }
+    }, []);
+    const settleEffects = useCallback((produced) => {
+        if (!produced.length)
+            return;
+        /* `sharedWith` is a session fact the pure engine cannot know, so the runtime completes it here
+           (§11). An effect with no recipient at all is still recorded — "due, to nobody resolvable" is
+           information, and dropping it would hide a misconfigured rule. */
+        const resolved = produced.map(e => (e.audience === 'sharedWith' ? { ...e, recipients: sharedWith ?? [] } : e));
+        setEffects(prev => [...prev, ...resolved.map(effect => ({ effect, status: 'pending', error: null }))]);
+        if (!config.notifications.enabled || !operations?.notify)
+            return;
+        for (const effect of resolved) {
+            const request = {
+                channel: effect.channel,
+                to: effect.recipients,
+                event: effect.event,
+                checklist: effect.checklist,
+                task: effect.task,
+            };
+            runner.run(`effect:${effect.id}`, ctx => operations.notify(request, ctx), {
+                onOk: () => setEffects(prev => prev.map(r => (r.effect.id === effect.id ? { ...r, status: 'ok', error: null } : r))),
+                onError: error => setEffects(prev => prev.map(r => (r.effect.id === effect.id ? { ...r, status: 'error', error } : r))),
+            });
+        }
+    }, [config.notifications.enabled, operations, runner, sharedWith]);
+    /** Roll back exactly, using the inverse the engine returned. Never a reload. */
+    const rollback = useCallback((inverse) => {
+        setDoc(prev => {
+            const undone = applyChange(prev, inverse, validated.accepted);
+            return undone.ok ? undone.next : prev;
+        });
+    }, [validated.accepted]);
+    const commit = useCallback((change, inverse) => {
+        if (!operations)
+            return; // local-only mode: applied, nothing to persist, nothing to fail
+        clearTimer(change.id);
+        timers.current.set(change.id, setTimeout(() => {
+            setPending(prev => prev.map(p => (p.change.id === change.id ? { ...p, slow: true } : p)));
+        }, SLOW_THRESHOLD_MS));
+        runner.run(change.id, ctx => operations.commit(change, { doc: docRef.current, signal: ctx.signal }), {
+            onOk: () => {
+                clearTimer(change.id);
+                setPending(prev => prev.filter(p => p.change.id !== change.id));
+                setLog(prev => prev.map(l => (l.change.id === change.id ? { ...l, outcome: 'ok' } : l)));
+            },
+            onError: error => {
+                clearTimer(change.id);
+                rollback(inverse);
+                setPending(prev => prev.map(p => (p.change.id === change.id ? { ...p, status: 'error', error, slow: false } : p)));
+                setLog(prev => prev.map(l => (l.change.id === change.id ? { ...l, outcome: 'error', message: error.message } : l)));
+            },
+        });
+    }, [operations, runner, rollback, clearTimer]);
+    const apply = useCallback((body, author = 'user') => {
+        const change = { ...body, id: nextId(), author };
+        const result = applyChange(docRef.current, change, validated.accepted, { config });
+        if (!result.ok) {
+            setLog(prev => [...prev, { change, outcome: 'refused', message: result.message }]);
+            return { reason: result.reason, message: result.message };
+        }
+        /* Optimistic: the document moves NOW. The host is told afterwards, and a rejection rolls the
+           document back with the exact inverse this result carries. */
+        docRef.current = result.next;
+        setDoc(result.next);
+        onChange?.(result.next, change);
+        setLog(prev => [...prev, { change, outcome: operations ? 'pending' : 'ok' }]);
+        if (operations) {
+            setPending(prev => [...prev, { change, status: 'pending', error: null, slow: false }]);
+            commit(change, result.inverse);
+        }
+        settleEffects(result.effects);
+        return null;
+    }, [validated.accepted, config, onChange, operations, commit, settleEffects]);
+    const retry = useCallback((changeId) => {
+        const entry = pending.find(p => p.change.id === changeId);
+        if (!entry || entry.status !== 'error')
+            return;
+        /* Re-applied from the CURRENT document: the rollback already happened, so a retry is the same
+           change attempted afresh rather than a replay of a stale document. */
+        const result = applyChange(docRef.current, entry.change, validated.accepted, { config });
+        if (!result.ok) {
+            setPending(prev => prev.filter(p => p.change.id !== changeId));
+            setLog(prev => [...prev, { change: entry.change, outcome: 'refused', message: result.message }]);
+            return;
+        }
+        docRef.current = result.next;
+        setDoc(result.next);
+        onChange?.(result.next, entry.change);
+        setPending(prev => prev.map(p => (p.change.id === changeId ? { ...p, status: 'pending', error: null, slow: false } : p)));
+        setLog(prev => prev.map(l => (l.change.id === changeId ? { ...l, outcome: 'pending', message: undefined } : l)));
+        commit(entry.change, result.inverse);
+        settleEffects(result.effects);
+    }, [pending, validated.accepted, config, onChange, commit, settleEffects]);
+    const dismiss = useCallback((changeId) => {
+        clearTimer(changeId);
+        setPending(prev => prev.filter(p => p.change.id !== changeId));
+    }, [clearTimer]);
+    const runParts = useCallback((requests) => {
+        if (!requests.length)
+            return;
+        if (!operations?.share) {
+            /* Sharing configured on with no host to do it is a configuration fact, said plainly rather
+               than a button that does nothing. */
+            setShare(aggregateShare(requests.map(request => ({
+                request, status: 'error', result: null,
+                error: { message: 'Sharing is not set up here', retryable: false },
+            }))));
+            return;
+        }
+        setShare(aggregateShare(requests.map(request => ({ request, status: 'pending', result: null, error: null }))));
+        requests.forEach((request, i) => {
+            runner.run(`share:${i}`, ctx => operations.share(request, ctx), {
+                onOk: result => setShare(prev => aggregateShare(prev.parts.map((p, j) => (j === i ? { ...p, status: 'ok', result, error: null } : p)))),
+                onError: error => setShare(prev => aggregateShare(prev.parts.map((p, j) => (j === i ? { ...p, status: 'error', result: null, error } : p)))),
+            });
+        });
+    }, [operations, runner]);
+    const runShare = useCallback((req) => runParts([req]), [runParts]);
+    const retryShare = useCallback(() => {
+        setShare(prev => {
+            /* Retry the parts that failed, not the whole batch — a share that landed is not re-sent. */
+            const failed = prev.parts.filter(p => p.status === 'error').map(p => p.request);
+            if (failed.length)
+                runParts(failed.length === prev.parts.length ? prev.parts.map(p => p.request) : failed);
+            return prev;
+        });
+    }, [runParts]);
+    const retryEffect = useCallback((effectId) => {
+        const record = effects.find(e => e.effect.id === effectId);
+        if (!record || !operations?.notify)
+            return;
+        const { effect } = record;
+        setEffects(prev => prev.map(r => (r.effect.id === effectId ? { ...r, status: 'pending', error: null } : r)));
+        const request = {
+            channel: effect.channel, to: effect.recipients, event: effect.event,
+            checklist: effect.checklist, task: effect.task,
+        };
+        runner.run(`effect:${effect.id}`, ctx => operations.notify(request, ctx), {
+            onOk: () => setEffects(prev => prev.map(r => (r.effect.id === effectId ? { ...r, status: 'ok', error: null } : r))),
+            onError: error => setEffects(prev => prev.map(r => (r.effect.id === effectId ? { ...r, status: 'error', error } : r))),
+        });
+    }, [effects, operations, runner]);
+    const state = useMemo(() => ({
+        doc,
+        pending,
+        rejectedRules: validated.rejected,
+        effects,
+        share,
+        log,
+    }), [doc, pending, validated.rejected, effects, share, log]);
+    return {
+        state,
+        rules: validated.accepted,
+        apply,
+        retry,
+        dismiss,
+        share: runShare,
+        shareEach: runParts,
+        retryShare,
+        dismissShare: () => setShare(aggregateShare([])),
+        retryEffect,
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/esm/components/checklist/runtime.js.map

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

package/dist/esm/components/directory/DirectoryView.d.ts

@@ -0,0 +1,51 @@
+import { type DataAdapter } from '../../runtime/query';
+import { type DirectoryConfig, type DirectoryRule, type DirectorySchema } from './contract';
+/**
+ * **Directory — the component.** Search, narrow, page, open a record.
+ *
+ * Everything it draws comes from the schema it was handed: the row's heading is whatever column
+ * the configuration names as primary, the facets are whatever columns were configured from the
+ * discovered ones, the detail panel lists whatever columns are configured. **There is not one
+ * column name in this file**, which is the point — a Directory over a different source renders
+ * differently without a line changing here.
+ *
+ * It owns its query lifecycle through the shared runtime (`src/runtime/query`) — the same
+ * epoch-guarded, abortable machine the Output `list` renderer uses. It is *not* `list`: different
+ * family, different contract (`DirectoryConfig`/`DirectoryRule`, not an `output/1` document), and
+ * a builder places it rather than an agent emitting it.
+ *
+ * The host owns transport: either pass a `DataAdapter`, or pass `records` already read from the
+ * source and the component queries them in memory through the runtime's deterministic adapter.
+ */
+export type DirectoryRecord = {
+    id: string;
+    data: Record<string, string>;
+};
+export type DirectoryViewProps = {
+    schema: DirectorySchema;
+    config: DirectoryConfig;
+    /** User-authored and agent-authored rules, in one list — provenance is the `author` field. */
+    rules?: DirectoryRule[];
+    /** The host's transport. Omit to query `records` in memory. */
+    adapter?: DataAdapter;
+    records?: DirectoryRecord[];
+    onSelect?: (id: string) => void;
+    testID?: string;
+};
+declare const chipRadius = 999;
+/**
+ * **A new source is a new Directory.**
+ *
+ * Everything the view holds — the search text, the chips, the sort column, the page, the open
+ * record — is expressed in the *current* schema's column keys. Carry it across a reconnection and
+ * every one of them is a key the new source has never heard of: the rows come back, the query
+ * still holds the old sheet's filter, and the headings render blank. So the source identity is a
+ * remount boundary, and the identity is the columns themselves rather than the URL, because a
+ * builder reconnecting the same sheet after a column changed is exactly the case that breaks.
+ *
+ * Deliberately *not* keyed on the configuration: editing what a reader sees must not throw away
+ * what they were looking at, which is the whole reason the builder can preview live.
+ */
+export declare function DirectoryView(props: DirectoryViewProps): import("react").JSX.Element;
+export { chipRadius as DIRECTORY_CHIP_RADIUS };
+//# sourceMappingURL=DirectoryView.d.ts.map

package/dist/esm/components/directory/DirectoryView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DirectoryView.d.ts","sourceRoot":"","sources":["../../../../src/components/directory/DirectoryView.tsx"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEiB,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EACrF,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,eAAe,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAE3E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,eAAe,CAAC;IACxB,8FAA8F;IAC9F,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,QAAA,MAAM,UAAU,MAAM,CAAC;AAmIvB;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,+BAItD;AAqOD,OAAO,EAAE,UAAU,IAAI,qBAAqB,EAAE,CAAC"}