@inhuman.tools/policy 0.1.0 → 0.2.0

package/dist/error-with-invariant.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"error-with-invariant.js","sourceRoot":"","sources":["../src/error-with-invariant.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,MAAM,CAAC,SAAS,CAEd,SAAkB,EAClB,GAAG,IAA8B;QAEjC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF"}

package/dist/license-law.d.ts

@@ -1,43 +0,0 @@
-/**
- * Pure license decisions. One `LicenseFacts` bag — no jobs.
- * Short-circuit order is the law. Do not reorder.
- * Job readers stay in harness-model.
- */
-export type LicenseFacts = {
-    readonly humanApprove: boolean | null;
-    readonly completed: boolean;
-    readonly cancelled: boolean;
-    readonly commFirst: boolean;
-    readonly fileReadGrant: boolean;
-    readonly policy: "manual" | "auto" | "yolo";
-    readonly policyResult: "policyApprove" | "deny" | "ask" | "block" | null;
-    readonly classifierResult: "allow" | "deny" | null;
-    readonly classifierAbstain: string | null;
-    readonly hatch: boolean;
-    readonly clusterGranted: boolean;
-    readonly writeClassifierOff: boolean;
-    readonly unattended: boolean;
-    readonly coverDeny: boolean;
-};
-/** Stored `allow` and `approve` are the previous positive spellings. */
-export declare function asPolicyResult(value: unknown): LicenseFacts["policyResult"];
-/** Floor `ask` and `deny` share remainder `"ask"`. Ignores hatch. `block` is not remainder. */
-export declare function autoRemainderOf(facts: LicenseFacts): "ask" | null;
-/** Auto floor `ask` that allow-sides: not hatch, cluster already granted. */
-export declare function autoAllowSkip(facts: LicenseFacts): boolean;
-/** Floor ask/deny except auto allow-skip. Floor allow is not remainder. */
-export declare function autoRemainder(facts: LicenseFacts): "ask" | null;
-/**
- * Remainder classifier intern. Not the cover. Ungranted write never
- * classifies, including after a fail message. Deny classifies when
- * unattended, when cover is off, or when the cluster is granted.
- */
-export declare function autoClassifierPending(facts: LicenseFacts): boolean;
-/** Cover predicate. Not a license bit. */
-export declare function needsHuman(facts: LicenseFacts): boolean;
-/** `true` allow / `false` deny / `null` still waiting. Human first, then the floor. */
-export declare function licenseDecision(facts: LicenseFacts): boolean | null;
-export declare function licenseAllows(facts: LicenseFacts): boolean;
-/** Known-safe leaves. Approved and any judge vote stay visible. */
-export declare function tapeFuse(facts: LicenseFacts): boolean;
-//# sourceMappingURL=license-law.d.ts.map

package/dist/license-law.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"license-law.d.ts","sourceRoot":"","sources":["../src/license-law.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,eAAe,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,IAAI,CAAC;IACzE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAAC,cAAc,CAAC,CAI3E;AAED,+FAA+F;AAC/F,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,GAAG,IAAI,CAQjE;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAS1D;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,GAAG,IAAI,CAO/D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAYlE;AAED,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAgBvD;AAED,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,GAAG,IAAI,CA2BnE;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAE1D;AAED,mEAAmE;AACnE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAerD"}

package/dist/license-law.js

