@nac3/forge-cli 0.2.0-alpha.1

package/dist/nac3/attrs.js

@@ -0,0 +1,134 @@
+/**
+ * NAC-3 cross-target a11y / E2E attribute helper (PLAN sec
+ * D2, NAC3.2).
+ *
+ * Single namespace `yujin.<scenario>.<element>` that maps to
+ * either web HTML `data-nac-id` (+ aria-* mirrors) or RN
+ * `testID` (+ accessibility* mirrors). The same scenario YAML
+ * (NAC3.4) can drive both Playwright and Maestro because the
+ * selectors are identical.
+ *
+ * Public API:
+ *   nacId('login.submit')          -> 'yujin.login.submit'
+ *   webAttrs(nacId, role?, action?) -> object with data-nac-*
+ *   rnAttrs(nacId, role?, action?)  -> object with testID +
+ *                                      accessibility* mirrors
+ *
+ * On the web side, `webAttrs` returns an object Hugo / React /
+ * vanilla can spread into a JSX/HTML element. The helper does
+ * NOT emit raw HTML attributes; the caller decides how to
+ * apply (e.g. via a string template `data-nac-id="${id}"`).
+ *
+ * Roles are aligned with WAI-ARIA roles where possible
+ * (button, link, navigation, dialog, etc). Actions are
+ * verbs that NAC-3 dispatch can interpret (submit, open,
+ * close, toggle, navigate, etc).
+ *
+ * ASCII-only.
+ */
+/* The set of stable NAC-3 attribute names. */
+export const NAC_ATTR_ID = 'data-nac-id';
+export const NAC_ATTR_ROLE = 'data-nac-role';
+export const NAC_ATTR_ACTION = 'data-nac-action';
+/** NAC-3 IDs follow the shape `yujin.<scenario>.<element>`.
+ *  Scenarios + elements are lowercase tokens, with hyphens
+ *  allowed. Dots delimit. The prefix `yujin.` is reserved. */
+const ID_RE = /^[a-z][a-z0-9-]*(\.[a-z0-9][a-z0-9-]*)*$/;
+/**
+ * Normalise a NAC ID. Accepts the long form
+ * `yujin.scenario.element` or the short `scenario.element`;
+ * always returns the long form with the `yujin.` prefix.
+ *
+ * Validates the shape loudly so callers see typos early.
+ */
+export function nacId(id) {
+    if (typeof id !== 'string' || id.length === 0) {
+        throw new Error('nacId: id must be a non-empty string');
+    }
+    let canonical = id;
+    if (!canonical.startsWith('yujin.'))
+        canonical = 'yujin.' + canonical;
+    if (!ID_RE.test(canonical)) {
+        throw new Error('nacId: invalid id "' + id + '". '
+            + 'Must match `yujin.<scenario>.<element>` with lowercase tokens, '
+            + 'digits, and hyphens (dot-separated).');
+    }
+    return canonical;
+}
+/**
+ * Build a web attribute object that can be flattened into an
+ * HTML element. Example:
+ *
+ *     const a = webAttrs('login.submit', { role: 'button', action: 'submit', label: 'Sign in' });
+ *     => {
+ *       'data-nac-id': 'yujin.login.submit',
+ *       'data-nac-role': 'button',
+ *       'data-nac-action': 'submit',
+ *       'aria-label': 'Sign in',
+ *     }
+ */
+export function webAttrs(id, opts = {}) {
+    const out = {
+        [NAC_ATTR_ID]: nacId(id),
+    };
+    if (opts.role)
+        out[NAC_ATTR_ROLE] = opts.role;
+    if (opts.action)
+        out[NAC_ATTR_ACTION] = opts.action;
+    if (opts.label)
+        out['aria-label'] = opts.label;
+    if (opts.hint)
+        out['aria-describedby'] = opts.hint;
+    return out;
+}
+/**
+ * Render a web attribute object as an HTML attribute string,
+ * ready to interpolate into a template. Each value is
+ * HTML-escaped (the same escapeHtml the panel uses).
+ *
+ *     `<button ${webAttrsHtml('login.submit', {role:'button'})}>`
+ *     => '<button data-nac-id="yujin.login.submit" data-nac-role="button">'
+ */
+export function webAttrsHtml(id, opts = {}) {
+    const obj = webAttrs(id, opts);
+    return Object.entries(obj)
+        .map(([k, v]) => k + '="' + escapeAttr(v) + '"')
+        .join(' ');
+}
+/**
+ * Build an RN attribute object. RN uses different prop names
+ * for the same concepts:
+ *
+ *     const a = rnAttrs('login.submit', { role: 'button', action: 'submit', label: 'Sign in' });
+ *     => {
+ *       testID: 'yujin.login.submit',
+ *       accessibilityRole: 'button',
+ *       accessibilityHint: 'submit',
+ *       accessibilityLabel: 'Sign in',
+ *     }
+ *
+ * Spread into the JSX of a `<Pressable>`, `<TextInput>`, etc.
+ */
+export function rnAttrs(id, opts = {}) {
+    const out = {
+        testID: nacId(id),
+    };
+    if (opts.role)
+        out.accessibilityRole = opts.role;
+    if (opts.action)
+        out.accessibilityHint = opts.action;
+    if (opts.label)
+        out.accessibilityLabel = opts.label;
+    return out;
+}
+/** Tight HTML attribute escape (covers " and & + < > for
+ *  defence-in-depth). Mirrors the escapeHtml used by panel.ts
+ *  but is local so this module is self-contained. */
+function escapeAttr(s) {
+    return String(s)
+        .replace(/&/g, '&amp;')
+        .replace(/"/g, '&quot;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;');
+}
+//# sourceMappingURL=attrs.js.map

package/dist/nac3/attrs.js.map

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

package/dist/nac3/scenario_dsl.d.ts

@@ -0,0 +1,71 @@
+/**
+ * NAC-3 cross-runner scenario DSL (PLAN sec D3, NAC3.4).
+ *
+ * Authored once in `tests/scenarios/*.yujin.yaml`; emitted as
+ *   1. Playwright TS specs        (web target)
+ *   2. Maestro YAML flow files    (RN target)
+ *
+ * The same scenario thus runs against the web panel AND the
+ * Forge-generated RN app -- paridad estricta (D11).
+ *
+ * DSL shape (a Scenario):
+ *
+ *   name:  string       -- human-readable scenario title
+ *   url:   string?      -- web base URL (defaults to env)
+ *   tags:  string[]?    -- categories (smoke, regression, ...)
+ *   stubs: Stub[]?      -- network mocks
+ *   flow:  Step[]       -- sequential actions
+ *
+ * Step shapes:
+ *   { tap: '<nacId>' }
+ *   { typeText: '...', into: '<nacId>' }
+ *   { assertVisible: '<nacId>' }
+ *   { assertHidden: '<nacId>' }
+ *   { assertText: '...', in: '<nacId>' }
+ *   { waitMs: 250 }
+ *   { screenshot: 'scenario-step-name' }
+ *
+ * Both emitters honour the SAME selector convention:
+ *   Playwright:  page.getByTestId('yujin.<scenario>.<el>') --
+ *                applies to both data-nac-id and testID
+ *                without runtime cost (Playwright reads
+ *                testIdAttribute config which we set to
+ *                'data-nac-id' at the spec generator level).
+ *   Maestro:     id: 'yujin.<scenario>.<el>'
+ *
+ * ASCII-only on the source.
+ */
+export interface Stub {
+    url: string;
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    status?: number;
+    contentType?: string;
+    response: unknown;
+}
+export type Step = {
+    tap: string;
+} | {
+    typeText: string;
+    into: string;
+} | {
+    assertVisible: string;
+} | {
+    assertHidden: string;
+} | {
+    assertText: string;
+    in: string;
+} | {
+    waitMs: number;
+} | {
+    screenshot: string;
+};
+export interface Scenario {
+    name: string;
+    url?: string;
+    tags?: readonly string[];
+    stubs?: readonly Stub[];
+    flow: readonly Step[];
+}
+export declare function emitPlaywright(scenario: Scenario): string;
+export declare function emitMaestro(scenario: Scenario): string;
+//# sourceMappingURL=scenario_dsl.d.ts.map

package/dist/nac3/scenario_dsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario_dsl.d.ts","sourceRoot":"","sources":["../../src/nac3/scenario_dsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,MAAM,WAAW,IAAI;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,IAAI,GACZ;IAAE,GAAG,EAAY,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,EAAO,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,YAAY,EAAG,MAAM,CAAA;CAAE,GACzB;IAAE,UAAU,EAAK,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,MAAM,EAAS,MAAM,CAAA;CAAE,GACzB;IAAE,UAAU,EAAK,MAAM,CAAA;CAAE,CAAC;AAE9B,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAK,MAAM,CAAC;IAChB,GAAG,CAAC,EAAK,MAAM,CAAC;IAChB,IAAI,CAAC,EAAI,SAAS,MAAM,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAG,SAAS,IAAI,EAAE,CAAC;IACzB,IAAI,EAAK,SAAS,IAAI,EAAE,CAAC;CAC1B;AAMD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAqCzD;AAuCD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAuBtD"}

package/dist/nac3/scenario_dsl.js

@@ -0,0 +1,191 @@
+/**
+ * NAC-3 cross-runner scenario DSL (PLAN sec D3, NAC3.4).
+ *
+ * Authored once in `tests/scenarios/*.yujin.yaml`; emitted as
+ *   1. Playwright TS specs        (web target)
+ *   2. Maestro YAML flow files    (RN target)
+ *
+ * The same scenario thus runs against the web panel AND the
+ * Forge-generated RN app -- paridad estricta (D11).
+ *
+ * DSL shape (a Scenario):
+ *
+ *   name:  string       -- human-readable scenario title
+ *   url:   string?      -- web base URL (defaults to env)
+ *   tags:  string[]?    -- categories (smoke, regression, ...)
+ *   stubs: Stub[]?      -- network mocks
+ *   flow:  Step[]       -- sequential actions
+ *
+ * Step shapes:
+ *   { tap: '<nacId>' }
+ *   { typeText: '...', into: '<nacId>' }
+ *   { assertVisible: '<nacId>' }
+ *   { assertHidden: '<nacId>' }
+ *   { assertText: '...', in: '<nacId>' }
+ *   { waitMs: 250 }
+ *   { screenshot: 'scenario-step-name' }
+ *
+ * Both emitters honour the SAME selector convention:
+ *   Playwright:  page.getByTestId('yujin.<scenario>.<el>') --
+ *                applies to both data-nac-id and testID
+ *                without runtime cost (Playwright reads
+ *                testIdAttribute config which we set to
+ *                'data-nac-id' at the spec generator level).
+ *   Maestro:     id: 'yujin.<scenario>.<el>'
+ *
+ * ASCII-only on the source.
+ */
+/* ============================================================
+ * Playwright emitter (web target)
+ * ============================================================ */
+export function emitPlaywright(scenario) {
+    const lines = [];
+    lines.push("/* AUTOGENERATED from tests/scenarios/" + slugify(scenario.name) + ".yujin.yaml. DO NOT EDIT BY HAND. */");
+    lines.push("import { test, expect } from '@playwright/test';");
+    lines.push("");
+    lines.push("test.describe.configure({ mode: 'serial' });");
+    lines.push("");
+    lines.push("test(" + jsString(scenario.name) + ", async ({ page }) => {");
+    /* Network stubs first (so they apply to the goto). */
+    if (scenario.stubs) {
+        for (const stub of scenario.stubs) {
+            const status = stub.status ?? 200;
+            const contentType = stub.contentType ?? 'application/json';
+            const body = typeof stub.response === 'string'
+                ? jsString(stub.response)
+                : 'JSON.stringify(' + JSON.stringify(stub.response) + ')';
+            lines.push('  await page.route(' + jsString(stub.url) + ', (route) => route.fulfill({');
+            lines.push('    status: ' + status + ',');
+            lines.push('    headers: { "content-type": ' + jsString(contentType) + ' },');
+            lines.push('    body: ' + body + ',');
+            lines.push('  }));');
+        }
+    }
+    /* Navigate. */
+    const baseUrl = scenario.url ?? 'http://127.0.0.1:4849/';
+    lines.push('  await page.goto(' + jsString(baseUrl) + ', { waitUntil: "networkidle" });');
+    /* Steps. */
+    for (const step of scenario.flow) {
+        lines.push('  ' + emitPlaywrightStep(step, scenario.name));
+    }
+    lines.push('});');
+    lines.push('');
+    return lines.join('\n');
+}
+function emitPlaywrightStep(step, scenarioName) {
+    if ('tap' in step) {
+        return 'await page.getByTestId(' + jsString(canonicaliseId(step.tap)) + ').click();';
+    }
+    if ('typeText' in step) {
+        return 'await page.getByTestId(' + jsString(canonicaliseId(step.into))
+            + ').fill(' + jsString(step.typeText) + ');';
+    }
+    if ('assertVisible' in step) {
+        return 'await expect(page.getByTestId(' + jsString(canonicaliseId(step.assertVisible))
+            + ')).toBeVisible();';
+    }
+    if ('assertHidden' in step) {
+        return 'await expect(page.getByTestId(' + jsString(canonicaliseId(step.assertHidden))
+            + ')).toBeHidden();';
+    }
+    if ('assertText' in step) {
+        return 'await expect(page.getByTestId(' + jsString(canonicaliseId(step.in))
+            + ')).toContainText(' + jsString(step.assertText) + ');';
+    }
+    if ('waitMs' in step) {
+        return 'await page.waitForTimeout(' + step.waitMs + ');';
+    }
+    if ('screenshot' in step) {
+        const safe = step.screenshot.replace(/[^a-zA-Z0-9-_]/g, '-');
+        return 'await page.screenshot({ path: '
+            + jsString('tests/visual/evidence/' + slugify(scenarioName) + '/' + safe + '.png')
+            + ', fullPage: true });';
+    }
+    /* Should be unreachable -- TypeScript narrows the union. */
+    throw new Error('emitPlaywrightStep: unknown step shape: ' + JSON.stringify(step));
+}
+/* ============================================================
+ * Maestro emitter (RN target)
+ * ============================================================ */
+export function emitMaestro(scenario) {
+    const lines = [];
+    lines.push("# AUTOGENERATED from tests/scenarios/" + slugify(scenario.name) + ".yujin.yaml. DO NOT EDIT BY HAND.");
+    lines.push("# " + scenario.name);
+    lines.push("appId: app.yujin.forge");
+    /* Maestro does not support generic HTTP stubs natively;
+     * we emit a marker comment so the dev knows to wire a
+     * MockableHttpClient handler (NAC3.4 deliverable D4). */
+    if (scenario.stubs && scenario.stubs.length > 0) {
+        lines.push('# Stubs declared (consumed by MockableHttpClient):');
+        for (const stub of scenario.stubs) {
+            lines.push('#   ' + (stub.method ?? 'GET') + ' ' + stub.url + ' -> ' + (stub.status ?? 200));
+        }
+    }
+    lines.push('---');
+    /* Launch the app. */
+    lines.push('- launchApp');
+    for (const step of scenario.flow) {
+        const block = emitMaestroStep(step, scenario.name);
+        for (const line of block)
+            lines.push(line);
+    }
+    return lines.join('\n') + '\n';
+}
+function emitMaestroStep(step, scenarioName) {
+    if ('tap' in step) {
+        return ['- tapOn:', '    id: ' + canonicaliseId(step.tap)];
+    }
+    if ('typeText' in step) {
+        return [
+            '- tapOn:', '    id: ' + canonicaliseId(step.into),
+            '- inputText: ' + maestroString(step.typeText),
+        ];
+    }
+    if ('assertVisible' in step) {
+        return ['- assertVisible:', '    id: ' + canonicaliseId(step.assertVisible)];
+    }
+    if ('assertHidden' in step) {
+        return ['- assertNotVisible:', '    id: ' + canonicaliseId(step.assertHidden)];
+    }
+    if ('assertText' in step) {
+        return [
+            '- assertVisible:', '    id: ' + canonicaliseId(step.in),
+            '- assertVisible:', '    text: ' + maestroString(step.assertText),
+        ];
+    }
+    if ('waitMs' in step) {
+        /* Maestro takes seconds, with sub-second precision. */
+        return ['- waitForAnimationToEnd', '- extendedWaitUntil:', '    visible: ""', '    timeout: ' + Math.max(1, Math.ceil(step.waitMs / 1000))];
+    }
+    if ('screenshot' in step) {
+        const safe = step.screenshot.replace(/[^a-zA-Z0-9-_]/g, '-');
+        return ['- takeScreenshot: ' + safe];
+    }
+    throw new Error('emitMaestroStep: unknown step shape: ' + JSON.stringify(step));
+}
+/* ============================================================
+ * Shared helpers
+ * ============================================================ */
+function canonicaliseId(id) {
+    /* Mirror of nacId() but inlined to avoid a circular import.
+     * The shape is `yujin.<scenario>.<element>`. */
+    if (typeof id !== 'string' || id.length === 0) {
+        throw new Error('canonicaliseId: empty id');
+    }
+    return id.startsWith('yujin.') ? id : 'yujin.' + id;
+}
+function slugify(s) {
+    return s.toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-+|-+$/g, '');
+}
+/** Defensive single-quoted TS string literal that survives
+ *  apostrophes + back-slashes inside scenario names + arg
+ *  values. */
+function jsString(s) {
+    return "'" + s.replace(/\\/g, '\\\\').replace(/'/g, "\\'") + "'";
+}
+/** Maestro YAML quoting: use double quotes + escape inner
+ *  doubles. */
+function maestroString(s) {
+    return '"' + s.replace(/\\/g, '\\\\').replace(/"/g, '\\"') + '"';
+}
+//# sourceMappingURL=scenario_dsl.js.map

package/dist/nac3/scenario_dsl.js.map

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

package/dist/nac3/tokens.d.ts

@@ -0,0 +1,126 @@
+/**
+ * NAC-3 design tokens (PLAN sec D1, NAC3.1).
+ *
+ * Single source of truth for colors, fonts, spacing, radii,
+ * and shadows used by the Forge panel (web) and -- after the
+ * NAC3.3 slice -- the RN mirror.
+ *
+ * The TS export is the canonical shape. A side-effect helper
+ * (`tokensToCssVars`) emits the same values as CSS variable
+ * declarations so the existing `panel.ts` CSS can consume
+ * them without further changes.
+ *
+ * Pablo's decision (D7): two packages emparejados. This file
+ * is the embryo of `@yujin/nac3-tokens` -- when the monorepo
+ * lands, it moves under `packages/nac3-tokens/`. The shape
+ * stays identical to avoid a churn refactor in callers.
+ *
+ * ASCII-only on the source. Values are CSS hex / numeric.
+ */
+export interface ColorTokens {
+    bg1: string;
+    bg2: string;
+    ink: string;
+    inkMuted: string;
+    inkSubtle: string;
+    indigo: string;
+    amber: string;
+    border: string;
+    borderSubtle: string;
+    ok: string;
+    err: string;
+    warn: string;
+    bubbleUser: string;
+    bubbleAsst: string;
+}
+export interface FontTokens {
+    sans: string;
+    kanji: string;
+    display: string;
+    mono: string;
+}
+export interface ShadowTokens {
+    card: {
+        offsetX: number;
+        offsetY: number;
+        blur: number;
+        spread: number;
+        color: string;
+    };
+    modal: {
+        offsetX: number;
+        offsetY: number;
+        blur: number;
+        spread: number;
+        color: string;
+    };
+}
+export interface RadiusTokens {
+    sm: number;
+    md: number;
+    lg: number;
+    pill: number;
+}
+export interface Nac3Tokens {
+    color: ColorTokens;
+    font: FontTokens;
+    space: readonly number[];
+    radius: RadiusTokens;
+    shadow: ShadowTokens;
+}
+/** The canonical NAC-3 token set. */
+export declare const TOKENS: Nac3Tokens;
+/**
+ * Emit the color + font + radius tokens as a CSS variable
+ * declaration block, scoped under `:root` by default. The
+ * existing panel CSS consumes these same names; rendering
+ * the block at HTML render time replaces the previous
+ * hardcoded `:root { --bg-1: ... }` block.
+ *
+ * Caller pattern (in `renderPanelHtml`):
+ *
+ *     <style>
+ *       :root { ${tokensToCssVars()} }
+ *       ...rest of the panel CSS...
+ *     </style>
+ */
+export declare function tokensToCssVars(scope?: string): string;
+/**
+ * RN style object equivalent. NB: shadows are RN-specific
+ * (elevation + shadowOffset for iOS, elevation only on
+ * Android). React Native callers should use this object,
+ * not the CSS string.
+ *
+ * Exported here so a future `@nac3/forge-rn` consumer
+ * doesn't need to re-translate the tokens; same numbers,
+ * same names.
+ */
+export declare function tokensToRnTheme(): {
+    color: ColorTokens;
+    font: FontTokens;
+    space: readonly number[];
+    radius: RadiusTokens;
+    shadow: {
+        card: {
+            elevation: number;
+            shadowOffset: {
+                width: number;
+                height: number;
+            };
+            shadowOpacity: number;
+            shadowRadius: number;
+            shadowColor: string;
+        };
+        modal: {
+            elevation: number;
+            shadowOffset: {
+                width: number;
+                height: number;
+            };
+            shadowOpacity: number;
+            shadowRadius: number;
+            shadowColor: string;
+        };
+    };
+};
+//# sourceMappingURL=tokens.d.ts.map

package/dist/nac3/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/nac3/tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACxF,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1F;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;IAEjB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,qCAAqC;AACrC,eAAO,MAAM,MAAM,EAAE,UA6BpB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,KAAK,GAAE,MAAgB,GAAG,MAAM,CAsC/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,IAAI;IACjC,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE;QACN,IAAI,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE;gBAAE,KAAK,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAA;aAAE,CAAC;YAAC,aAAa,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/I,KAAK,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE;gBAAE,KAAK,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAA;aAAE,CAAC;YAAC,aAAa,EAAE,MAAM,CAAC;YAAC,YAAY,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;KACjJ,CAAC;CACH,CAuBA"}