@mailwoman/soil 9.2.0

package/out/sdk/survey-area.js

@@ -0,0 +1,346 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   One survey area's attributes, its own metadata, and its mapped footprint.
+ *
+ *   THE FOOTPRINT IS THE SURVEY-AREA OUTLINE, NEVER THE UNION OF THE RATED POLYGONS. `NOTCOM`,
+ *   access-denied and `NOTPUB` map units are INSIDE the footprint and carry no rating, so a footprint taken
+ *   from the rated set would report them as unmapped when the authority has declared exactly what they are.
+ *   The archive ships the outline as its own shapefile — `soilsa_a_<areasymbol>.shp`, one feature — which is
+ *   why this layer never has to reconstruct it.
+ *
+ *   THE REFRESH DATE IS NOT THE SURVEY DATE, AND CONFLATING THEM IS THE CURRENCY LIE THIS FILE EXISTS TO
+ *   PREVENT. `IA153` carries `saverest` 2025-09-09 and version 28, and the FGDC lineage inside the same
+ *   archive cites `Soil Survey of Polk County, Iowa`, 1:15,840, **1960**. The dataset's own
+ *   time-period-of-content runs 1998-09-22 to 2025-09-09, so a consumer reading that as survey currency
+ *   reads it wrong by sixty-five years. Both dates are stored, apart, with the title the older one came
+ *   from so it is checkable rather than assertible.
+ *
+ *   TWO SCALES, ALSO DIFFERENT FACTS. `legend.projectscale` is 12,000 for `IA153` — the scale the map units
+ *   were digitized at. The 1960 source citation's own `srcscale` is 15,840 — the scale the ground was
+ *   walked at. Storing one as the other would answer the enlargement caveat's question wrongly.
+ *
+ *   THE LICENCE IS CHECKED PER SURVEY AREA, against the `useconst` element of the metadata that area ships.
+ *   An area whose use constraints no longer say "This is public information" is a licence change, and a
+ *   build that absorbed one would ship an artifact under terms nobody checked. The text is boilerplate
+ *   repeated across SSURGO, which is why asserting it is cheap and why a change in it is loud.
+ */
+import { parseJSONStrict } from "@mailwoman/core/objects";
+import { runFile } from "@mailwoman/core/process";
+import { domainCodes, readDeclaredDomains, readTable, readTabularDictionary } from "#sdk/tabular";
+import { COINTERP_OVERALL_RULE_DEPTH, farmlandScope, NCCPI_V3_RULE_NAME, SSURGO_NO_MAPPING_NAMES, SSURGO_NO_MAPPING_SYMBOLS, SSURGO_PUBLIC_INFORMATION_SENTENCE, } from "#vocabulary";
+/**
+ * The declared domains this layer validates against, and stores.
+ *
+ * `capability_class` is shared by `nirrcapcl`, `irrcapcl` and `muaggatt.niccdcd`, which is why one domain covers three
+ * columns.
+ */
+export const STORED_DOMAINS = [
+    "capability_class",
+    "capability_subclass",
+    "farmland_classification",
+    "component_kind",
+    "mapunit_kind",
+    "mapunit_status",
+];
+/**
+ * Read one survey area's tabular export.
+ *
+ * @throws {Error} When the metadata's use constraints no longer carry the public-information sentence, when a `Choice`
+ *   column holds a value outside the authority's own declared domain, or when the export declares no legend row.
+ */
+export async function readSurveyAreaAttributes(tabularDirectory, areaSymbol) {
+    const dictionary = await readTabularDictionary(tabularDirectory);
+    const domains = await readDeclaredDomains(tabularDirectory);
+    const catalog = await readTable(tabularDirectory, dictionary, "sacatalog", [
+        "areasymbol",
+        "areaname",
+        "saverest",
+        "saversion",
+        "fgdcmetadata",
+    ]);
+    if (catalog.rows.length !== 1) {
+        throw new Error(`soil survey area: ${areaSymbol}'s sacatlog.txt holds ${catalog.rows.length} records, expected 1 — a survey-area archive describes exactly one survey area`);
+    }
+    const catalogRow = catalog.rows[0];
+    const metadata = readFGDCMetadata(catalogRow.fgdcmetadata, areaSymbol);
+    const legend = await readTable(tabularDirectory, dictionary, "legend", [
+        "areasymbol",
+        "areaname",
+        "areaacres",
+        "projectscale",
+    ]);
+    if (!legend.rows.length) {
+        throw new Error(`soil survey area: ${areaSymbol}'s legend.txt holds no record, so the published area is unknown`);
+    }
+    const legendRow = legend.rows.find((row) => row.areasymbol === areaSymbol) ?? legend.rows[0];
+    const mapUnitRows = await readTable(tabularDirectory, dictionary, "mapunit", [
+        "mukey",
+        "musym",
+        "muname",
+        "mukind",
+        "mustatus",
+        "farmlndcl",
+    ]);
+    const aggregate = await readTable(tabularDirectory, dictionary, "muaggatt", ["mukey", "niccdcd", "niccdcdpct"]);
+    const aggregateByMukey = new Map(aggregate.rows.map((row) => [row.mukey, row]));
+    const componentRows = await readTable(tabularDirectory, dictionary, "component", [
+        "cokey",
+        "mukey",
+        "comppct_r",
+        "compname",
+        "compkind",
+        "nirrcapcl",
+        "nirrcapscl",
+        "irrcapcl",
+        "irrcapscl",
+    ]);
+    const nccpiByCokey = await readNCCPI(tabularDirectory, dictionary);
+    const classCodes = domainCodes(domains, "capability_class");
+    const subclassCodes = domainCodes(domains, "capability_subclass");
+    const componentKinds = domainCodes(domains, "component_kind");
+    const farmlandCodes = domainCodes(domains, "farmland_classification");
+    const mapUnitKinds = domainCodes(domains, "mapunit_kind");
+    const componentsByMukey = new Map();
+    const components = componentRows.rows.map((row) => {
+        assertDeclared(classCodes, row.nirrcapcl, "capability_class", `component ${row.cokey}.nirrcapcl`);
+        assertDeclared(classCodes, row.irrcapcl, "capability_class", `component ${row.cokey}.irrcapcl`);
+        assertDeclared(subclassCodes, row.nirrcapscl, "capability_subclass", `component ${row.cokey}.nirrcapscl`);
+        assertDeclared(subclassCodes, row.irrcapscl, "capability_subclass", `component ${row.cokey}.irrcapscl`);
+        assertDeclared(componentKinds, row.compkind, "component_kind", `component ${row.cokey}.compkind`);
+        componentsByMukey.set(row.mukey, (componentsByMukey.get(row.mukey) ?? 0) + 1);
+        return {
+            cokey: row.cokey,
+            mukey: row.mukey,
+            // A blank `comppct_r` is a component with no declared weight. Zero is the truthful reading — it contributes
+            // nothing to a weighted share — and it is recorded rather than dropped, so the component still appears.
+            comppct_r: row.comppct_r ? Number(row.comppct_r) : 0,
+            compname: nullable(row.compname),
+            compkind: nullable(row.compkind),
+            nirrcapcl: nullable(row.nirrcapcl),
+            nirrcapscl: nullable(row.nirrcapscl),
+            irrcapcl: nullable(row.irrcapcl),
+            irrcapscl: nullable(row.irrcapscl),
+            nccpi_v3: nccpiByCokey.get(row.cokey) ?? null,
+        };
+    });
+    const mapUnits = mapUnitRows.rows.map((row) => {
+        assertDeclared(farmlandCodes, row.farmlndcl, "farmland_classification", `map unit ${row.mukey}.farmlndcl`);
+        assertDeclared(mapUnitKinds, row.mukind, "mapunit_kind", `map unit ${row.mukey}.mukind`);
+        const aggregated = aggregateByMukey.get(row.mukey);
+        assertDeclared(classCodes, aggregated?.niccdcd, "capability_class", `map unit ${row.mukey}.niccdcd`);
+        return {
+            mukey: row.mukey,
+            areasymbol: areaSymbol,
+            musym: row.musym,
+            muname: row.muname,
+            mukind: nullable(row.mukind),
+            mustatus: nullable(row.mustatus),
+            farmlndcl: nullable(row.farmlndcl),
+            farmland_scope: farmlandScope(row.farmlndcl),
+            niccdcd: nullable(aggregated?.niccdcd),
+            niccdcdpct: aggregated?.niccdcdpct ? Number(aggregated.niccdcdpct) : null,
+            no_mapping: isNoMapping(row.musym, row.muname, componentsByMukey.get(row.mukey) ?? 0) ? 1 : 0,
+        };
+    });
+    return {
+        areasymbol: areaSymbol,
+        areaname: legendRow.areaname || catalogRow.areaname,
+        saverest: metadata.publicationDate,
+        saversion: catalogRow.saversion ? Number(catalogRow.saversion) : null,
+        surveySourceDate: metadata.oldestSourceDate,
+        surveySourceTitle: metadata.oldestSourceTitle,
+        sourceScale: metadata.oldestSourceScale,
+        mappingScale: legendRow.projectscale ? Number(legendRow.projectscale) : null,
+        areaAcres: legendRow.areaacres ? Number(legendRow.areaacres) : null,
+        mapUnits,
+        components,
+        domains: domains.filter((member) => STORED_DOMAINS.includes(member.domain)),
+    };
+}
+/**
+ * A polygon the authority drew with no soil mapping behind it.
+ *
+ * Three signals rather than one, because the source encodes the same fact three ways and each on its own has a gap: the
+ * symbol (`NOTCOM`, `NOTPUB`), the name (`Area not surveyed, access denied`), and the structural case of a map unit
+ * carrying NO components at all. A map unit with no components has nothing to rate whatever it is called, and reading
+ * it as "rated nothing" rather than "no mapping" would put it in `unrated_share` — a claim that the survey looked and
+ * declined, when it did not look.
+ */
+function isNoMapping(musym, muname, componentCount) {
+    if (SSURGO_NO_MAPPING_SYMBOLS.has(musym.toUpperCase()))
+        return true;
+    if (SSURGO_NO_MAPPING_NAMES.has(muname.trim().toLowerCase()))
+        return true;
+    return componentCount === 0;
+}
+/**
+ * Refuse a value outside the authority's own declared domain.
+ *
+ * An unknown code is a source-schema change, which is the event a reader most needs to hear about; coercing it to a
+ * nearest neighbour or to NULL converts "the source changed" into "there is nothing here". A BLANK is not a violation:
+ * NULL is a real state in every one of these columns and means something specific — for `nirrcapcl` it means the survey
+ * did not rate the component, which is not class 8.
+ */
+function assertDeclared(declared, value, domain, where) {
+    if (!value)
+        return;
+    if (declared.has(value))
+        return;
+    throw new Error(`soil survey area: ${where} holds ${JSON.stringify(value)}, which is not in the authority's declared ${domain} domain (${declared.size} members, read from the archive's own msdomdet.txt) — an unknown code is a source-schema change, and coercing it would turn "the source changed" into "there is nothing here"`);
+}
+function nullable(value) {
+    return value || null;
+}
+/**
+ * The NCCPI v3.0 overall index per component.
+ *
+ * `cointerp` is the largest table in the export — 157,063 rows for `IA153`, read in 0.36 s — and the overall rule is
+ * one row per component at {@link COINTERP_OVERALL_RULE_DEPTH}: 369 of 369 components on `IA153`, of which 327 carry a
+ * value. Sub-rules at greater depths are the submodels (corn, soybeans, small grains, cotton), which this layer does
+ * not carry.
+ */
+async function readNCCPI(tabularDirectory, dictionary) {
+    const rows = await readTable(tabularDirectory, dictionary, "cointerp", [
+        "cokey",
+        "mrulename",
+        "ruledepth",
+        "interphr",
+    ]);
+    const byCokey = new Map();
+    for (const row of rows.rows) {
+        if (row.mrulename !== NCCPI_V3_RULE_NAME)
+            continue;
+        if (row.ruledepth !== COINTERP_OVERALL_RULE_DEPTH)
+            continue;
+        if (!row.interphr)
+            continue;
+        byCokey.set(row.cokey, Number(row.interphr));
+    }
+    return byCokey;
+}
+/**
+ * Read the metadata NRCS ships inside the archive.
+ *
+ * Targeted extraction rather than a general XML parse, and NOT for want of a parser — `@mailwoman/core` ships
+ * `htmlparser2`. A parser RECOVERS an unclosed element by giving it the rest of the document as its content, and the
+ * two values below that throw would then stamp the artifact with that content instead. {@link elementText} answers
+ * `undefined` for an element it cannot read, which is what makes the throw reachable. Every value this reader cannot
+ * find is reported as `null` EXCEPT the publication date and the licence sentence, which throw — those two decide the
+ * artifact's vintage and whether it may be shipped at all, and neither has a safe default.
+ *
+ * @throws {Error} When the metadata carries no publication date, or its use constraints no longer carry the
+ *   public-information sentence.
+ */
+export function readFGDCMetadata(xml, areaSymbol) {
+    const useConstraints = elementText(xml, "useconst");
+    if (!useConstraints?.includes(SSURGO_PUBLIC_INFORMATION_SENTENCE)) {
+        throw new Error(`soil survey area: ${areaSymbol}'s FGDC use constraints do not carry ${JSON.stringify(SSURGO_PUBLIC_INFORMATION_SENTENCE)} — that sentence is the grant this layer ships on, so a survey area without it must not be built into a distributable artifact`);
+    }
+    const publicationDate = elementText(xml, "pubdate");
+    if (!publicationDate) {
+        throw new Error(`soil survey area: ${areaSymbol}'s FGDC metadata carries no publication date — stamping the artifact with a guessed vintage would give it a version that means nothing`);
+    }
+    const sources = readSourceCitations(xml);
+    const oldest = sources.toSorted((left, right) => (left.date < right.date ? -1 : 1))[0];
+    return {
+        publicationDate: normalizeFGDCDate(publicationDate),
+        oldestSourceDate: oldest ? normalizeFGDCDate(oldest.date) : null,
+        oldestSourceTitle: oldest?.title ?? null,
+        oldestSourceScale: oldest?.scale ?? null,
+    };
+}
+/**
+ * The lineage's source citations: what the polygons rest on, and when each was made.
+ */
+function readSourceCitations(xml) {
+    const citations = [];
+    for (const body of elementBlocks(xml, "srcinfo")) {
+        // `caldate` for a single date, `begdate` for a range. A range's END is when the source stopped being collected;
+        // its BEGINNING is when the ground was first looked at, which is the fact this layer is carrying.
+        const date = elementText(body, "caldate") ?? elementText(body, "begdate");
+        if (!date)
+            continue;
+        const scale = elementText(body, "srcscale");
+        citations.push({
+            date: date.trim(),
+            title: (elementText(body, "title") ?? "").replaceAll(/\s+/gu, " ").trim(),
+            scale: scale ? Number(scale) : null,
+        });
+    }
+    return citations;
+}
+/**
+ * The text of the first `<name>` element, whitespace left alone.
+ *
+ * INDEX SCANS RATHER THAN A REGEX, AND THAT IS A CORRECTNESS CHOICE RATHER THAN A SPEED ONE. The obvious form — ``new
+ * RegExp(`<${name}>([\\s\\S]*?)</${name}>`)`` — backtracks polynomially on a document whose opening tag has no closing
+ * partner: the lazy run re-scans to the end from every candidate start. The input here is a 43,251-character document
+ * that arrived over the network inside a downloaded archive, so "a malformed one cannot happen" is not a claim this
+ * reader gets to make. Two `indexOf` calls answer the same question in one pass.
+ */
+function elementText(xml, name) {
+    const open = `<${name}>`;
+    const start = xml.indexOf(open);
+    if (start === -1)
+        return undefined;
+    const from = start + open.length;
+    const end = xml.indexOf(`</${name}>`, from);
+    // An element with no closing tag is unreadable, not empty — the same answer an absent element gets, because both
+    // mean the value could not be read rather than that it is blank.
+    return end === -1 ? undefined : xml.slice(from, end);
+}
+/**
+ * Every `<name>` element's inner text, in document order. The repeating counterpart of {@link elementText}, and linear
+ * for the same reason.
+ */
+function elementBlocks(xml, name) {
+    const open = `<${name}>`;
+    const close = `</${name}>`;
+    const blocks = [];
+    let cursor = 0;
+    for (;;) {
+        const start = xml.indexOf(open, cursor);
+        if (start === -1)
+            return blocks;
+        const from = start + open.length;
+        const end = xml.indexOf(close, from);
+        if (end === -1)
+            return blocks;
+        blocks.push(xml.slice(from, end));
+        cursor = end + close.length;
+    }
+}
+/**
+ * FGDC dates arrive as `YYYY` or `YYYYMMDD`. Both are kept as they are meant — a bare year is a bare year, and padding
+ * it to January 1 would invent a precision the citation does not claim.
+ */
+function normalizeFGDCDate(value) {
+    const trimmed = value.trim();
+    const matched = /^(\d{4})(\d{2})(\d{2})$/u.exec(trimmed);
+    return matched ? `${matched[1]}-${matched[2]}-${matched[3]}` : trimmed;
+}
+/**
+ * Read the survey area's own outline shapefile as a GeoJSON geometry.
+ *
+ * @throws {Error} When the shapefile holds anything other than exactly one feature. Taking the first of several would
+ *   silently choose which ground the coverage claim is about.
+ */
+export async function readSurveyAreaOutline(shapefilePath) {
+    const { stdout } = await runFile("ogr2ogr", ["-f", "GeoJSON", "/vsistdout/", "-t_srs", "EPSG:4326", shapefilePath], {
+        maxBuffer: 256 * 1024 * 1024,
+    });
+    const collection = parseJSONStrict(stdout);
+    const features = collection.features ?? [];
+    if (features.length !== 1) {
+        throw new Error(`soil survey area: ${shapefilePath} holds ${features.length} features, expected exactly 1 — a survey area publishes one outline, and taking the first of several would silently choose which ground the coverage claim is about`);
+    }
+    const geometry = features[0].geometry;
+    if (!geometry) {
+        throw new Error(`soil survey area: ${shapefilePath}'s single feature carries no geometry`);
+    }
+    return geometry;
+}
+//# sourceMappingURL=survey-area.js.map

