cbrowser 20.2.2 → 21.0.1

package/dist/visual/provenance/perceptual.js

@@ -0,0 +1,115 @@
+import { PERCEPTUAL_PROFILES, DEFAULT_PROFILE } from "../perceptual-transport.js";
+/** Per barrier key: the barrier, as a reader would name it. */
+const BARRIERS = {
+    touch_target: "small or crowded touch and click target",
+    low_contrast: "low-contrast text",
+    cognitive_load: "high cognitive load (dense or complex layout)",
+    timing: "time limit or timed content",
+    color_only: "information carried by colour alone",
+    missing_alt: "image without a text alternative",
+    missing_label: "form field without a label",
+    hover_dependent: "content reachable only by hover",
+    form_complexity: "long or complex form",
+    audio_description: "video without audio description",
+    captions: "media without captions",
+};
+/** Per visual-filter field: what it models and the measure that would place a population on it. */
+const FILTER_FIELDS = {
+    contrastThreshold: { what: "minimum contrast perceived", measure: "Pelli-Robson contrast sensitivity" },
+    blurRadius: { what: "blur simulating reduced acuity", measure: "visual acuity (logMAR) at a stated viewing distance, converted to screen pixels" },
+    "colorAttenuation.r": { what: "red-channel attenuation", measure: "axis-specific colour discrimination (e.g. Farnsworth-Munsell 100-hue, protan axis)" },
+    "colorAttenuation.g": { what: "green-channel attenuation", measure: "axis-specific colour discrimination (e.g. Farnsworth-Munsell 100-hue, deutan axis)" },
+    "colorAttenuation.b": { what: "blue-channel attenuation", measure: "axis-specific colour discrimination (e.g. Farnsworth-Munsell 100-hue, tritan axis)" },
+    motorCostMultiplier: { what: "cost of reaching interactive elements, relative to typical", measure: "pointing throughput on an ISO 9241-411 tapping task, as a ratio to a typical sample" },
+    processingSpeed: { what: "processing speed, relative to typical (it attenuates weak saliency in the attention map)", measure: "the Symbol Digit Modalities Test, as a ratio to the norm" },
+    noiseTolerance: { what: "tolerance of visual clutter", measure: "the slowdown of visual search on cluttered against uncluttered displays" },
+};
+/** Per profile: the population a test sample would come from, or the archetype's screening criterion. */
+const POPULATIONS = {
+    "first-timer": { population: "adults using the interface under test for the first time" },
+    "mobile-user": { population: "smartphone-primary web users aged 18-45" },
+    "impatient-user": { archetype: "users in the top quartile of observed abandonment rate" },
+    "power-user": { population: "expert daily web users (e.g. professional developers) aged 25-45" },
+    "elderly-user": { population: "adults aged 65 and over" },
+    "motor-impairment-tremor": { population: "adults aged 40-65 with essential tremor" },
+    "low-vision-magnified": { population: "adults aged 45-75 with low vision who use about 3x screen magnification" },
+    "cognitive-adhd": { population: "adults aged 18-45 diagnosed with ADHD" },
+    "dyslexic-user": { population: "adults aged 18-55 diagnosed with dyslexia" },
+    "color-blind-deuteranopia": { population: "adults with confirmed deuteranopia" },
+    "screen-reader-user": { population: "blind adults who use a screen reader daily" },
+    "deaf-user": { population: "deaf adults" },
+    "elderly-low-vision": { population: "adults aged 75 and over with age-related low vision" },
+};
+const DEFAULT_ID = "default";
+function sample(profile) {
+    const who = POPULATIONS[profile];
+    return "population" in who
+        ? `a sample of ${who.population}`
+        : `a sample screened as ${who.archetype} (the profile is a behavioural archetype with no population until then)`;
+}
+function barrierSource(profile, key, value) {
+    if (profile === DEFAULT_ID) {
+        return `DEFAULT_PROFILE.${key} = ${value}: a ${BARRIERS[key]} is charged at face value for a persona no profile describes. The neutral weight of a profile that models no one; no empirical claim.`;
+    }
+    return `${profile} barrier weight ${key} = ${value}, set by hand: the multiple of the points one ${BARRIERS[key]} deducts for this persona. What would fit it: the drop in task success (or rise in time on task) one such barrier costs ${sample(profile)}, divided by the drop it costs a general-population sample, on otherwise matched pages.`;
+}
+function filterSource(profile, field, value) {
+    const f = FILTER_FIELDS[field];
+    if (profile === DEFAULT_ID) {
+        return `DEFAULT_PROFILE visual filter ${field} = ${value} (${f.what}): the identity filter of a profile that models no one; no empirical claim.`;
+    }
+    return `${profile} visual filter ${field} = ${value} (${f.what}), set by hand. What would test it: ${f.measure}, in ${sample(profile)}.`;
+}
+/**
+ * Build one entry per numeric barrier weight and visual-filter field. A value
+ * whose profile, barrier key or field this file has no description for is
+ * reported as uncovered instead of registered, so the test fails rather than
+ * the module.
+ */
+export function cataloguePerceptualProfiles(profiles, defaultProfile) {
+    const entries = [];
+    const uncovered = [];
+    const seen = new Set();
+    const add = (id, value, known, status, source) => {
+        if (seen.has(id) || !known) {
+            uncovered.push(id);
+            return;
+        }
+        seen.add(id);
+        entries.push({ id, value, status, source: source() });
+    };
+    const all = [...Object.entries(profiles), [DEFAULT_ID, defaultProfile]];
+    for (const [name, profile] of all) {
+        const isDefault = name === DEFAULT_ID && profile === defaultProfile;
+        const knownProfile = isDefault || (name !== DEFAULT_ID && Object.hasOwn(POPULATIONS, name));
+        const status = isDefault ? "definition" : "hypothesis";
+        for (const [key, value] of Object.entries(profile.barrierWeights)) {
+            if (typeof value !== "number")
+                continue;
+            add(`perceptual.${name}.barrierWeights.${key}`, value, knownProfile && Object.hasOwn(BARRIERS, key), status, () => barrierSource(name, key, value));
+        }
+        const filter = profile.visualFilter;
+        for (const [field, value] of Object.entries(filter)) {
+            const leaves = Array.isArray(value)
+                ? value.map((v, i) => [`${field}.${"rgb"[i] ?? i}`, v])
+                : [[field, value]];
+            for (const [leaf, v] of leaves) {
+                if (typeof v !== "number")
+                    continue;
+                add(`perceptual.${name}.visualFilter.${leaf}`, v, knownProfile && Object.hasOwn(FILTER_FIELDS, leaf), status, () => filterSource(name, leaf, v));
+            }
+        }
+    }
+    return { entries, uncovered };
+}
+const CATALOGUE = cataloguePerceptualProfiles(PERCEPTUAL_PROFILES, DEFAULT_PROFILE);
+export const PERCEPTUAL_PROVENANCE = CATALOGUE.entries;
+/** Numeric fields in the profiles this file cannot describe yet. Must be empty; the test says which. */
+export const PERCEPTUAL_PROVENANCE_UNCOVERED = CATALOGUE.uncovered;
+/** The keys of the hand-written tables above, so the test can catch a stale one. */
+export const PERCEPTUAL_PROVENANCE_KEYS = {
+    barriers: Object.keys(BARRIERS),
+    filterFields: Object.keys(FILTER_FIELDS),
+    populations: Object.keys(POPULATIONS),
+};
+//# sourceMappingURL=perceptual.js.map

