@profile-as-code/core 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Christian Luciani
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,81 @@
-# Temporary Holding Version
+# @profile-as-code/core
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The core engine of **profile-as-code** (M1): load a profile-data workspace,
+validate it against the contract, and run the drift / GEO / compile layers.
+
+The contract source is `schema/profile.schema.json` (D3) — Zod schemas are
+**generated** from it, never hand-written (see `scripts/gen-zod.ts`).
+
+## API
+
+```ts
+import { load, driftCheck, geoCheck, compile } from '@profile-as-code/core';
+
+const profile = load('/path/to/profile-data');        // parse content/*.yaml + validate (FAIL on schema, D12)
+const issues  = driftCheck(profile);                     // Issue[] — WARN only, never throws (D12)
+const geo     = geoCheck(profile);                       // GeoReport — 0..100 score, not a gate (§8)
+const slice   = compile(profile, 'linkedin', 'es');      // PlatformProfile — language-aware renderer slice
+```
+
+- **`load(workspace)`** — reads `content/*.yaml` (file name = root property:
+  `bios.yaml` → `bios[]`, `identity.yaml` → `identity`, …), merges, validates
+  against the generated Zod, normalizes (collections default to `[]`).
+  Throws `LoadError` (workspace problems) / `SchemaValidationError` (contract
+  violations with one precise `path` + `message` per error — the fail-on-schema
+  side of D12). Unknown files fail validation via `additionalProperties: false`.
+- **`driftCheck(profile)`** — factual contradictions across surfaces, all WARN
+  (users may have different intents per platform, but they must SEE them):
+  uncanonicalized platform URLs, `start > end`, duplicated bios/headlines,
+  same role/org with different dates, same title with different year/venue,
+  ORCID conflicts/mismatches vs `identity.links`, active entries without a
+  curated base, unknown active platform keys, skill level conflicts.
+  *Out of scope (v1):* free-text mining of bio prose, DOI resolvability
+  (network), the variants store (only the platform+lang base is validated).
+- **`geoCheck(profile)`** — weighted report (14 checks since v1.10, 0..100):
+  **fact consistency** (conflicts + per-platform bio/headline coverage),
+  **structured-data readiness** (`schema.org` Person JSON-LD with `sameAs`,
+  ready for the web renderer), **semantic associations** (the 3–5
+  `positioning.geo.semanticAssociations` anchors and how well each is
+  reinforced across statement/skills/keywords/projects), **citability**
+  (DOI/ORCID on publications, `evidence[]` on projects) plus the v1.10 citability
+  codes — canonical definition, FAQ coverage, freshness, sameAs coverage, name
+  collision. Missing data is neutral for the fact checks (never penalized);
+  readiness/citability checks (structured data, semantic anchors, the v1.10 codes)
+  can score 0 when the signal is absent — a reported gap, not a penalty (SPEC §8).
+- **`compile(profile, platform, lang)`** — facts pass through untouched
+  (identical on every platform = GEO-citable); text (bios, headlines, statement,
+  audiences, citationsGoal) is filtered by platform+lang and falls back to `en`
+  (always required by the schema), recording each fallback in `fallbacks`.
+
+## Contract fidelity (generator)
+
+`scripts/gen-zod.ts` regenerates `src/generated/schema.zod.ts` from
+`schema/profile.schema.json`. Because `json-schema-to-zod@2.8.1` does not resolve
+`$defs`, ignore `propertyNames`, and bloats `oneOf`, the generator:
+
+1. inlines `#/$defs/*` references (fails on unknown/circular defs),
+2. rewrites the lone `oneOf` (`check.value`) to `anyOf` (clean `z.union`),
+3. materializes `langMap.en` as a real property (keeps `required: ['en']`), and
+4. wraps every langMap with a `langMapKeys` superRefine enforcing the
+   `en/es/fr` key enum (`propertyNames`).
+
+Safety nets fail CI loudly if the output ever contains `z.any()` or loses the
+langMap guard.
+
+## Test
+
+```sh
+pnpm install
+pnpm test        # vitest (load, drift, geo, compile)
+pnpm build       # strict tsc → dist/
+pnpm gen:zod     # regenerate src/generated/schema.zod.ts (must produce no diff)
+```
+
+Fixtures live in `tests/fixtures/`: `minimal/` (drift-free, GEO-rich — the
+reference fixture) and `drifting/` (schema-valid but contradicts itself on
+every drift rule).
+
+Requires Node ≥ 22 (the `engines` field of this manifest). Full source and docs
+live in the [public repository](https://github.com/ChristianLuciani/profile-as-code) —
+`scripts/gen-zod.ts` and `tests/fixtures/` above are package-relative paths there
+(`packages/core/…`); the contract source is the repository's `schema/profile.schema.json`.

package/dist/byte-order.d.ts

@@ -0,0 +1,17 @@
+/**
+ * byte-order.ts — the ONE home of every text-order comparison in the engine
+ * (D19 byte-parity, issue #305).
+ *
+ * The comparator is UTF-16 code UNITS — JS native `a < b` string order:
+ * deterministic on every environment, ICU-free. It is NOT codepoint order on
+ * the astral edge, and SPEC §15.3 names that choice exactly. A `localeCompare`
+ * call-site would depend on the ICU build and can tie (`0`), leaking
+ * environment-specific order through a stable sort — the class #257 fixed for
+ * the featured slice and #305 closes workspace-wide.
+ *
+ * The discriminating probe (`apple` vs `APPLE`: ICU collation reads lowercase
+ * first, code units read uppercase first) lives at
+ * packages/core/tests/byte-order.test.ts.
+ */
+export declare function byteOrder(a: string, b: string): number;
+//# sourceMappingURL=byte-order.d.ts.map

package/dist/byte-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"byte-order.d.ts","sourceRoot":"","sources":["../src/byte-order.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/byte-order.js

@@ -0,0 +1,19 @@
+/**
+ * byte-order.ts — the ONE home of every text-order comparison in the engine
+ * (D19 byte-parity, issue #305).
+ *
+ * The comparator is UTF-16 code UNITS — JS native `a < b` string order:
+ * deterministic on every environment, ICU-free. It is NOT codepoint order on
+ * the astral edge, and SPEC §15.3 names that choice exactly. A `localeCompare`
+ * call-site would depend on the ICU build and can tie (`0`), leaking
+ * environment-specific order through a stable sort — the class #257 fixed for
+ * the featured slice and #305 closes workspace-wide.
+ *
+ * The discriminating probe (`apple` vs `APPLE`: ICU collation reads lowercase
+ * first, code units read uppercase first) lives at
+ * packages/core/tests/byte-order.test.ts.
+ */
+export function byteOrder(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+//# sourceMappingURL=byte-order.js.map

package/dist/byte-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"byte-order.js","sourceRoot":"","sources":["../src/byte-order.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,SAAS,CAAC,CAAS,EAAE,CAAS;IAC5C,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC"}

package/dist/compile.d.ts

@@ -0,0 +1,40 @@
+/**
+ * compile(profile, platform, lang) — the language-aware slice a renderer consumes
+ * (SPEC §7). Facts (identity, experience, projects, publications, skills) pass
+ * through UNTOUCHED — they are language-independent and identical on every
+ * platform (that is what makes them GEO-citable). Only text (bios, headlines,
+ * statement, audiences, citationsGoal) is filtered by platform+lang, falling back
+ * to `en` when the requested lang is absent (EN is always required by the schema).
+ *
+ * The platform set is the single `PLATFORMS` const from types.js (generated from
+ * the schema enum) — never duplicated here.
+ */
+import { type CompletenessPolicy } from "./completeness.js";
+import { type SelectionPolicy } from "./selection.js";
+import type { Lang, Platform, PlatformProfile, Profile } from "./types.js";
+/**
+ * D22/§21: the compile policy — the completeness policy it always took, plus the
+ * optional selection policy. ADDITIVE: `CompletenessPolicy` callers keep
+ * compiling unchanged, and a policy without `selection` produces a slice
+ * byte-identical to before this feature existed (the compatibility guarantee,
+ * asserted by a golden test).
+ */
+export type CompilePolicy = CompletenessPolicy & {
+    selection?: SelectionPolicy;
+    /** D22/§21: the view NAME to resolve (a declared view may target a platform
+     *  other than its own name, e.g. `--view film` → `github-readme`). Defaults to
+     *  the platform, which is the implicit view (`pasco build linkedin`). */
+    view?: string;
+};
+/**
+ * Compile a PlatformProfile for one platform and language.
+ *
+ * @param policy the workspace compile policy (issue #102 + D22): the completeness
+ *   policy, and optionally the fact-selection policy. The CLI passes `.pascorc`'s
+ *   so the artifact carries the SAME number the workspace reports and the SAME
+ *   view it resolved; omitted ⇒ no selection, shipped completeness default.
+ * @throws TypeError — `platform`/`lang` not in the contract enum (a renderer bug,
+ *   not a user-data problem).
+ */
+export declare function compile(profile: Profile, platform: Platform, lang?: Lang, policy?: CompilePolicy): PlatformProfile;
+//# sourceMappingURL=compile.d.ts.map

package/dist/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../src/compile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,kBAAkB,EAAgB,MAAM,mBAAmB,CAAC;AAE1E,OAAO,EAAE,KAAK,eAAe,EAAe,MAAM,gBAAgB,CAAC;AAEnE,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAK3E;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,kBAAkB,GAAG;IAC/C,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B;;6EAEyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,EAClB,IAAI,GAAE,IAAW,EACjB,MAAM,CAAC,EAAE,aAAa,GACrB,eAAe,CAyGjB"}

package/dist/compile.js

@@ -0,0 +1,120 @@
+/**
+ * compile(profile, platform, lang) — the language-aware slice a renderer consumes
+ * (SPEC §7). Facts (identity, experience, projects, publications, skills) pass
+ * through UNTOUCHED — they are language-independent and identical on every
+ * platform (that is what makes them GEO-citable). Only text (bios, headlines,
+ * statement, audiences, citationsGoal) is filtered by platform+lang, falling back
+ * to `en` when the requested lang is absent (EN is always required by the schema).
+ *
+ * The platform set is the single `PLATFORMS` const from types.js (generated from
+ * the schema enum) — never duplicated here.
+ */
+import { completeness } from "./completeness.js";
+import { normalizeProfile } from "./load.js";
+import { selectFacts } from "./selection.js";
+import { structuredData } from "./structured-data.js";
+import { PLATFORMS } from "./types.js";
+const LANG_IDS = ["en", "es", "fr"];
+/**
+ * Compile a PlatformProfile for one platform and language.
+ *
+ * @param policy the workspace compile policy (issue #102 + D22): the completeness
+ *   policy, and optionally the fact-selection policy. The CLI passes `.pascorc`'s
+ *   so the artifact carries the SAME number the workspace reports and the SAME
+ *   view it resolved; omitted ⇒ no selection, shipped completeness default.
+ * @throws TypeError — `platform`/`lang` not in the contract enum (a renderer bug,
+ *   not a user-data problem).
+ */
+export function compile(profile, platform, lang = "en", policy) {
+    if (!PLATFORMS.includes(platform)) {
+        throw new TypeError(`compile: unknown platform "${String(platform)}" (allowed: ${PLATFORMS.join(", ")})`);
+    }
+    if (!LANG_IDS.includes(lang)) {
+        throw new TypeError(`compile: unknown language "${String(lang)}" (allowed: ${LANG_IDS.join(", ")})`);
+    }
+    const fallbacks = [];
+    const langText = (langMap, path) => {
+        // Issue #84 (option (a) ratified): an empty-string value counts as ABSENT —
+        // nobody can display "" and a populated workspace is byte-identical; only
+        // previously-degenerate output changes. `|| undefined` (not just `??`) so
+        // emptiness falls through at BOTH lookup levels (lang-specific and en).
+        const direct = langMap?.[lang] || undefined;
+        if (direct !== undefined)
+            return direct;
+        const en = langMap?.en || undefined;
+        if (en !== undefined) {
+            fallbacks.push(path);
+            return en;
+        }
+        return undefined;
+    };
+    const positioning = profile.positioning;
+    const audiences = {};
+    for (const [name, map] of Object.entries(positioning?.audiences ?? {})) {
+        const text = langText(map, `positioning.audiences.${name}`);
+        if (text !== undefined)
+            audiences[name] = text;
+    }
+    // Brand blocks (v1.1/§17): text is lang-filtered (falling back to en), facts
+    // (urls, dates, status) pass through untouched.
+    const brandAudiences = {};
+    for (const [name, map] of Object.entries(profile.audiences ?? {})) {
+        const text = langText(map, `audiences.${name}`);
+        if (text !== undefined)
+            brandAudiences[name] = text;
+    }
+    const platformChecks = (profile.checks ?? []).filter((c) => c.platform === "all" || c.platform === platform);
+    // D22/§21 — the view. `facts` is what renderers may see; `profile` (unfiltered)
+    // is what completeness scores. The split is the contract, not an accident:
+    //   - structuredData is built from the FILTERED profile, or the JSON-LD would
+    //     claim entities the render never shows;
+    //   - completeness stays on the UNFILTERED profile, because §20 scores the
+    //     WORKSPACE, not a view (hiding half the SSOT must not lower the number).
+    const selection = policy?.selection === undefined
+        ? undefined
+        : selectFacts(profile, policy.view ?? platform, platform, lang, policy.selection);
+    const facts = selection?.profile ?? profile;
+    return {
+        platform,
+        lang,
+        flavor: profile.flavor ?? "person",
+        // facts — untouched
+        identity: facts.identity,
+        experience: facts.experience ?? [],
+        projects: facts.projects ?? [],
+        publications: facts.publications ?? [],
+        skills: facts.skills ?? [],
+        socialHandles: profile.socialHandles ?? [],
+        newsletter: profile.newsletter,
+        podcast: profile.podcast,
+        press: profile.press ?? [],
+        brandAudiences,
+        // language-aware text
+        bios: (profile.bios ?? []).filter((b) => b.platform === platform && b.lang === lang),
+        headlines: (profile.headlines ?? []).filter((h) => h.platform === platform && h.lang === lang),
+        statement: langText(positioning?.statement, "positioning.statement"),
+        audiences,
+        citationsGoal: langText(positioning?.geo?.citationsGoal, "positioning.geo.citationsGoal"),
+        keywords: {
+            seo: profile.keywords?.seo?.[platform] ?? [],
+            geo: profile.keywords?.geo ?? {},
+        },
+        checks: platformChecks,
+        // Evidence registry (v1.4/D17, §18) — facts, pass through untouched.
+        credentials: facts.credentials ?? [],
+        artifacts: facts.artifacts ?? [],
+        ...(profile.active?.[platform] ? { active: profile.active[platform] } : {}),
+        // v1.6 (#103): entity structured-data identity — assembled ONCE here, so no
+        // renderer re-derives `@id`/`sameAs` (SPEC §15.4, the §18.9 precedent).
+        structuredData: structuredData(facts, lang),
+        // Issue #102: the completeness report travels WITH the slice (like
+        // structuredData) so a renderer emits the number verbatim and never
+        // recomputes it. `policy` is the workspace's `.pascorc` policy when the CLI
+        // passes it, so the artifact and `pasco status --completeness` agree
+        // (review of #205, finding 3); omitted ⇒ the shipped default.
+        completeness: completeness(normalizeProfile(profile), policy),
+        ...(selection === undefined ? {} : { selection: selection.report }),
+        fallbacks,
+    };
+}
+//# sourceMappingURL=compile.js.map

package/dist/compile.js.map

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

package/dist/completeness.d.ts

@@ -0,0 +1,81 @@
+/**
+ * completeness(profile, policy) — the profile-completeness checklist (issue #102).
+ *
+ * The engine computes; the workspace stores only the POLICY (weights, target,
+ * expected langs) and a GENERATED view — never the percentage (a derived number
+ * that would drift). Same contract as `geoCheck` (SPEC §7): pure, deterministic,
+ * offline, no network.
+ *
+ * Five signals, each an already-present engine fact (the set ratified 2026-10-07):
+ *
+ *   presence     blocks vs the flavor's expected set (flavor + top-level props)
+ *   langCoverage en/es/fr coverage of every langMap (load/schema)
+ *   geoAnchors   semantic associations reinforced elsewhere (geoCheck's surface)
+ *   evidence     claims that carry a source + registry entries (`evidenceItem`)
+ *   deployment   share of trackable units with a ledger record (`ledger`)
+ *
+ * Policy is parameterized (dev-methodology §3): a user says "my target is the
+ * GitHub milestone set, not everything" by dropping an item (weight 0) — a
+ * parameter, never a code path. No weights are hardcoded outside the catalog.
+ */
+import type { LoadedProfile } from "./types.js";
+/** One scored signal the engine can compute. */
+export type CompletenessSignal = "presence" | "langCoverage" | "geoAnchors" | "evidence" | "deployment";
+/** A catalog entry: the engine-owned definition of one completeness item. */
+export interface CompletenessCatalogItem {
+    id: CompletenessSignal;
+    label: string;
+    /** The profile block(s) this item draws on — the issue's "source" column. */
+    block: string;
+    /** The shipped, documented default weight (normalized when the score is computed). */
+    weight: number;
+}
+/**
+ * The item catalog — the engine's knowledge of what "complete" can mean.
+ * `weight` here is the DEFAULT policy's weight; a policy overrides per id.
+ */
+export declare const COMPLETENESS_CATALOG: readonly CompletenessCatalogItem[];
+/** The policy: what a workspace is being measured against. */
+export interface CompletenessPolicy {
+    /** Name of the milestone this policy targets (informational, e.g. `github-milestone`). */
+    target?: string;
+    /** Languages text coverage is measured in (default: en/es/fr). */
+    langs?: readonly string[];
+    /** Per-item weight override; weight 0 removes the item from the score. */
+    items?: readonly {
+        id: string;
+        weight: number;
+    }[];
+}
+/** One computed item: a score in 0..1, its weight, and a short EN detail. */
+export interface CompletenessItemResult {
+    id: string;
+    label: string;
+    block: string;
+    score: number;
+    weight: number;
+    satisfied: boolean;
+    detail: string;
+}
+export interface CompletenessReport {
+    /** 0..100, weighted mean of the item scores (one decimal, byte-stable). */
+    percent: number;
+    /** Items with score 1 — the numerator of the `11/18` surface. */
+    satisfied: number;
+    /** Items considered by the policy (weight > 0). */
+    total: number;
+    target: string;
+    items: CompletenessItemResult[];
+}
+/** The shipped, documented default (overridable per workspace via `.pascorc`). */
+export declare const DEFAULT_COMPLETENESS_POLICY: CompletenessPolicy;
+/**
+ * Compute the profile's completeness against a policy.
+ *
+ * @param profile a `load()`ed (normalized) profile — array blocks are defined.
+ * @param policy  weights/target/langs; omitted ⇒ {@link DEFAULT_COMPLETENESS_POLICY}.
+ */
+export declare function completeness(profile: LoadedProfile, policy?: CompletenessPolicy): CompletenessReport;
+/** `62.5% — 3/5` — the deterministic one-liner the CLI and the renderer share. */
+export declare function completenessLine(report: CompletenessReport): string;
+//# sourceMappingURL=completeness.d.ts.map

package/dist/completeness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completeness.d.ts","sourceRoot":"","sources":["../src/completeness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,gDAAgD;AAChD,MAAM,MAAM,kBAAkB,GAC1B,UAAU,GACV,cAAc,GACd,YAAY,GACZ,UAAU,GACV,YAAY,CAAC;AAEjB,6EAA6E;AAC7E,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,kBAAkB,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,uBAAuB,EAMzD,CAAC;AAEX,8DAA8D;AAC9D,MAAM,WAAW,kBAAkB;IACjC,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,0EAA0E;IAC1E,KAAK,CAAC,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACnD;AAED,6EAA6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,sBAAsB,EAAE,CAAC;CACjC;AAED,kFAAkF;AAClF,eAAO,MAAM,2BAA2B,EAAE,kBAGzC,CAAC;AAmOF;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,aAAa,EACtB,MAAM,GAAE,kBAAgD,GACvD,kBAAkB,CA6CpB;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAEnE"}