package/out/sdk/survey-area.js.map

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

package/out/sdk/tabular.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   The pipe-delimited NASIS export inside a survey-area archive: which file holds which table, which
+ *   column sits at which position, and the authority's own declared domains.
+ *
+ *   THE FILES CARRY NO HEADER AND THE ARCHIVE SHIPS THE SCHEMA. `mstab.txt` maps a logical table name to
+ *   the file base name that holds it (`component` → `comp.txt`, `sacatalog` → `sacatlog.txt` — neither is
+ *   guessable), and `mstabcol.txt` gives every column's ordinal position. So the reader looks the positions
+ *   up rather than hard-coding them, and {@link readTable} THROWS on a requested column the shipped
+ *   dictionary does not declare. A reader that quietly returned `undefined` for a renamed column would turn
+ *   "the source changed" into "there is none of it", at exactly the measurement boundary where that lie
+ *   costs the most.
+ *
+ *   QUOTE HANDLING IS NOT OPTIONAL HERE, AND THE MEASUREMENT determines the result. `sacatlog.txt` holds 594 newline
+ *   bytes and exactly ONE record: its `fgdcmetadata` column carries a 43,251-character XML document with
+ *   embedded newlines. `mstabcol.txt` — the column dictionary itself — holds 913 newlines and 865 records.
+ *   A line-splitting reader gets 594 malformed rows from a one-row file, every one of them well-formed
+ *   enough to keep going.
+ *
+ *   THE DECLARED DOMAINS COME OUT OF THE ARCHIVE TOO, which is stronger than transcribing them.
+ *   `msdomdet.txt` carries every `Choice` column's members WITH the authority's own prose definition —
+ *   capability classes 1 through 8, subclasses `c`/`e`/`s`/`w`, the 28 conditional farmland
+ *   classifications, the six component kinds. The layer stores them and validates against them.
+ */
+import { type PathBuilderLike } from "path-ts";
+/**
+ * One parsed record: the raw column strings, in the authority's declared order.
+ */
+export type TabularRow = ReadonlyArray<string>;
+/**
+ * The archive's own description of itself: table → file, and table → column positions.
+ */
+export interface TabularDictionary {
+    /**
+     * Logical table name → file base name, from `mstab.txt`.
+     */
+    files: ReadonlyMap<string, string>;
+    /**
+     * Logical table name → column name → zero-based position, from `mstabcol.txt`.
+     */
+    columns: ReadonlyMap<string, ReadonlyMap<string, number>>;
+}
+/**
+ * Read the archive's table and column dictionaries.
+ *
+ * @throws {Error} When either bootstrap file is missing or is not the declared width.
+ */
+export declare function readTabularDictionary(tabularDirectory: PathBuilderLike): Promise<TabularDictionary>;
+/**
+ * A reader over one logical table, projecting the columns a caller names.
+ *
+ * The projection is by NAME and a missing name throws, which is the whole point: this is the shape that produced the
+ * repository's worst measurement bugs, where a silently dropped column read downstream as an empty world.
+ */
+export interface TabularTable {
+    /**
+     * One record per row, already projected to the requested columns.
+     */
+    rows: ReadonlyArray<Record<string, string>>;
+    /**
+     * How many records the file held, before projection.
+     */
+    recordCount: number;
+}
+/**
+ * Read a logical SSURGO table, projecting `wanted` columns.
+ *
+ * @throws {Error} When the archive declares no file for the table, when a requested column is not in the shipped
+ *   dictionary, or when a record is narrower than the position a requested column sits at.
+ */
+export declare function readTable(tabularDirectory: PathBuilderLike, dictionary: TabularDictionary, table: string, wanted: ReadonlyArray<string>): Promise<TabularTable>;
+/**
+ * One declared domain member, with the authority's own definition.
+ */
+export interface DomainMember {
+    domain: string;
+    code: string;
+    definition: string;
+    sequence: number;
+}
+/**
+ * Read the authority's declared domains out of the archive.
+ *
+ * @throws {Error} When the file is not the declared width.
+ */
+export declare function readDeclaredDomains(tabularDirectory: PathBuilderLike): Promise<DomainMember[]>;
+/**
+ * The declared members of one domain, keyed by code.
+ */
+export declare function domainCodes(members: ReadonlyArray<DomainMember>, domain: string): Set<string>;
+/**
+ * `M/D/YYYY H:MM:SS` (and the `MM/DD/YYYY HH:MM:SS` the tabular export writes) to an ISO date.
+ *
+ * The two channels spell the same instant differently — Soil Data Access answers `9/9/2025 1:57:25 PM` and the shipped
+ * `sacatlog.txt` writes `09/09/2025 13:57:25` — and the download URL needs `2025-09-09`. Parsing to a date rather than
+ * slicing the string is what makes both channels agree.
+ *
+ * @throws {Error} When the value is not one of those shapes. A freshness date guessed wrong asks the download host for
+ *   a file that does not exist, and the host answers 400 rather than 404, which reads as a bad request rather than a
+ *   bad date.
+ */
+export declare function saverestToISODate(value: string): string;
+//# sourceMappingURL=tabular.d.ts.map

package/out/sdk/tabular.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabular.d.ts","sourceRoot":"","sources":["../../lib/sdk/tabular.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAQ,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAGpD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;AA2B9C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACzD;AAuBD;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,gBAAgB,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA+BzG;AAYD;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC3C;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC9B,gBAAgB,EAAE,eAAe,EACjC,UAAU,EAAE,iBAAiB,EAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAC3B,OAAO,CAAC,YAAY,CAAC,CA+CvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;CAChB;AASD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,gBAAgB,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAWpG;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAU7F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYvD"}