package/dist/visual/provenance/perceptual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perceptual.js","sourceRoot":"","sources":["../../../src/visual/provenance/perceptual.ts"],"names":[],"mappings":"AAwCA,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAA0B,MAAM,4BAA4B,CAAC;AAE1G,+DAA+D;AAC/D,MAAM,QAAQ,GAA2B;IACvC,YAAY,EAAE,yCAAyC;IACvD,YAAY,EAAE,mBAAmB;IACjC,cAAc,EAAE,+CAA+C;IAC/D,MAAM,EAAE,6BAA6B;IACrC,UAAU,EAAE,qCAAqC;IACjD,WAAW,EAAE,kCAAkC;IAC/C,aAAa,EAAE,4BAA4B;IAC3C,eAAe,EAAE,iCAAiC;IAClD,eAAe,EAAE,sBAAsB;IACvC,iBAAiB,EAAE,iCAAiC;IACpD,QAAQ,EAAE,wBAAwB;CACnC,CAAC;AAEF,mGAAmG;AACnG,MAAM,aAAa,GAAsD;IACvE,iBAAiB,EAAE,EAAE,IAAI,EAAE,4BAA4B,EAAE,OAAO,EAAE,mCAAmC,EAAE;IACvG,UAAU,EAAE,EAAE,IAAI,EAAE,gCAAgC,EAAE,OAAO,EAAE,iFAAiF,EAAE;IAClJ,oBAAoB,EAAE,EAAE,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,oFAAoF,EAAE;IACxJ,oBAAoB,EAAE,EAAE,IAAI,EAAE,2BAA2B,EAAE,OAAO,EAAE,oFAAoF,EAAE;IAC1J,oBAAoB,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,OAAO,EAAE,oFAAoF,EAAE;IACzJ,mBAAmB,EAAE,EAAE,IAAI,EAAE,4DAA4D,EAAE,OAAO,EAAE,qFAAqF,EAAE;IAC3L,eAAe,EAAE,EAAE,IAAI,EAAE,0FAA0F,EAAE,OAAO,EAAE,0DAA0D,EAAE;IAC1L,cAAc,EAAE,EAAE,IAAI,EAAE,6BAA6B,EAAE,OAAO,EAAE,yEAAyE,EAAE;CAC5I,CAAC;AAEF,yGAAyG;AACzG,MAAM,WAAW,GAAmE;IAClF,aAAa,EAAE,EAAE,UAAU,EAAE,0DAA0D,EAAE;IACzF,aAAa,EAAE,EAAE,UAAU,EAAE,yCAAyC,EAAE;IACxE,gBAAgB,EAAE,EAAE,SAAS,EAAE,wDAAwD,EAAE;IACzF,YAAY,EAAE,EAAE,UAAU,EAAE,kEAAkE,EAAE;IAChG,cAAc,EAAE,EAAE,UAAU,EAAE,yBAAyB,EAAE;IACzD,yBAAyB,EAAE,EAAE,UAAU,EAAE,yCAAyC,EAAE;IACpF,sBAAsB,EAAE,EAAE,UAAU,EAAE,yEAAyE,EAAE;IACjH,gBAAgB,EAAE,EAAE,UAAU,EAAE,uCAAuC,EAAE;IACzE,eAAe,EAAE,EAAE,UAAU,EAAE,2CAA2C,EAAE;IAC5E,0BAA0B,EAAE,EAAE,UAAU,EAAE,oCAAoC,EAAE;IAChF,oBAAoB,EAAE,EAAE,UAAU,EAAE,4CAA4C,EAAE;IAClF,WAAW,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE;IAC1C,oBAAoB,EAAE,EAAE,UAAU,EAAE,qDAAqD,EAAE;CAC5F,CAAC;AAEF,MAAM,UAAU,GAAG,SAAS,CAAC;AAQ7B,SAAS,MAAM,CAAC,OAAe;IAC7B,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACjC,OAAO,YAAY,IAAI,GAAG;QACxB,CAAC,CAAC,eAAe,GAAG,CAAC,UAAU,EAAE;QACjC,CAAC,CAAC,wBAAwB,GAAG,CAAC,SAAS,yEAAyE,CAAC;AACrH,CAAC;AAED,SAAS,aAAa,CAAC,OAAe,EAAE,GAAW,EAAE,KAAa;IAChE,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,OAAO,mBAAmB,GAAG,MAAM,KAAK,OAAO,QAAQ,CAAC,GAAG,CAAC,uIAAuI,CAAC;IACtM,CAAC;IACD,OAAO,GAAG,OAAO,mBAAmB,GAAG,MAAM,KAAK,iDAAiD,QAAQ,CAAC,GAAG,CAAC,2HAA2H,MAAM,CAAC,OAAO,CAAC,yFAAyF,CAAC;AACtV,CAAC;AAED,SAAS,YAAY,CAAC,OAAe,EAAE,KAAa,EAAE,KAAa;IACjE,MAAM,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAC/B,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,OAAO,iCAAiC,KAAK,MAAM,KAAK,KAAK,CAAC,CAAC,IAAI,6EAA6E,CAAC;IACnJ,CAAC;IACD,OAAO,GAAG,OAAO,kBAAkB,KAAK,MAAM,KAAK,KAAK,CAAC,CAAC,IAAI,uCAAuC,CAAC,CAAC,OAAO,QAAQ,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;AAC3I,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CACzC,QAA2C,EAC3C,cAAiC;IAEjC,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAG,CAAC,EAAU,EAAE,KAAa,EAAE,KAAc,EAAE,MAAiC,EAAE,MAAoB,EAAE,EAAE;QACjH,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAAC,OAAO;QAAC,CAAC;QAC3D,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;IACxD,CAAC,CAAC;IAEF,MAAM,GAAG,GAAuC,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;IAC5G,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,GAAG,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,IAAI,KAAK,UAAU,IAAI,OAAO,KAAK,cAAc,CAAC;QACpE,MAAM,YAAY,GAAG,SAAS,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5F,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;QACvD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YAClE,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,SAAS;YACxC,GAAG,CAAC,cAAc,IAAI,mBAAmB,GAAG,EAAE,EAAE,KAAK,EAAE,YAAY,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,MAAM,EACzG,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,YAAkD,CAAC;QAC1E,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACpD,MAAM,MAAM,GAA6B,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAC3D,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;gBACvD,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;YACrB,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC;gBAC/B,IAAI,OAAO,CAAC,KAAK,QAAQ;oBAAE,SAAS;gBACpC,GAAG,CAAC,cAAc,IAAI,iBAAiB,IAAI,EAAE,EAAE,CAAC,EAAE,YAAY,IAAI,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,MAAM,EAC1G,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,SAAS,GAAG,2BAA2B,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;AAEpF,MAAM,CAAC,MAAM,qBAAqB,GAAsB,SAAS,CAAC,OAAO,CAAC;AAE1E,wGAAwG;AACxG,MAAM,CAAC,MAAM,+BAA+B,GAAsB,SAAS,CAAC,SAAS,CAAC;AAEtF,oFAAoF;AACpF,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;CACtC,CAAC"}

