@ketvietlab/ketjs 0.1.2 → 0.1.3

package/dist/kernel/layout.d.ts

@@ -2,16 +2,113 @@ import type { Manifest } from '../types.ts';
 export type Placement = {
     type: string;
     settings?: Record<string, unknown>;
+    /**
+     * Stable identity, assigned on save. Optional on the way in - a caller may
+     * omit it and be given one - and present on everything that has been stored.
+     */
+    id?: string;
+    /** Sections this one holds, by the slot name its type declares. */
+    slots?: Record<string, Placement[]>;
 };
 export type LayoutError = {
+    /** Index within the parent's list. Kept for callers written before nesting. */
     at: number;
     type: string;
     field?: string;
+    /** Where in the tree, as `index.slot.index`. Absent at the top level. */
+    path?: string;
     message: string;
 };
+/** A page is a page, not a filesystem: deep enough for real work, and bounded. */
+export declare const MAX_LAYOUT_DEPTH = 6;
+/**
+ * Nodes in the whole tree, not placements at the top.
+ *
+ * The old ceiling was a hundred top-level placements. Counting the tree instead
+ * keeps the same number honest: without it, a hundred containers each holding a
+ * hundred children would pass a check that was written to bound a page.
+ */
+export declare const MAX_LAYOUT_NODES = 100;
+/** Every placement in the tree, parents before children. */
+export declare const walkPlacements: (layout: readonly Placement[], path?: string) => Generator<{
+    placement: Placement;
+    at: number;
+    path: string;
+}>;
+export declare const countPlacements: (layout: readonly Placement[]) => number;
 export declare function validateLayout(manifest: Manifest, layout: unknown): {
     ok: boolean;
     errors: LayoutError[];
 };
 export declare const formatLayoutErrors: (errors: LayoutError[]) => string;
+/** A placement id is opaque, but it has to survive a round trip through JSON. */
+export declare const isPlacementId: (value: unknown) => value is string;
+export type IdentifiedPlacement = Placement & {
+    id: string;
+};
+/**
+ * Give every placement in the tree an id, deriving one only where none exists.
+ *
+ * Derived from the content, not the position, and disambiguated by how many
+ * identical placements came before it. Deriving from the index instead would
+ * mean that the first save after a reorder - the one that turns legacy content
+ * into identified content - renamed everything it touched, which is precisely
+ * the case the id exists to distinguish.
+ *
+ * A subtree is part of what a container says, so the derivation walks children
+ * first and folds their ids in: two containers holding different things are
+ * different containers, even when their own settings match.
+ *
+ * An id already present is never replaced, so identity survives every later
+ * save regardless of what this function would have derived.
+ */
+export declare const withPlacementIds: (layout: readonly Placement[], digest: (input: string) => string, seen?: Map<string, number>) => IdentifiedPlacement[];
+/** Ids a layout cannot have: malformed, or the same one twice anywhere in it. */
+export declare const placementIdErrors: (layout: readonly Placement[]) => LayoutError[];
+export type PlacementChange = {
+    id: string;
+    type: string;
+    change: 'added';
+    at: number;
+    path: string;
+} | {
+    id: string;
+    type: string;
+    change: 'removed';
+    at: number;
+    path: string;
+} | {
+    id: string;
+    type: string;
+    change: 'moved';
+    from: string;
+    at: number;
+    path: string;
+} | {
+    id: string;
+    type: string;
+    change: 'settings';
+    at: number;
+    path: string;
+    fields: string[];
+} | {
+    id: string;
+    type: string;
+    change: 'retyped';
+    at: number;
+    path: string;
+    from: string;
+};
+/**
+ * What changed between two layouts, said per placement rather than per index.
+ *
+ * The walk is the whole tree, so a setting changed six levels down is reported
+ * on the node that changed. Comparing only the top level would have folded a
+ * subtree edit into "the container's settings are the same" and said nothing.
+ *
+ * Only placements carrying ids can be compared this way. Anything without one
+ * is reported as removed and added, which is the truthful answer: with no id
+ * there is no evidence the two are the same section.
+ */
+export declare const diffPlacements: (before: readonly Placement[], after: readonly Placement[]) => PlacementChange[];
 //# sourceMappingURL=layout.d.ts.map

package/dist/kernel/layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../../../packages/ketjs/src/kernel/layout.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAA;AAC5E,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAcvF,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAA;CAAE,CAwD1G;AAED,eAAO,MAAM,kBAAkB,WAAY,WAAW,EAAE,KAAG,MACwC,CAAA"}
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../../../packages/ketjs/src/kernel/layout.ts"],"names":[],"mappings":"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"}