@@ -1,129 +0,0 @@
-/**
- * Pure license decisions. One `LicenseFacts` bag — no jobs.
- * Short-circuit order is the law. Do not reorder.
- * Job readers stay in harness-model.
- */
-/** Stored `allow` and `approve` are the previous positive spellings. */
-export function asPolicyResult(value) {
-    if (value === "policyApprove" || value === "allow" || value === "approve")
-        return "policyApprove";
-    if (value === "deny" || value === "ask" || value === "block")
-        return value;
-    return null;
-}
-/** Floor `ask` and `deny` share remainder `"ask"`. Ignores hatch. `block` is not remainder. */
-export function autoRemainderOf(facts) {
-    switch (true) {
-        case facts.policyResult === "ask":
-        case facts.policyResult === "deny":
-            return "ask";
-        default:
-            return null;
-    }
-}
-/** Auto floor `ask` that allow-sides: not hatch, cluster already granted. */
-export function autoAllowSkip(facts) {
-    switch (true) {
-        case facts.policy !== "auto":
-        case facts.policyResult !== "ask":
-        case facts.hatch:
-            return false;
-        default:
-            return facts.clusterGranted;
-    }
-}
-/** Floor ask/deny except auto allow-skip. Floor allow is not remainder. */
-export function autoRemainder(facts) {
-    switch (true) {
-        case autoAllowSkip(facts):
-            return null;
-        default:
-            return autoRemainderOf(facts);
-    }
-}
-/**
- * Remainder classifier intern. Not the cover. Ungranted write never
- * classifies, including after a fail message. Deny classifies when
- * unattended, when cover is off, or when the cluster is granted.
- */
-export function autoClassifierPending(facts) {
-    switch (true) {
-        case facts.policy !== "auto":
-        case autoRemainder(facts) === null || facts.classifierResult !== null:
-        case facts.writeClassifierOff:
-            return false;
-        case facts.classifierAbstain !== null:
-        case facts.unattended || facts.policyResult === "ask":
-            return true;
-        default:
-            return facts.policyResult === "deny" && (!facts.coverDeny || facts.clusterGranted);
-    }
-}
-/** Cover predicate. Not a license bit. */
-export function needsHuman(facts) {
-    switch (true) {
-        case facts.completed || facts.cancelled || facts.humanApprove !== null:
-        case facts.commFirst:
-        case facts.fileReadGrant:
-            return false;
-        case facts.policy === "manual" && (facts.policyResult === "ask" || facts.policyResult === "deny"):
-            return true;
-        case facts.policy !== "auto":
-        case autoRemainder(facts) === null || facts.classifierResult !== null:
-            return false;
-        case autoClassifierPending(facts):
-            return facts.classifierAbstain !== null;
-        default:
-            return true;
-    }
-}
-/** `true` allow / `false` deny / `null` still waiting. Human first, then the floor. */
-export function licenseDecision(facts) {
-    switch (true) {
-        case facts.humanApprove === true:
-            return true;
-        case facts.humanApprove === false:
-            return false;
-        case facts.commFirst:
-            return true;
-        case facts.policyResult === "block":
-            return false;
-        case facts.fileReadGrant:
-        case facts.policyResult === "policyApprove":
-        case facts.policy === "yolo" && (facts.policyResult === "ask" || facts.policyResult === "deny"):
-        case autoAllowSkip(facts):
-            return true;
-        case facts.policy === "auto" && autoRemainderOf(facts) !== null:
-            switch (facts.classifierResult) {
-                case "allow":
-                    return true;
-                case "deny":
-                    return false;
-                default:
-                    return null;
-            }
-        default:
-            return null;
-    }
-}
-export function licenseAllows(facts) {
-    return licenseDecision(facts) === true;
-}
-/** Known-safe leaves. Approved and any judge vote stay visible. */
-export function tapeFuse(facts) {
-    switch (true) {
-        case facts.humanApprove !== null:
-        case facts.classifierResult !== null:
-            return false;
-        case facts.commFirst:
-        case autoAllowSkip(facts):
-            return true;
-        case facts.policyResult === "ask":
-        case facts.policyResult === "deny":
-        case facts.policyResult === "block":
-            return false;
-        default:
-            return true;
-    }
-}
-//# sourceMappingURL=license-law.js.map

package/dist/license-law.js.map

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

package/dist/license.d.ts

@@ -1,3 +0,0 @@
-export { asPolicyResult, autoAllowSkip, autoClassifierPending, autoRemainder, autoRemainderOf, licenseAllows, licenseDecision, needsHuman, tapeFuse, } from "./license-law.js";
-export type { LicenseFacts } from "./license-law.js";
-//# sourceMappingURL=license.d.ts.map