package/dist/visual/provenance/persona-rates.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Each built-in persona's pointing and reading rate, as a share of the
+ * reference rate: the r_p / r_ref a capacity c = r_p / (r_p + r_ref) is built
+ * from (demand-laws.ts, rateCapacity). See ../model-provenance.ts for the
+ * statuses.
+ *
+ * WHY ON THE PERSONA. Four personas state all five reading-profile values in
+ * their accessibilityTraits, so the reading-profile table never reaches them,
+ * and twenty get a throughput by interpolating on dispositions. A rate per
+ * persona, registered here with its own status and source, is the one place
+ * a decision about that persona's rate lands. A custom persona has no entry;
+ * its rates come from the profiles (provenance/profiles.ts).
+ *
+ * The values follow the persona-rate decisions of 2026-10-23
+ * (research/stage-b-persona-rates.md):
+ *   pointing  tremor: the motion-impaired rate against its own controls;
+ *             elderly (two personas): the elderly profile, a hypothesis;
+ *             cognitive-adhd: the reference, a hypothesis (no measured rate);
+ *             mobile-user: unchanged until touch is modelled;
+ *             every other persona: the reference, "no measured difference".
+ *   reading   dyslexic-user: the dyslexia rate against its own controls;
+ *             low-vision-magnified, elderly-low-vision: low vision with intact
+ *             central fields against the reference rate;
+ *             aphasia-receptive: aphasia with impaired reading comprehension
+ *             against age-matched controls (Webster et al. 2018, Stage C);
+ *             elderly-user, cognitive-adhd: today's fixation-model slowdown,
+ *             a hypothesis; intellectual-disability: its pre-21.0 share,
+ *             frozen as a number, a hypothesis;
+ *             every other persona: the reference, "no measured difference".
+ *
+ * A measured ratio is `published` only when the population and its control
+ * were measured in the same study by the same method. The low-vision rate
+ * against 238 wpm crosses methods (a peak rate on drifting text against a
+ * meta-analytic silent reading rate), so it is a hypothesis built on two
+ * published numbers. Ratios are computed here from the registered numbers they
+ * come from, so the two cannot disagree; the bridge reads them through param()
+ * (cognitive-models.ts), unrecorded, like the persona's catalogued traits.
+ * tests/persona-capacity-rates.test.ts fails if a built-in persona has no
+ * entry on a channel, or an entry names no built-in persona.
+ *
+ * CUSTOM PERSONAS (customRate.*) take the same rule as the built-ins, decided
+ * 2026-10-23: the reference rate where nothing is measured ("no measured
+ * difference"), a measured ratio where one is. The rule reads what a stored
+ * custom persona carries: the tremor flag, and words in its name and
+ * description (customPointingRule, customReadingRule; an elderly cue reads the
+ * built-in elderly-user's reading entry). An author's stated
+ * reading-profile values are honoured first, through the fixation-model
+ * ratio (cognitive-models.ts, readingRateShare), labelled hypothesis.
+ *
+ * @copyright 2026 Alexandria Eden alexandria.shai.eden@gmail.com https://cbrowser.ai
+ * @license MIT
+ */
+import type { ProvenanceEntry } from "../model-provenance.js";
+export declare const PERSONA_RATE_PROVENANCE: ProvenanceEntry[];
+export declare const CUSTOM_RATE_PROVENANCE: ProvenanceEntry[];
+/** Which customRate.* pointing rule a custom persona falls under. */
+export declare function customPointingRule(p: {
+    name?: string;
+    description?: string;
+    tremor?: unknown;
+    ageRange?: string;
+}): "tremor" | "elderly" | "noMeasuredDifference";
+/** Which reading rule a custom persona with no stated reading-profile values falls under. */
+export declare function customReadingRule(p: {
+    name?: string;
+    description?: string;
+    ageRange?: string;
+}): "dyslexia" | "lowVision" | "elderly" | "noMeasuredDifference";
+/**
+ * The registry id a reading rule reads. An elderly cue reads the built-in
+ * elderly-user's own entry (personaRate.elderly-user.reading, the fixation-model
+ * hypothesis), decided 2026-10-23 so a custom elderly persona reads as the
+ * built-in one does; the others their customRate.* entry.
+ */
+export declare function customReadingRateId(rule: ReturnType<typeof customReadingRule>): string;
+/**
+ * A persona's silent reading rate for display, wpm: 238 x its registered
+ * reading share, rounded. For the humanBehavior.timing.readingSpeed a persona
+ * carries, which personas.ts sets at load and so cannot read through param()
+ * (model-provenance.ts imports the persona tables); tests hold it equal to the
+ * param() value.
+ */
+export declare function displayReadingWpm(rateId: string): number;
+//# sourceMappingURL=persona-rates.d.ts.map

package/dist/visual/provenance/persona-rates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona-rates.d.ts","sourceRoot":"","sources":["../../../src/visual/provenance/persona-rates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,wBAAwB,CAAC;AAuDhF,eAAO,MAAM,uBAAuB,EAAE,eAAe,EA0BpD,CAAC;AAOF,eAAO,MAAM,sBAAsB,EAAE,eAAe,EAWnD,CAAC;AAGF,qEAAqE;AACrE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,GAAG,SAAS,GAAG,sBAAsB,CAKjK;AAED,6FAA6F;AAC7F,wBAAgB,iBAAiB,CAAC,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,sBAAsB,CAM9J;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,GAAG,MAAM,CAEtF;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/visual/provenance/persona-rates.js

@@ -0,0 +1,108 @@
+import { LAW_PROVENANCE } from "./laws.js";
+import { PROFILE_PROVENANCE } from "./profiles.js";
+import { isOlderAdult } from "../../persona-age.js";
+const registered = (id) => {
+    const e = [...LAW_PROVENANCE, ...PROFILE_PROVENANCE].find((x) => x.id === id);
+    if (!e)
+        throw new Error(`persona-rates: ${id} is not registered`);
+    return e.value;
+};
+const ratio = (rate, control) => registered(rate) / registered(control);
+/** The fixation model's per-word slowdown, as a rate share: the neurotypical profile's time over this profile's. */
+const fixationRatio = (phonological, visualSpan) => {
+    const ms = (phon, span) => registered("profile.fixation.baseMs")
+        + (1 - phon) * registered("profile.fixation.phonologicalMs")
+        + (registered("profile.fixation.normalSpan") / span - 1) * registered("profile.fixation.spanMs");
+    return ms(registered("profile.reading.neurotypical.phonological"), registered("profile.reading.neurotypical.visualSpan")) / ms(phonological, visualSpan);
+};
+const entry = (persona, channel, value, status, source) => ({ id: `personaRate.${persona}.${channel}`, value, status, source });
+const NO_DIFFERENCE_POINTING = "No measured difference: no source retrieved measures a mouse throughput for this persona's population (or the persona is a behavioural archetype with no population) that differs from typical, so it points at the reference rate, law.rate.pointing.reference (ratio 1, c = 0.5). It replaced an interpolation on 0.6 proceduralFluency + 0.4 patience, dispositions that no source maps to throughput. An ISO 9241-9 mouse study of the population the persona stands for would set it.";
+const NO_DIFFERENCE_READING = "No measured difference: no source retrieved measures a silent reading rate for this persona's population (or the persona is a behavioural archetype with no population) that differs from typical, so it reads at the reference rate, law.reading.wpm (ratio 1, c = 0.5). It replaced the fixation model's interpolation on 0.6 textProcessing + 0.4 comprehension toward the dyslexic profile, which no source supports. A silent reading study of the population the persona stands for would set it.";
+const POINTING_NO_DIFFERENCE = [
+    "power-user", "first-timer", "screen-reader-user", "impatient-user", "distracted-user", "careful-reader", "explorer",
+    "task-focused", "low-vision-magnified", "dyslexic-user", "deaf-user", "color-blind-deuteranopia", "autism-spectrum",
+    "intellectual-disability", "aphasia-receptive", "dyscalculia", "anxious-user", "confident-user", "emotional-user", "stoic-user",
+];
+const READING_NO_DIFFERENCE = [
+    "power-user", "first-timer", "mobile-user", "screen-reader-user", "impatient-user", "distracted-user", "careful-reader",
+    "explorer", "task-focused", "motor-impairment-tremor", "deaf-user", "color-blind-deuteranopia", "autism-spectrum",
+    "dyscalculia", "anxious-user", "confident-user", "emotional-user", "stoic-user",
+];
+const ELDERLY_POINTING = "The elderly pointing profile, profile.pointing.elderly.throughput (3.2 bits/s) against law.rate.pointing.reference (4.9). No measured ISO mouse throughput for adults 65+ was found; Chaparro et al. (1999) support the direction (\"older adults took longer to complete movements than younger adults\") but give no rate. An ISO 9241-9 mouse study of adults 65+ would set it.";
+const FIXATION_KEPT = (who, inputs, ms, why) => `Today's fixation-model slowdown for ${who}, kept as a hypothesis: the text-independent per-word time at ${inputs} is ${ms}, against 270 ms for the neurotypical profile, so the persona reads at that share of the reference rate (law.reading.wpm). ${why} A silent reading rate of the population against matched controls would set or replace it.`;
+// Stage C (21.0, research/stage-c-design.md 10.5): the cognitiveLoad text terms
+// that charged these two personas' comprehension against text are retired, so
+// their language deficit is priced here alone. The before and after are mean
+// totalCTC on the reference set named, viewport and full_page.
+const STAGE_C_SEARCH = " (also not by the one targeted PubMed search of 2026-10-23 for aphasia or intellectual disability with reading rate, reading speed or words per minute: 51 records; its one intellectual-disability record is of children, and an adult rate against controls appears in none)";
+const STAGE_C_ONLY = (who, comprehension, viewport, fullPage) => `Since Stage C (21.0) this share is the only place ${who}'s language-comprehension deficit is priced: the cognitiveLoad text terms that charged it through comprehension (${comprehension}, a UI-convention trait, not reading) are retired. On ctc-reference-v2-2026-10-24 (514 pages) its mean totalCTC moved ${viewport} at the viewport and ${fullPage} at full_page.`;
+/** intellectual-disability's reading share before 21.0 (270 / 338 ms per word), frozen: see its entry. */
+const ID_READING_BEFORE_21 = 0.7988165680473372;
+export const PERSONA_RATE_PROVENANCE = [
+    // ── Pointing ──
+    entry("motor-impairment-tremor", "pointing", ratio("law.rate.pointing.motionImpaired", "law.rate.pointing.motionImpairedControls"), "published", "Motion-impaired mouse users measured against able-bodied controls in the same study, ISO 9241-9: 1.77 / 4.88 bits/s (law.rate.pointing.motionImpaired, law.rate.pointing.motionImpairedControls). Keates, Hwang, Langdon, Clarkson & Robinson (2002), read in Soukoreff & MacKenzie (2004), IJHCS 61, Table 4: \"1.77 69 Mouse (motion impared [sic])\" and \"4.88 11 Mouse (able-bodied)\". The group is motion-impaired users in general, not essential tremor specifically, at a 69% error rate."),
+    entry("elderly-user", "pointing", ratio("profile.pointing.elderly.throughput", "law.rate.pointing.reference"), "hypothesis", ELDERLY_POINTING),
+    entry("elderly-low-vision", "pointing", ratio("profile.pointing.elderly.throughput", "law.rate.pointing.reference"), "hypothesis", ELDERLY_POINTING),
+    entry("cognitive-adhd", "pointing", 1, "hypothesis", "No measured difference, and no measured rate: no throughput for adults with ADHD was found, so the persona points at the reference rate (ratio 1). The 4.2 bits/s it carried cited Flapper, Houwen & Schoemaker (2006), Dev Med Child Neurol 48(3), 165-169: \"A group of 12 children with ADHD-DCD\", with no throughput, and a motor deficit there belongs to the coordination disorder. An ISO 9241-9 mouse study of adults with ADHD and no coordination disorder would set it."),
+    entry("mobile-user", "pointing", 3.444 / 4.9, "hypothesis", "Unchanged until touch is modelled: the 3.444 bits/s that getPointingProfile's interpolation gave the persona (0.6 x 0.6 proceduralFluency + 0.4 x 0.3 patience between 4.9 and 2.1) before the tremor anchor moved, as a share of 4.9. A mouse throughput is the wrong measure for a finger; MacKenzie (2015) reports touch throughput but no regression, so no touch path exists to set it from. A touch pointing model with a measured rate would replace it."),
+    ...POINTING_NO_DIFFERENCE.map((p) => entry(p, "pointing", 1, "hypothesis", NO_DIFFERENCE_POINTING)),
+    // ── Reading ──
+    entry("dyslexic-user", "reading", ratio("law.rate.reading.dyslexiaAdults", "law.rate.reading.dyslexiaControls"), "published", "Students with dyslexia measured against controls in the same study, silent text reading: 184.63 / 243.64 wpm (law.rate.reading.dyslexiaAdults, law.rate.reading.dyslexiaControls). Callens, Tops & Brysbaert (2012), PLoS ONE 7(6), e38081, Table 5, row \"Silent text reading (Tekenbeet)\": \"a group of 100 Dutch-speaking students diagnosed with dyslexia with a control group of 100 students without learning disabilities\". Dutch text; higher-education students are the more able end of adult dyslexia. A second source agrees in direction and size: Franzen, Stark & Johnson (2021), Individuals with dyslexia use a different visual sampling strategy to read text, Scientific Reports 11, 6449, doi:10.1038/s41598-021-84945-9: \"a lower words per minute reading rate among readers with dyslexia (Median Dyslexia = 178.09, Median Control = 248.18\", 67 adults reading silently, a ratio of 0.718 against Callens' 0.758."),
+    ...["low-vision-magnified", "elderly-low-vision"].map((p) => entry(p, "reading", ratio("law.rate.reading.lowVisionIntactFields", "law.reading.wpm"), "hypothesis", "Low vision with intact central fields, 130 wpm median peak (law.rate.reading.lowVisionIntactFields; Legge, Rubin, Pelli & Schleske 1985, Vision Research 25(2): \"peak reading rates for observers with intact central fields were at least 90 words/minute (median 130 words/minute)\"), against the reference 238 wpm. Both numbers are published; the ratio is not, because it crosses methods (a peak rate at the best character size on drifting text against a silent reading rate) and the same-method normal-vision rate was not retrieved. Intact fields rather than central-field loss (25 wpm) was decided for both low-vision personas. Legge et al.'s normal-vision peak rate on the same apparatus would set it.")),
+    entry("elderly-user", "reading", fixationRatio(0.65, 5), "hypothesis", FIXATION_KEPT("elderly-user", "the elderly reading profile (phonological 0.65, visualSpan 5)", "317 ms", "No silent-reading norm for adults 65+ was found; Brysbaert (2019) reports that the drop \"is not expected to occur before the age of 60–65\", with no rate. Custom personas cued elderly or 65+ read at this same entry (decided 2026-10-23).")),
+    entry("cognitive-adhd", "reading", fixationRatio(0.75, 6), "hypothesis", FIXATION_KEPT("cognitive-adhd", "its stated reading traits (phonologicalDecoding 0.75, visualSpan 6)", "288.3 ms", "No measured silent-reading rate for adults with ADHD was found.")),
+    entry("intellectual-disability", "reading", ID_READING_BEFORE_21, "hypothesis", `No adult reading rate found; the value is the pre-21.0 one, frozen as a number (decided 2026-10-23). Through 20.x it was the fixation model's slowdown at the profile getReadingProfile interpolated from comprehension 0.2 (phonological 0.44, visualSpan 5: 338 ms per word against the neurotypical profile's 270 ms, a share of 270 / 338). getReadingProfile no longer reads comprehension, a UI-convention trait, so the share is kept as it was rather than recomputed from a profile nothing now produces. No reading rate for adults with intellectual disability was retrieved${STAGE_C_SEARCH}. ${STAGE_C_ONLY("intellectual-disability", "0.2", "0.855 -> 0.643", "0.837 -> 0.661")} A silent reading rate of adults with mild intellectual disability against matched controls would set or replace it.`),
+    entry("aphasia-receptive", "reading", ratio("law.rate.reading.aphasiaControlsSeconds", "law.rate.reading.aphasiaReadingImpairedSeconds"), "published", "People with aphasia whose reading comprehension is impaired, measured against age-matched controls in the same study by the same method: 30 / 71 seconds for the same paragraph (law.rate.reading.aphasiaControlsSeconds, law.rate.reading.aphasiaReadingImpairedSeconds), a reading-rate share of 0.423, c = 0.297. Webster, Morris, Howard & Garraffa (2018), AJSLP 27(1S), 423-437. Found by the one targeted PubMed search of 2026-10-23 (aphasia or intellectual disability with reading rate, reading speed or words per minute; 51 records). The group is post-stroke aphasia whose comprehension accuracy fell below the controls' 5th percentile, the closest measured group to receptive aphasia; the study does not classify aphasia type. Those without a measured reading impairment took 55 seconds (share 0.545). Until 21.0 the share was the fixation model's 0.804, interpolated from comprehension 0.25, a UI-convention trait. Since Stage C this share is the only place the persona's language-comprehension deficit is priced: the cognitiveLoad text terms that charged it through comprehension are retired."),
+    ...READING_NO_DIFFERENCE.map((p) => entry(p, "reading", 1, "hypothesis", NO_DIFFERENCE_READING)),
+];
+// ── Custom personas: one entry per rule ──
+const custom = (rule, channel, value, status, source) => ({ id: `customRate.${rule}.${channel}`, value, status, source });
+export const CUSTOM_RATE_PROVENANCE = [
+    custom("tremor", "pointing", ratio("law.rate.pointing.motionImpaired", "law.rate.pointing.motionImpairedControls"), "published", "A custom persona with the tremor flag (accessibilityTraits.tremor, which the creation tool also sets for motor, arthritis, dexterity and mobility words) or tremor or Parkinson in its name or description: the motion-impaired rate against its same-study controls, 1.77 / 4.88 bits/s (Keates et al. 2002, in Soukoreff & MacKenzie 2004, Table 4), as for motor-impairment-tremor."),
+    custom("elderly", "pointing", ratio("profile.pointing.elderly.throughput", "law.rate.pointing.reference"), "hypothesis", `A custom persona whose stated age is 65 or above (an age range, a stated age such as "70-year-old", or a phrase that states age such as elderly, older adult or senior citizen; src/persona-age.ts): the elderly profile, as for the built-in elderly personas. ${ELDERLY_POINTING}`),
+    custom("noMeasuredDifference", "pointing", 1, "hypothesis", `A custom persona with no tremor flag and no elderly cue. ${NO_DIFFERENCE_POINTING}`),
+    custom("dyslexia", "reading", ratio("law.rate.reading.dyslexiaAdults", "law.rate.reading.dyslexiaControls"), "published", "A custom persona with dyslexia in its name or description and no stated reading-profile values: students with dyslexia against same-study controls, 184.63 / 243.64 wpm (Callens, Tops & Brysbaert 2012, PLoS ONE 7(6), e38081, Table 5), as for dyslexic-user."),
+    custom("lowVision", "reading", ratio("law.rate.reading.lowVisionIntactFields", "law.reading.wpm"), "hypothesis", "A custom persona with low vision, magnification, visual impairment, partial sight, vision loss, macular degeneration or glaucoma in its name or description and no stated reading-profile values: low vision with intact central fields, 130 wpm median peak (Legge, Rubin, Pelli & Schleske 1985) against the reference 238 wpm, as for the built-in low-vision personas. The ratio crosses methods; Legge et al.'s normal-vision peak rate on the same apparatus would set it. \"Blind\" is not a low-vision word: a blind reader does not read print."),
+    custom("noMeasuredDifference", "reading", 1, "hypothesis", `A custom persona with no stated reading-profile values and no dyslexia or low-vision cue. ${NO_DIFFERENCE_READING}`),
+];
+const LOW_VISION_WORDS = /low.?vision|magnif|visual(ly)?.?impair|partial(ly)?.?sight|vision.?loss|macular|glaucoma/;
+/** Which customRate.* pointing rule a custom persona falls under. */
+export function customPointingRule(p) {
+    const text = `${p.name ?? ""} ${p.description ?? ""}`.toLowerCase();
+    if (p.tremor === true || /tremor|parkinson/.test(text))
+        return "tremor";
+    if (isOlderAdult(p))
+        return "elderly";
+    return "noMeasuredDifference";
+}
+/** Which reading rule a custom persona with no stated reading-profile values falls under. */
+export function customReadingRule(p) {
+    const text = `${p.name ?? ""} ${p.description ?? ""}`.toLowerCase();
+    if (/dyslexi/.test(text))
+        return "dyslexia";
+    if (LOW_VISION_WORDS.test(text))
+        return "lowVision";
+    if (isOlderAdult(p))
+        return "elderly";
+    return "noMeasuredDifference";
+}
+/**
+ * The registry id a reading rule reads. An elderly cue reads the built-in
+ * elderly-user's own entry (personaRate.elderly-user.reading, the fixation-model
+ * hypothesis), decided 2026-10-23 so a custom elderly persona reads as the
+ * built-in one does; the others their customRate.* entry.
+ */
+export function customReadingRateId(rule) {
+    return rule === "elderly" ? "personaRate.elderly-user.reading" : `customRate.${rule}.reading`;
+}
+/**
+ * A persona's silent reading rate for display, wpm: 238 x its registered
+ * reading share, rounded. For the humanBehavior.timing.readingSpeed a persona
+ * carries, which personas.ts sets at load and so cannot read through param()
+ * (model-provenance.ts imports the persona tables); tests hold it equal to the
+ * param() value.
+ */
+export function displayReadingWpm(rateId) {
+    return Math.round(registered("law.reading.wpm") * [...PERSONA_RATE_PROVENANCE, ...CUSTOM_RATE_PROVENANCE].find((e) => e.id === rateId).value);
+}
+//# sourceMappingURL=persona-rates.js.map

package/dist/visual/provenance/persona-rates.js.map

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

package/dist/visual/provenance/personas.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Provenance catalogue for the built-in personas' trait values
+ * (personas.ts: BUILTIN_PERSONAS, ACCESSIBILITY_PERSONAS, EMOTIONAL_PERSONAS).
+ * See ../model-provenance.ts for the statuses.
+ *
+ * CATALOGUED, NOT READ THROUGH param(). Every other provenance group is read
+ * by id at the point of use. These are not: the chain and the distance take a
+ * persona's traits from the persona object, and rewriting personas.ts to read
+ * each of its numbers by id would bury the profiles it exists to make
+ * readable. So the entries are built FROM the persona objects at module load.
+ * The value here is the value the tools run on and cannot drift from it; what
+ * the registry adds is the status and the source. No code reads a `persona.`
+ * id through param(), so a recording will not contain one, and a check for
+ * registered ids that are never read must leave this prefix out.
+ * tests/persona-provenance.test.ts fails if a numeric trait in personas.ts has
+ * no entry or two, if a value differs from the source text, or if a persona or
+ * trait name appears that this file has no population or measure for.
+ *
+ * Every value is a `hypothesis`. All but the norm-anchored ones (NORM_ANCHORS
+ * below) were set by hand on a scale that no instrument defines (0-1 for all
+ * but visualSpan and contrastSensitivity, which have units). For those,
+ * personas.ts cites research in three ways, and none of them is a
+ * measurement of a value:
+ *   - construct references. trait-reference.ts names a source per trait
+ *     (Bandura for selfEfficacy, the Brief Resilience Scale for resilience),
+ *     and personas.ts tags values with the same names, e.g. "(Bandura)". These
+ *     say what the scale means, not where a persona sits on it.
+ *   - a finding cited beside one value, e.g. dyslexic-user.workingMemory cites
+ *     de Jong 2006 and PMC3496727. That is evidence for the DIRECTION of the
+ *     persona's difference from typical, not for the number. Each such entry
+ *     names its citation and what it was cited for.
+ *   - a persona-level research note, e.g. the tremor prevalence on
+ *     motor-impairment-tremor. It supports the persona's design, not any trait
+ *     value, and is named in each of that persona's entries.
+ * A norm-anchored value is the percentile a published population mean
+ * implies on a normed instrument (paper section 3.1.1); its entry names that
+ * source and its interval, and it stays a hypothesis because mapping the
+ * instrument onto the trait is cbrowser's choice.
+ *
+ * What would test a value: the measure named per trait, given to a sample of
+ * the persona's population, with a 0-1 value compared as that sample's mean
+ * percentile against a general-population norm in the direction of the
+ * scale's high end. The scale has no other anchor, so fixing that mapping is
+ * the first step of any test. Five built-in personas are behavioural
+ * archetypes (impatient-user, distracted-user, careful-reader, explorer,
+ * task-focused) with no population until a screening criterion defines one,
+ * and their entries say so.
+ *
+ * @copyright 2026 Alexandria Eden alexandria.shai.eden@gmail.com https://cbrowser.ai
+ * @license MIT
+ */
+import type { ProvenanceEntry } from "../model-provenance.js";
+/** The persona tables this catalogue covers, by the name personas.ts exports them under. */
+export declare const PERSONA_TABLES: {
+    BUILTIN_PERSONAS: Record<string, import("../../types.js").Persona>;
+    ACCESSIBILITY_PERSONAS: Record<string, import("../../types.js").AccessibilityPersona>;
+    EMOTIONAL_PERSONAS: Record<string, import("../../types.js").Persona>;
+};
+/** The two trait groups whose numeric values are catalogued. */
+export declare const TRAIT_GROUPS: readonly ["cognitiveTraits", "accessibilityTraits"];
+/**
+ * A value set to its norm-implied value (paper section 3.1.1): the
+ * percentile, in the instrument's typical reference, of the persona
+ * population's mean, Phi(z) with z = (population mean - reference mean) /
+ * reference SD. A cell is here only if the source's 95% interval excluded the
+ * old value and all three of these held: the instrument measures the trait as
+ * trait-reference.ts defines it, the sample's age matches the persona's, and
+ * the 95% CI was read in the source. Every cell
+ * considered, and why each other one did not qualify, is listed in
+ * research/persona-norms/applied.md.
+ *
+ * The status stays `hypothesis`. The source measured the population on its
+ * instrument; that the instrument measures this trait is cbrowser's mapping.
+ * personas.ts holds Phi(z) to two decimals, and the test recomputes it from z.
+ */
+export interface NormAnchor {
+    /** The source, as retrieved. */
+    cite: string;
+    /** Where the number is printed in the source, and the number as printed. */
+    reported: string;
+    /** Population minus reference in reference SDs, with the source's 95% CI. */
+    z: number;
+    zLo: number;
+    zHi: number;
+    /** The value before 21.0 and what personas.ts cited it to. */
+    replaced: string;
+    /** What the value does not settle about the source. */
+    note?: string;
+}
+/** Norm-anchored values, keyed `<persona>.<trait>`. */
+export declare const NORM_ANCHORS: Record<string, NormAnchor>;
+/** A persona as the catalogue sees it: only the two trait groups matter. */
+type PersonaLike = {
+    cognitiveTraits?: object;
+    accessibilityTraits?: object;
+};
+export interface PersonaCatalogue {
+    entries: ProvenanceEntry[];
+    /** Ids of numeric traits that could not be described (unknown persona or trait name, or a duplicate). */
+    uncovered: string[];
+}
+/**
+ * Build one entry per numeric trait value in the given persona tables. A value
+ * whose persona or trait name this file has no population or measure for is
+ * reported as uncovered instead of registered, so the test fails rather than
+ * the module.
+ */
+export declare function cataloguePersonaTraits(tables: Record<string, Record<string, PersonaLike>>): PersonaCatalogue;
+export declare const PERSONA_PROVENANCE: ProvenanceEntry[];
+/** Numeric traits in personas.ts this file cannot describe yet. Must be empty; the test says which. */
+export declare const PERSONA_PROVENANCE_UNCOVERED: readonly string[];
+/** The keys of the hand-written tables above, so the test can catch a stale one. */
+export declare const PERSONA_PROVENANCE_KEYS: {
+    populations: string[];
+    notes: string[];
+    valueCitations: string[];
+    citedDirections: Record<string, "low" | "mid" | "high">;
+    normAnchors: string[];
+    measures: string[];
+};
+export {};
+//# sourceMappingURL=personas.d.ts.map

package/dist/visual/provenance/personas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personas.d.ts","sourceRoot":"","sources":["../../../src/visual/provenance/personas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AA2B9D,4FAA4F;AAC5F,eAAO,MAAM,cAAc;;;;CAAmE,CAAC;AAE/F,gEAAgE;AAChE,eAAO,MAAM,YAAY,qDAAsD,CAAC;AAyLhF;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,CAAC,EAAE,MAAM,CAAC;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,uDAAuD;AACvD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAmBnD,CAAC;AAEF,4EAA4E;AAC5E,KAAK,WAAW,GAAG;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,yGAAyG;IACzG,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AA8CD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,GAAG,gBAAgB,CAuB5G;AAID,eAAO,MAAM,kBAAkB,EAAE,eAAe,EAAsB,CAAC;AAEvE,uGAAuG;AACvG,eAAO,MAAM,4BAA4B,EAAE,SAAS,MAAM,EAAwB,CAAC;AAEnF,oFAAoF;AACpF,eAAO,MAAM,uBAAuB;;;;qBAM7B,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;;;CAG5C,CAAC"}