package/dist/kernel/layout.js

@@ -2,10 +2,21 @@
 //
 // This is the payoff for making sections data rather than code: what an agent
 // writes can be checked before it is stored, against the same declaration the
-// theme renders from. A bad section type, a missing required setting, or a setting
-// of the wrong shape are all caught here — as a list, not as an exception, because
-// a list is what an agent can act on.
+// theme renders from. A bad section type, a missing required setting, a setting
+// of the wrong shape, a child in a slot that does not accept it - all caught
+// here, as a list rather than an exception, because a list is what an agent can
+// act on.
 import { isDateText, parseType } from './types.js';
+/** A page is a page, not a filesystem: deep enough for real work, and bounded. */
+export const MAX_LAYOUT_DEPTH = 6;
+/**
+ * Nodes in the whole tree, not placements at the top.
+ *
+ * The old ceiling was a hundred top-level placements. Counting the tree instead
+ * keeps the same number honest: without it, a hundred containers each holding a
+ * hundred children would pass a check that was written to bound a page.
+ */
+export const MAX_LAYOUT_NODES = 100;
 const JS_OF = {
     id: 'string',
     text: 'string',
@@ -17,18 +28,55 @@ const JS_OF = {
     datetime: 'string',
     json: 'object',
 };
+const slotsOf = (placement) => {
+    const slots = placement.slots;
+    if (!slots || typeof slots !== 'object' || Array.isArray(slots))
+        return [];
+    return Object.entries(slots).map(([name, children]) => [name, Array.isArray(children) ? children : []]);
+};
+/** Every placement in the tree, parents before children. */
+export const walkPlacements = function* (layout, path = '') {
+    for (let at = 0; at < layout.length; at += 1) {
+        const placement = layout[at];
+        const here = path ? `${path}.${at}` : String(at);
+        yield { placement, at, path: here };
+        if (!placement || typeof placement !== 'object')
+            continue;
+        for (const [slot, children] of slotsOf(placement))
+            yield* walkPlacements(children, `${here}.${slot}`);
+    }
+};
+export const countPlacements = (layout) => {
+    let total = 0;
+    for (const _ of walkPlacements(layout))
+        total += 1;
+    return total;
+};
 export function validateLayout(manifest, layout) {
-    const errors = [];
     if (!Array.isArray(layout)) {
         return {
             ok: false,
             errors: [{ at: -1, type: '(layout)', message: 'a layout must be an array of section placements' }],
         };
     }
+    const errors = [];
+    const nodes = countPlacements(layout);
+    if (nodes > MAX_LAYOUT_NODES)
+        errors.push({
+            at: -1,
+            type: '(layout)',
+            message: `holds ${nodes} sections, and a page may hold ${MAX_LAYOUT_NODES}`,
+        });
+    validateInto(manifest, layout, errors, '', 1);
+    return { ok: errors.length === 0, errors };
+}
+const validateInto = (manifest, layout, errors, path, depth) => {
     layout.forEach((raw, at) => {
+        const here = path ? `${path}.${at}` : String(at);
+        const nested = path ? { path: here } : {};
         const placement = raw;
         if (!placement || typeof placement.type !== 'string') {
-            errors.push({ at, type: '(unknown)', message: 'each placement needs a "type"' });
+            errors.push({ at, type: '(unknown)', ...nested, message: 'each placement needs a "type"' });
             return;
         }
         const section = manifest.sections[placement.type];
@@ -36,7 +84,8 @@ export function validateLayout(manifest, layout) {
             errors.push({
                 at,
                 type: placement.type,
-                message: `no installed module provides this section (available: ${Object.keys(manifest.sections).join(', ') || 'none'})`,
+                ...nested,
+                message: `no composed module provides this section (available: ${Object.keys(manifest.sections).join(', ') || 'none'})`,
             });
             return;
         }
@@ -47,17 +96,29 @@ export function validateLayout(manifest, layout) {
             const value = settings[field];
             if (value == null) {
                 if (t.ok && !t.optional)
-                    errors.push({ at, type: placement.type, field, message: `is required (${spec})` });
+                    errors.push({ at, type: placement.type, field, ...nested, message: `is required (${spec})` });
                 continue;
             }
             if (!t.ok)
                 continue;
             const want = JS_OF[t.base];
             if (want && typeof value !== want) {
-                errors.push({ at, type: placement.type, field, message: `expects ${t.base}, got ${typeof value}` });
+                errors.push({
+                    at,
+                    type: placement.type,
+                    field,
+                    ...nested,
+                    message: `expects ${t.base}, got ${typeof value}`,
+                });
             }
             else if (t.base === 'date' && !isDateText(value)) {
-                errors.push({ at, type: placement.type, field, message: 'expects date in YYYY-MM-DD format' });
+                errors.push({
+                    at,
+                    type: placement.type,
+                    field,
+                    ...nested,
+                    message: 'expects date in YYYY-MM-DD format',
+                });
             }
         }
         for (const field of Object.keys(settings)) {
@@ -66,12 +127,233 @@ export function validateLayout(manifest, layout) {
                     at,
                     type: placement.type,
                     field,
+                    ...nested,
                     message: `is not a setting of this section (accepted: ${Object.keys(schema).join(', ') || 'none'})`,
                 });
             }
         }
+        validateSlots(manifest, placement, section.slots ?? {}, errors, at, here, depth);
     });