package/dist/license.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"license.d.ts","sourceRoot":"","sources":["../src/license.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,aAAa,EACb,eAAe,EACf,UAAU,EACV,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/license.js

@@ -1,2 +0,0 @@
-export { asPolicyResult, autoAllowSkip, autoClassifierPending, autoRemainder, autoRemainderOf, licenseAllows, licenseDecision, needsHuman, tapeFuse, } from "./license-law.js";
-//# sourceMappingURL=license.js.map

package/dist/license.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"license.js","sourceRoot":"","sources":["../src/license.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,aAAa,EACb,eAAe,EACf,UAAU,EACV,QAAQ,GACT,MAAM,kBAAkB,CAAC"}

package/dist/peel-cwd.d.ts

@@ -1,8 +0,0 @@
-export type PeeledCd = {
-    readonly cwd: string;
-    readonly command: string;
-};
-export declare function peelLeadingCd(source: string): PeeledCd | null;
-/** Keep an explicit `cwd` arg when it names the same leaf; never override a disagreement. */
-export declare function peelShellCwd(command: string, cwdArg?: string): PeeledCd | null;
-//# sourceMappingURL=peel-cwd.d.ts.map

package/dist/peel-cwd.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"peel-cwd.d.ts","sourceRoot":"","sources":["../src/peel-cwd.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAIF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAyB7D;AAED,6FAA6F;AAC7F,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAU9E"}

package/dist/peel-cwd.js

@@ -1,120 +0,0 @@
-/**
- * Peel a leading cwd-only `cd` off a shell command into the `cwd` arg.
- * Unbash AST, not regex. Quoted `;` is not a splitter. Remainder stays
- * one `/bin/sh -c` — this is not execute-split.
- *
- * Peel only the first top-level list element (`&&` or `;` / newline).
- * `||`, pipes, subshells, brace groups, `cd` that is not first, and
- * `cd` with flags/extra operands stay on the command string.
- */
-import { parse } from "unbash";
-const PARTLESS_FORBIDDEN = /[*?[\\$`]/;
-export function peelLeadingCd(source) {
-    const script = parse(source);
-    if (script.errors !== undefined && script.errors.length > 0)
-        return null;
-    const statements = script.commands;
-    if (statements.length === 0)
-        return null;
-    const first = statements[0];
-    if (first === undefined || first.background === true || first.redirects.length > 0)
-        return null;
-    const node = first.command;
-    const simple = asSimpleCommand(node);
-    if (simple !== null) {
-        const cwd = cwdOnlyPath(simple);
-        if (cwd === null)
-            return null;
-        if (statements.length === 1)
-            return { cwd, command: "" };
-        return { cwd, command: source.slice(statements[1].pos).trim() };
-    }
-    if (node.type !== "AndOr" || node.operators[0] !== "&&")
-        return null;
-    const head = asSimpleCommand(node.commands[0]);
-    if (head === null)
-        return null;
-    const cwd = cwdOnlyPath(head);
-    if (cwd === null)
-        return null;
-    const rest = node.commands[1];
-    if (rest === undefined)
-        return { cwd, command: "" };
-    return { cwd, command: source.slice(rest.pos).trim() };
-}
-/** Keep an explicit `cwd` arg when it names the same leaf; never override a disagreement. */
-export function peelShellCwd(command, cwdArg) {
-    const peeled = peelLeadingCd(command);
-    if (peeled === null)
-        return null;
-    if (cwdArg !== undefined && cwdArg !== "" && normalizeCwdToken(cwdArg) !== normalizeCwdToken(peeled.cwd)) {
-        return null;
-    }
-    return {
-        cwd: cwdArg !== undefined && cwdArg !== "" ? cwdArg : peeled.cwd,
-        command: peeled.command,
-    };
-}
-function normalizeCwdToken(raw) {
-    let token = raw.replaceAll("\\", "/").replace(/\/+$/, "");
-    if (token.startsWith("./"))
-        token = token.slice(2);
-    return token === "" ? "." : token;
-}
-function asSimpleCommand(node) {
-    if (node === undefined)
-        return null;
-    if (node.type === "Command")
-        return node;
-    if (node.type !== "Pipeline")
-        return null;
-    if (node.commands.length !== 1 || (node.operators?.length ?? 0) > 0)
-        return null;
-    if (node.negated === true || node.time === true)
-        return null;
-    return asSimpleCommand(node.commands[0]);
-}
-function cwdOnlyPath(command) {
-    if (command.prefix.length > 0 || command.redirects.length > 0)
-        return null;
-    if (command.name === undefined || !isLiteralWord(command.name))
-        return null;
-    let argv0 = command.name.value;
-    let suffix = command.suffix;
-    if (argv0 === "builtin" || argv0 === "command") {
-        const inner = suffix[0];
-        if (inner === undefined || !isLiteralWord(inner) || inner.value !== "cd")
-            return null;
-        argv0 = "cd";
-        suffix = suffix.slice(1);
-    }
-    if (argv0 !== "cd" || suffix.length !== 1)
-        return null;
-    const dest = suffix[0];
-    if (dest === undefined || !isLiteralWord(dest))
-        return null;
-    const value = dest.value;
-    if (value === "" || value === "-" || value === "--" || value.startsWith("-"))
-        return null;
-    return value;
-}
-function isLiteralWord(word) {
-    if (word.parts === undefined) {
-        return !PARTLESS_FORBIDDEN.test(word.text) && !word.text.startsWith("~");
-    }
-    return word.parts.every(partIsLiteral);
-}
-function partIsLiteral(part) {
-    switch (part.type) {
-        case "Literal":
-        case "SingleQuoted":
-            return true;
-        case "AnsiCQuoted":
-            return !part.value.includes("\0");
-        case "DoubleQuoted":
-            return part.parts.every((child) => child.type === "Literal");
-        default:
-            return false;
-    }
-}
-//# sourceMappingURL=peel-cwd.js.map

package/dist/peel-cwd.js.map

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

package/dist/prep.d.ts

@@ -1,58 +0,0 @@
-/**
- * Question prep: unbash AST → prepared questions + unparsed acts.
- * Hermetic — no PATH, no process.env, no execution. Word.parts is a lazy
- * getter; this file always reads it. Nested parse errors live on the nested
- * script, not the root.
- *
- * Partition builds I: a known value-flag attaches; an unknown flag followed
- * by a non-dash, non-`--` token forks attached and boolean readings.
- * `valueFlagsFor(argv0, suffix)` sees the leading positional spine — not
- * every descendant under argv0. `=value` and glued shorts stay one reading.
- * `--` never attaches as a value. Cap 16 is open ruling 5; overflow is ⊤I.
- * A nameless command still emits its redirects. `xargs -a FILE` is a read
- * of FILE as well as the inner command.
- */
-import { type ParseError } from "unbash";
-import { type Which } from "./identity.js";
-import type { Question, Reading } from "./types.js";
-export type UnparsedVia = "parse-error" | "control-flow" | "function" | "source" | "test" | "arithmetic" | "coproc" | "find-expression" | "non-literal-argv0" | "script-string";
-export type UnparsedAct = {
-    readonly via: UnparsedVia;
-    readonly source: string;
-};
-export type RedirectEmit = {
-    readonly operator: string;
-    readonly target: string;
-};
-export type PreparedQuestion = Question & {
-    readonly wrapChain: readonly string[];
-    readonly elevated: boolean;
-    readonly envDelta: Readonly<Record<string, string>>;
-    readonly redirects: readonly RedirectEmit[];
-    readonly background: boolean;
-    readonly stdinIsPipe: boolean;
-};
-export type PrepResult = {
-    readonly questions: readonly PreparedQuestion[];
-    readonly unparsed: readonly UnparsedAct[];
-    readonly errors: readonly ParseError[];
-    /** File effects from commands that have no argv0 (`> .env`). */
-    readonly redirects: readonly RedirectEmit[];
-};
-export type PrepOpts = {
-    readonly valueFlags?: ReadonlySet<string>;
-    readonly valueFlagsFor?: (argv0: string, suffix: readonly string[]) => ReadonlySet<string> | undefined;
-    /** Path-form peelers are transparent only when this agrees. */
-    readonly which?: Which;
-};
-export declare function prep(source: string, opts?: PrepOpts): PrepResult;
-/**
- * Tokenize argv into positionals + flag bag.
- * `closed`: only those names are flags; other dash tokens are positionals.
- * Used when a `"--"` field reopens the suffix — undeclared `-file` stays a path.
- */
-export declare function partition(words: readonly string[], valueFlags: ReadonlySet<string> | undefined, closed?: ReadonlySet<string>): {
-    readings: Reading[];
-    overflow: boolean;
-};
-//# sourceMappingURL=prep.d.ts.map

package/dist/prep.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"prep.d.ts","sourceRoot":"","sources":["../src/prep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAML,KAAK,UAAU,EAOhB,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAgB,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,MAAM,WAAW,GACnB,aAAa,GACb,cAAc,GACd,UAAU,GACV,QAAQ,GACR,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,iBAAiB,GACjB,mBAAmB,GACnB,eAAe,CAAC;AAEpB,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG;IACxC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IAC5C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;IACvC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;CAC7C,CAAC;AAoBF,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,KAAK,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACvG,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB,CAAC;AAEF,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,UAAU,CAqBhE;AAsUD;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,EAC3C,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAC3B;IAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CA+C5C"}