-    return { ok: errors.length === 0, errors };
-}
-export const formatLayoutErrors = (errors) => errors.map((e) => `  [${e.at}] ${e.type}${e.field ? '.' + e.field : ''} ${e.message}`).join('\n');
+};
+const validateSlots = (manifest, placement, declared, errors, at, here, depth) => {
+    for (const [slot, children] of slotsOf(placement)) {
+        const rule = declared[slot];
+        if (!rule) {
+            // A section that declares no slot for this name cannot hold anything
+            // under it. Silently dropping the children would lose an author's work
+            // between the save and the render.
+            errors.push({
+                at,
+                type: placement.type,
+                field: slot,
+                path: `${here}.${slot}`,
+                message: `is not a slot of this section (accepted: ${Object.keys(declared).join(', ') || 'none'})`,
+            });
+            continue;
+        }
+        if (depth >= MAX_LAYOUT_DEPTH && children.length) {
+            errors.push({
+                at,
+                type: placement.type,
+                field: slot,
+                path: `${here}.${slot}`,
+                message: `nests deeper than ${MAX_LAYOUT_DEPTH} levels`,
+            });
+            continue;
+        }
+        if (rule.max != null && children.length > rule.max) {
+            errors.push({
+                at,
+                type: placement.type,
+                field: slot,
+                path: `${here}.${slot}`,
+                message: `holds ${children.length} sections, and this slot takes ${rule.max}`,
+            });
+        }
+        if (rule.accepts) {
+            const allowed = new Set(rule.accepts);
+            children.forEach((child, childAt) => {
+                const type = child?.type;
+                if (typeof type === 'string' && !allowed.has(type))
+                    errors.push({
+                        at: childAt,
+                        type,
+                        path: `${here}.${slot}.${childAt}`,
+                        message: `is not accepted by slot "${slot}" (accepted: ${rule.accepts?.join(', ')})`,
+                    });
+            });
+        }
+        validateInto(manifest, children, errors, `${here}.${slot}`, depth + 1);
+    }
+};
+export const formatLayoutErrors = (errors) => errors.map((e) => `  [${e.path ?? e.at}] ${e.type}${e.field ? '.' + e.field : ''} ${e.message}`).join('\n');
+// ---------------------------------------------------------------------------
+// Placement identity
+//
+// A layout used to be an ordered array and nothing else, so a saved revision
+// could not say whether a section had moved or had been deleted and a new one
+// added in its place. Everything an editor needs downstream - undo, a diff
+// between two revisions, a conflict that says what conflicted - rests on being
+// able to answer that, and none of it can be recovered from position alone.
+//
+// The id lives beside `type` rather than inside `settings`: it is not something
+// a section declares or a theme renders, and putting it in `settings` would
+// make it collide with a real setting and fail validation.
+/** How long a derived id is. Long enough not to collide, short enough to read. */
+const DERIVED_ID_LENGTH = 16;
+const canonical = (value) => {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value) ?? 'null';
+    if (Array.isArray(value))
+        return `[${value.map(canonical).join(',')}]`;
+    const entries = Object.entries(value)
+        .filter(([, v]) => v !== undefined)
+        .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0));
+    return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${canonical(v)}`).join(',')}}`;
+};
+/** A placement id is opaque, but it has to survive a round trip through JSON. */
+export const isPlacementId = (value) => typeof value === 'string' && /^[A-Za-z0-9_-]{8,64}$/.test(value);
+/**
+ * Give every placement in the tree an id, deriving one only where none exists.
+ *
+ * Derived from the content, not the position, and disambiguated by how many
+ * identical placements came before it. Deriving from the index instead would
+ * mean that the first save after a reorder - the one that turns legacy content
+ * into identified content - renamed everything it touched, which is precisely
+ * the case the id exists to distinguish.
+ *
+ * A subtree is part of what a container says, so the derivation walks children
+ * first and folds their ids in: two containers holding different things are
+ * different containers, even when their own settings match.
+ *
+ * An id already present is never replaced, so identity survives every later
+ * save regardless of what this function would have derived.
+ */
+export const withPlacementIds = (layout, digest, seen = new Map()) => layout.map((placement) => {
+    const slots = slotsOf(placement);
+    const identified = {};
+    for (const [slot, children] of slots)
+        identified[slot] = withPlacementIds(children, digest, seen);
+    const withSlots = slots.length ? { ...placement, slots: identified } : { ...placement };
+    const existing = placement.id;
+    if (isPlacementId(existing))
+        return { ...withSlots, id: existing };
+    const childIds = slots.flatMap(([slot, _]) => (identified[slot] ?? []).map((child) => `${slot}:${child.id}`));
+    const fingerprint = `${placement.type} ${canonical(placement.settings ?? {})} ${childIds.join(',')}`;
+    const ordinal = seen.get(fingerprint) ?? 0;
+    seen.set(fingerprint, ordinal + 1);
+    return { ...withSlots, id: digest(`${fingerprint} ${ordinal}`).slice(0, DERIVED_ID_LENGTH) };
+});
+/** Ids a layout cannot have: malformed, or the same one twice anywhere in it. */
+export const placementIdErrors = (layout) => {
+    const errors = [];
+    const seen = new Set();
+    for (const { placement, at, path } of walkPlacements(layout)) {
+        const id = placement?.id;
+        if (id === undefined)
+            continue;
+        const where = path.includes('.') ? { path } : {};
+        if (!isPlacementId(id)) {
+            errors.push({
+                at,
+                type: placement?.type ?? '(unknown)',
+                field: 'id',
+                ...where,
+                message: 'is not a placement id',
+            });
+            continue;
+        }
+        if (seen.has(id))
+            errors.push({
+                at,
+                type: placement?.type ?? '(unknown)',
+                field: 'id',
+                ...where,
+                // Two placements sharing an id make every later diff ambiguous, so this
+                // is refused at the write rather than resolved by guessing at the read.
+                // Uniqueness is across the whole tree, not per level: a diff keyed on
+                // id has no level to disambiguate with.
+                message: 'is already used by another placement in this layout',
+            });
+        seen.add(id);
+    }
+    return errors;
+};
+const changedSettings = (before, after) => {
+    const a = (before ?? {});
+    const b = (after ?? {});
+    const names = new Set([...Object.keys(a), ...Object.keys(b)]);
+    return [...names].filter((name) => canonical(a[name]) !== canonical(b[name])).sort();
+};
+/**
+ * What changed between two layouts, said per placement rather than per index.
+ *
+ * The walk is the whole tree, so a setting changed six levels down is reported
+ * on the node that changed. Comparing only the top level would have folded a
+ * subtree edit into "the container's settings are the same" and said nothing.
+ *
+ * Only placements carrying ids can be compared this way. Anything without one
+ * is reported as removed and added, which is the truthful answer: with no id
+ * there is no evidence the two are the same section.
+ */
+export const diffPlacements = (before, after) => {
+    const index = (layout) => {
+        const map = new Map();
+        for (const entry of walkPlacements(layout)) {
+            const id = entry.placement?.id;
+            if (isPlacementId(id))
+                map.set(id, entry);
+        }
+        return map;
+    };
+    const from = index(before);
+    const to = index(after);
+    const changes = [];
+    for (const [id, entry] of from)
+        if (!to.has(id))
+            changes.push({ id, type: entry.placement.type, change: 'removed', at: entry.at, path: entry.path });
+    for (const [id, entry] of to) {
+        const previous = from.get(id);
+        if (!previous) {
+            changes.push({ id, type: entry.placement.type, change: 'added', at: entry.at, path: entry.path });
+            continue;
+        }
+        if (previous.placement.type !== entry.placement.type) {
+            // A placement that changed type is a different section wearing the same
+            // id. Reported on its own so a reviewer never reads it as an edit.
+            changes.push({
+                id,
+                type: entry.placement.type,
+                change: 'retyped',
+                at: entry.at,
+                path: entry.path,
+                from: previous.placement.type,
+            });
+            continue;
+        }
+        const fields = changedSettings(previous.placement.settings, entry.placement.settings);
+        if (fields.length)
+            changes.push({
+                id,
+                type: entry.placement.type,
+                change: 'settings',
+                at: entry.at,
+                path: entry.path,
+                fields,
+            });
+        // The path carries the slot and every ancestor, so a section dragged into
+        // a different container reads as one move rather than as a removal from
+        // one place and an arrival somewhere else.
+        if (previous.path !== entry.path)
+            changes.push({
+                id,
+                type: entry.placement.type,
+                change: 'moved',
+                at: entry.at,
+                path: entry.path,
+                from: previous.path,
+            });
+    }
+    return changes.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0) || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+};
 //# sourceMappingURL=layout.js.map

package/dist/kernel/layout.js.map

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

package/dist/kernel/menu.d.ts

@@ -6,6 +6,11 @@ export type MenuNode = {
     icon: string | null;
     /** True for the node whose path is showing, and for every heading above it. */
     active: boolean;
+    /**
+     * True when this viewer may open the entry but the entry is not their work.
+     * The shell leaves these out of the main list; search still finds them.
+     */
+    secondary: boolean;
     children: MenuNode[];
 };
 export type MenuOptions = {
@@ -13,6 +18,8 @@ export type MenuOptions = {
     allow?: readonly string[] | null;
     /** Resolves a label. Given a key it does not know, it should return it unchanged. */
     translate?: (key: string) => string;
+    /** The locale the labels come back in, so equal sequences sort the way it reads. */
+    locale?: string;
     /** The path currently showing, used to mark the branch leading to it. */
     active?: string;
     /**
@@ -20,8 +27,32 @@ export type MenuOptions = {
      * does, so filtering never orphans a leaf from the words above it.
      */
     q?: string;
+    /**
+     * Mark entries this viewer may open but does not work on. Off by default:
+     * a caller that does not ask for the distinction gets the tree it always got.
+     *
+     * A viewer nothing is primary for keeps the whole permitted tree. An empty
+     * sidebar reads as a broken deployment, and telling a night auditor their
+     * work is nowhere is worse than showing them one screen too many.
+     */
+    intent?: boolean;
+    /**
+     * The deployment's own grouping, applied before anything else is decided.
+     *
+     * Named entries move under the declared heading; the rest keep the heading
+     * their module gave them. A heading whose entries are all filtered away
+     * disappears like any other empty heading.
+     */
+    groups?: ReadonlyArray<{
+        id: string;
+        label: string;
+        icon?: string;
+        items: readonly string[];
+    }>;
+    /** Menu ids to keep out of the main list whatever `for` says. */
+    demote?: readonly string[];
 };
 export declare function buildMenu(manifest: Manifest, o?: MenuOptions): MenuNode[];
-/** The app a path belongs to: the root whose branch contains it. */
-export declare function activeApp(tree: MenuNode[]): MenuNode | null;
+/** The root navigation section a path belongs to. */
+export declare function activeMenuRoot(tree: MenuNode[]): MenuNode | null;
 //# sourceMappingURL=menu.d.ts.map

package/dist/kernel/menu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../../../packages/ketjs/src/kernel/menu.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAW,MAAM,aAAa,CAAA;AAEpD,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,+EAA+E;IAC/E,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,QAAQ,EAAE,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,mEAAmE;IACnE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;IAChC,qFAAqF;IACrF,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IACnC,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,CAAC,CAAC,EAAE,MAAM,CAAA;CACX,CAAA;AAKD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,GAAE,WAAgB,GAAG,QAAQ,EAAE,CAoD7E;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,QAAQ,GAAG,IAAI,CAE3D"}
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../../../packages/ketjs/src/kernel/menu.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,QAAQ,EAAW,MAAM,aAAa,CAAA;AAEpD,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,+EAA+E;IAC/E,MAAM,EAAE,OAAO,CAAA;IACf;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAA;IAClB,QAAQ,EAAE,QAAQ,EAAE,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,mEAAmE;IACnE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;IAChC,qFAAqF;IACrF,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAA;IACnC,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,CAAC,CAAC,EAAE,MAAM,CAAA;IACV;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;IAC9F,iEAAiE;IACjE,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3B,CAAA;AAoED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,GAAE,WAAgB,GAAG,QAAQ,EAAE,CA6F7E;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,QAAQ,GAAG,IAAI,CAEhE"}