@genocode/core 0.1.1 → 0.3.0

package/dist/genetics.d.ts

@@ -0,0 +1,54 @@
+import type { CheckResult } from "./checker.js";
+import { type GeneInfo } from "./genes.js";
+import { type Value } from "./values.js";
+/** Gene values by full name. A gene that isn't listed has the value written in the program. */
+export type GeneValues = ReadonlyMap<string, Value>;
+/** A creature for breeding and morphing: its genes, and the values they have. */
+export interface GeneSet {
+    genes: readonly GeneInfo[];
+    values?: GeneValues;
+}
+export interface GeneticsOptions {
+    /** A random number from 0 up to 1, such as `Math.random` or `mulberry32(seed)`. */
+    random: () => number;
+    /** Full names of genes to keep as they are. */
+    locked?: ReadonlySet<string>;
+}
+export interface MutateOptions extends GeneticsOptions {
+    /** How far genes move, from 0 to 1. */
+    strength: number;
+    /** The chance that each gene is changed. ½ unless the app lets the user choose. */
+    rate?: number;
+}
+/** Every gene's value: the one given, or the one written in the program. */
+export declare function valuesOf(genes: readonly GeneInfo[], values?: GeneValues): Map<string, Value>;
+/** A mutated copy of the gene values. */
+export declare function mutate(genes: readonly GeneInfo[], values: GeneValues | undefined, options: MutateOptions): Map<string, Value>;
+/** The gene values of a child of A and B. The child has A's program. */
+export declare function breed(a: GeneSet, b: GeneSet, options: GeneticsOptions): Map<string, Value>;
+/**
+ * The creature at `t` (0 to 1) between A and B: which program it has (A's before the halfway
+ * point, B's from it on) and its gene values. Values aren't limited to either range.
+ */
+export declare function morph(a: GeneSet, b: GeneSet, t: number): {
+    from: "a" | "b";
+    values: Map<string, Value>;
+};
+/**
+ * The program's text with each gene's value written in, laid out by the formatter. Genes whose
+ * value hasn't changed keep the text they were written with. The automatic `seed` gene has no
+ * line to write into, so it isn't saved.
+ */
+export declare function writeGenes(program: CheckResult, values: GeneValues): string;
+/**
+ * The edits that write each changed gene's value into the program's text, in order, without
+ * laying anything else out. Editors apply them so the rest of the text and the cursor stay put.
+ */
+export declare function geneEdits(program: CheckResult, values: GeneValues): {
+    start: number;
+    end: number;
+    text: string;
+}[];
+/** A gene value written readably, and still within the gene's range. */
+export declare function geneLiteral(g: GeneInfo, v: Value): string;
+//# sourceMappingURL=genetics.d.ts.map

package/dist/genetics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"genetics.d.ts","sourceRoot":"","sources":["../src/genetics.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAY,KAAK,QAAQ,EAAe,MAAM,YAAY,CAAC;AAClE,OAAO,EAML,KAAK,KAAK,EAEX,MAAM,aAAa,CAAC;AAErB,+FAA+F;AAC/F,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAEpD,iFAAiF;AACjF,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,aAAc,SAAQ,eAAe;IACpD,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAE5F;AAID,yCAAyC;AACzC,wBAAgB,MAAM,CACpB,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,MAAM,EAAE,UAAU,GAAG,SAAS,EAC9B,OAAO,EAAE,aAAa,GACrB,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAUpB;AAqED,wEAAwE;AACxE,wBAAgB,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAY1F;AA4DD;;;GAGG;AACH,wBAAgB,KAAK,CACnB,CAAC,EAAE,OAAO,EACV,CAAC,EAAE,OAAO,EACV,CAAC,EAAE,MAAM,GACR;IAAE,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;CAAE,CAgBjD;AAsBD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAQ3E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,UAAU,GACjB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAShD;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,GAAG,MAAM,CAkBzD"}

package/dist/genetics.js

@@ -0,0 +1,276 @@
+// Mutating, breeding and morphing genes (docs/LANGUAGE.md section 19), and writing a creature's
+// gene values back into its program, which is how a bred creature is saved.
+import { hueDelta, mixHue, wrapHue } from "./colour.js";
+import { formatText } from "./format.js";
+import { inHueArc } from "./genes.js";
+import { formatValue, isColour, isVec, valuesEqual, } from "./values.js";
+/** Every gene's value: the one given, or the one written in the program. */
+export function valuesOf(genes, values) {
+    return new Map(genes.map((g) => [g.fullName, values?.get(g.fullName) ?? g.value]));
+}
+// ---------- mutation (section 19.1) ----------
+/** A mutated copy of the gene values. */
+export function mutate(genes, values, options) {
+    const { random, strength } = options;
+    const rate = options.rate ?? 0.5;
+    const out = valuesOf(genes, values);
+    for (const g of genes) {
+        if (options.locked?.has(g.fullName))
+            continue;
+        if (random() >= rate)
+            continue;
+        out.set(g.fullName, mutateGene(g, out.get(g.fullName), strength, random));
+    }
+    return out;
+}
+function mutateGene(g, v, strength, random) {
+    if (isSeed(g))
+        return random() < strength ? Math.floor(random() * 2 ** 32) : v;
+    switch (g.kind) {
+        case "bool":
+            return random() < strength ? !v : v;
+        case "choice":
+        case "part": {
+            if (random() >= strength)
+                return v;
+            const others = g.options.filter((o) => !valuesEqual(o, v));
+            return others.length > 0 ? others[Math.floor(random() * others.length)] : v;
+        }
+        case "number":
+            return mutateNumber(v, g.min, g.max, g, strength, random);
+        case "vector": {
+            const [a, lo, hi] = [v, g.min, g.max];
+            const axis = (k) => mutateNumber(a[k], lo[k], hi[k], g, strength, random);
+            return { type: "vector", x: axis("x"), y: axis("y"), z: axis("z") };
+        }
+        case "colour": {
+            const [c, lo, hi] = [v, g.min, g.max];
+            const channel = (k) => mutateNumber(c[k], lo[k], hi[k], g, strength, random);
+            return {
+                type: "colour",
+                h: mutateHue(c.h, g.hue, strength, random),
+                s: channel("s"),
+                v: channel("v"),
+                a: channel("a"),
+            };
+        }
+    }
+}
+/** A uniformly random point in `v ± strength × (max − min)`, kept within min..max. */
+function mutateNumber(v, min, max, g, strength, random) {
+    if (min === max)
+        return v;
+    if (g.log) {
+        const r = strength * (Math.log(max) - Math.log(min));
+        const l = Math.log(v);
+        const lo = Math.max(Math.log(min), l - r);
+        const hi = Math.min(Math.log(max), l + r);
+        return clamp(Math.exp(lo + random() * (hi - lo)), min, max);
+    }
+    const r = strength * (max - min);
+    const lo = Math.max(min, v - r);
+    const hi = Math.min(max, v + r);
+    return snap(lo + random() * (hi - lo), min, max, g.step);
+}
+/** Hue: the window `h ± strength × arc` taken round the circle, limited to the arc unless it's whole. */
+function mutateHue(h, arc, strength, random) {
+    const r = strength * arc.length;
+    if (arc.whole)
+        return wrapHue(h + (random() * 2 - 1) * r);
+    const at = wrapHue(h - arc.start);
+    const lo = Math.max(0, at - r);
+    const hi = Math.min(arc.length, at + r);
+    return wrapHue(arc.start + lo + random() * (hi - lo));
+}
+// ---------- breeding (section 19.2) ----------
+/** The gene values of a child of A and B. The child has A's program. */
+export function breed(a, b, options) {
+    const { random } = options;
+    const av = valuesOf(a.genes, a.values);
+    const bv = valuesOf(b.genes, b.values);
+    const bGenes = new Map(b.genes.map((g) => [g.fullName, g]));
+    const out = new Map(av);
+    for (const g of a.genes) {
+        const match = bGenes.get(g.fullName);
+        if (options.locked?.has(g.fullName) || match === undefined || match.kind !== g.kind)
+            continue;
+        out.set(g.fullName, breedGene(g, av.get(g.fullName), bv.get(g.fullName), random));
+    }
+    return out;
+}
+function breedGene(g, x, y, random) {
+    if (isSeed(g) || g.kind === "bool")
+        return random() < 0.5 ? x : y;
+    if (g.kind === "choice" || g.kind === "part") {
+        const pick = random() < 0.5 ? x : y;
+        // B's choice only counts if it's one of A's options.
+        return g.options.some((o) => valuesEqual(o, pick)) ? pick : x;
+    }
+    if (g.kind === "number") {
+        return breedNumber(x, y, g.min, g.max, g, random);
+    }
+    if (g.kind === "vector" && isVec(x) && isVec(y)) {
+        const [lo, hi] = [g.min, g.max];
+        const axis = (k) => breedNumber(x[k], y[k], lo[k], hi[k], g, random);
+        return { type: "vector", x: axis("x"), y: axis("y"), z: axis("z") };
+    }
+    if (g.kind === "colour" && isColour(x) && isColour(y)) {
+        const [lo, hi] = [g.min, g.max];
+        const channel = (k) => breedNumber(x[k], y[k], lo[k], hi[k], g, random);
+        return {
+            type: "colour",
+            h: breedHue(x.h, y.h, g.hue, random),
+            s: channel("s"),
+            v: channel("v"),
+            a: channel("a"),
+        };
+    }
+    return x;
+}
+/** Half the time a random point between the two, otherwise one or the other; kept within A's range. */
+function breedNumber(x, y, min, max, g, random) {
+    let v;
+    if (random() < 0.5) {
+        const t = random();
+        v =
+            g.log && x > 0 && y > 0
+                ? Math.exp(Math.log(x) + t * (Math.log(y) - Math.log(x)))
+                : x + t * (y - x);
+    }
+    else {
+        v = random() < 0.5 ? x : y;
+    }
+    return snap(v, min, max, g.step);
+}
+function breedHue(x, y, arc, random) {
+    const h = random() < 0.5 ? mixHue(x, y, random()) : random() < 0.5 ? x : y;
+    return clampHue(h, arc);
+}
+// ---------- morphing (section 19.3) ----------
+/**
+ * The creature at `t` (0 to 1) between A and B: which program it has (A's before the halfway
+ * point, B's from it on) and its gene values. Values aren't limited to either range.
+ */
+export function morph(a, b, t) {
+    const from = t < 0.5 ? "a" : "b";
+    const own = from === "a" ? a : b;
+    const other = from === "a" ? b : a;
+    const av = valuesOf(a.genes, a.values);
+    const bv = valuesOf(b.genes, b.values);
+    const otherGenes = new Map(other.genes.map((g) => [g.fullName, g]));
+    const out = valuesOf(own.genes, own.values);
+    for (const g of own.genes) {
+        const match = otherGenes.get(g.fullName);
+        if (match === undefined || match.kind !== g.kind)
+            continue;
+        const x = av.get(g.fullName);
+        const y = bv.get(g.fullName);
+        out.set(g.fullName, morphGene(g, x, y, t));
+    }
+    return { from, values: out };
+}
+function morphGene(g, x, y, t) {
+    const num = (p, q) => g.log && p > 0 && q > 0 ? p * (q / p) ** t : p + (q - p) * t;
+    if (typeof x === "number" && typeof y === "number" && !isSeed(g))
+        return num(x, y);
+    if (isVec(x) && isVec(y))
+        return { type: "vector", x: num(x.x, y.x), y: num(x.y, y.y), z: num(x.z, y.z) };
+    if (isColour(x) && isColour(y)) {
+        return {
+            type: "colour",
+            h: mixHue(x.h, y.h, t),
+            s: x.s + (y.s - x.s) * t,
+            v: x.v + (y.v - x.v) * t,
+            a: x.a + (y.a - x.a) * t,
+        };
+    }
+    return t < 0.5 ? x : y;
+}
+// ---------- writing genes into the program ----------
+/**
+ * The program's text with each gene's value written in, laid out by the formatter. Genes whose
+ * value hasn't changed keep the text they were written with. The automatic `seed` gene has no
+ * line to write into, so it isn't saved.
+ */
+export function writeGenes(program, values) {
+    const edits = geneEdits(program, values);
+    if (edits.length === 0)
+        return program.text;
+    let text = program.text;
+    for (const e of [...edits].reverse()) {
+        text = text.slice(0, e.start) + e.text + text.slice(e.end);
+    }
+    return formatText(text).text ?? text;
+}
+/**
+ * The edits that write each changed gene's value into the program's text, in order, without
+ * laying anything else out. Editors apply them so the rest of the text and the cursor stay put.
+ */
+export function geneEdits(program, values) {
+    const edits = [];
+    for (const g of program.genes) {
+        const v = values.get(g.fullName);
+        if (g.decl === undefined || v === undefined || valuesEqual(v, g.value))
+            continue;
+        const span = g.decl.value.span;
+        edits.push({ start: span.start, end: span.end, text: geneLiteral(g, v) });
+    }
+    return edits.sort((p, q) => p.start - q.start);
+}
+/** A gene value written readably, and still within the gene's range. */
+export function geneLiteral(g, v) {
+    if (g.kind === "number" && typeof v === "number") {
+        return numberLiteral(v, g.min, g.max, g.step);
+    }
+    if (g.kind === "vector" && isVec(v)) {
+        const [lo, hi] = [g.min, g.max];
+        const axis = (k) => numberLiteral(v[k], lo[k], hi[k], undefined);
+        return `(${axis("x")}, ${axis("y")}, ${axis("z")})`;
+    }
+    if (g.kind === "colour" && isColour(v)) {
+        const [lo, hi] = [g.min, g.max];
+        let h = Number(clampHue(v.h, g.hue).toFixed(1));
+        if (!inHueArc(h, g.hue))
+            h = clampHue(v.h, g.hue);
+        const ch = (k) => short(clamp(Number(v[k].toFixed(2)), lo[k], hi[k]));
+        const alpha = ch("a");
+        return `hsv(${short(h)}, ${ch("s")}, ${ch("v")}${alpha === "1" ? "" : `, ${alpha}`})`;
+    }
+    return formatValue(v);
+}
+function numberLiteral(v, min, max, step) {
+    if (step !== undefined)
+        return short(snap(v, min, max, step));
+    return short(clamp(Number(v.toPrecision(4)), min, max));
+}
+/** A number without floating-point noise, such as `0.3` rather than `0.30000000000000004`. */
+function short(n) {
+    const s = String(Number(n.toPrecision(12)));
+    return s === "-0" ? "0" : s;
+}
+// ---------- helpers ----------
+function isSeed(g) {
+    return g.fullName === "seed" && g.decl === undefined;
+}
+function clamp(x, lo, hi) {
+    return x < lo ? lo : x > hi ? hi : x;
+}
+/** Clamps into min..max, and onto the nearest whole step within it if the gene has one. */
+function snap(v, min, max, step) {
+    v = clamp(v, min, max);
+    if (step === undefined)
+        return v;
+    let k = Math.round((v - min) / step);
+    if (min + k * step > max + 1e-9)
+        k--;
+    return min + k * step;
+}
+/** The hue itself if it's on the arc, otherwise the nearer end of the arc. */
+function clampHue(h, arc) {
+    h = wrapHue(h);
+    if (inHueArc(h, arc))
+        return h;
+    const end = wrapHue(arc.start + arc.length);
+    return Math.abs(hueDelta(h, arc.start)) <= Math.abs(hueDelta(h, end)) ? arc.start : end;
+}
+//# sourceMappingURL=genetics.js.map

package/dist/genetics.js.map

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

package/dist/help.d.ts

@@ -0,0 +1,36 @@
+import type { CheckResult } from "./checker.js";
+import type { GeneInfo } from "./genes.js";
+import type { Span } from "./source.js";
+export interface Help {
+    /** How it's written, such as `clamp(x, lo, hi)`. */
+    title: string;
+    /** What it does, in a sentence or two. */
+    text: string;
+    /** The section of docs/LANGUAGE.md that explains it, such as `18.1`. */
+    section: string;
+}
+export type CompletionKind = "keyword" | "function" | "constant" | "input" | "gene" | "part" | "variable" | "member";
+export interface Completion {
+    label: string;
+    kind: CompletionKind;
+    /** A short note shown beside the label. */
+    detail: string;
+}
+/** The built-in functions. */
+export declare const FUNCTION_HELP: ReadonlyMap<string, Help>;
+/** The built-in constants: numbers, vectors, colours, shapes and pattern kinds. */
+export declare function constantHelp(name: string): Help | undefined;
+/** Keywords, and the inputs `time`, `beat`, `music` and `turtle`. */
+export declare const KEYWORD_HELP: ReadonlyMap<string, Help>;
+/** The parts of `music` and `turtle`. */
+export declare const MEMBER_HELP: ReadonlyMap<string, ReadonlyMap<string, Help>>;
+/** A gene's range in words, such as `3 to 16, steps of 1`. */
+export declare function geneRange(g: GeneInfo): string;
+/** Help for the word at `offset`, and where that word is. */
+export declare function helpAt(program: CheckResult, offset: number): {
+    span: Span;
+    help: Help;
+} | undefined;
+/** What can be typed at `offset`: everything in scope, built-ins and keywords. */
+export declare function completionsAt(program: CheckResult, offset: number): Completion[];
+//# sourceMappingURL=help.d.ts.map

package/dist/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGxC,MAAM,WAAW,IAAI;IACnB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GACxB,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE1F,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,cAAc,CAAC;IACrB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;CAChB;AAID,8BAA8B;AAC9B,eAAO,MAAM,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAkHlD,CAAC;AAwBH,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAa3D;AAED,qEAAqE;AACrE,eAAO,MAAM,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CA2HjD,CAAC;AAEH,yCAAyC;AACzC,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CA+BrE,CAAC;AAEH,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAU7C;AA6HD,6DAA6D;AAC7D,wBAAgB,MAAM,CACpB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,GACb;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG,SAAS,CAmBxC;AAID,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CAoChF"}

package/dist/help.js

@@ -0,0 +1,431 @@
+// Help for editors: what a name means when you point at it, and which names can be typed where.
+// The text follows docs/LANGUAGE.md, and help.test.ts keeps every built-in covered.
+import { BUILTIN_CONSTANTS } from "./builtins.js";
+import { NAMED_COLOURS } from "./colour.js";
+import { KEYWORDS, lex } from "./lexer.js";
+import { formatValue, PATTERN_KINDS, SHAPES } from "./values.js";
+const h = (title, text, section) => ({ title, text, section });
+/** The built-in functions. */
+export const FUNCTION_HELP = new Map([
+    ["abs", h("abs(x)", "The absolute value of `x`.", "18.1")],
+    ["sign", h("sign(x)", "−1, 0 or 1, depending on the sign of `x`.", "18.1")],
+    ["floor", h("floor(x)", "`x` rounded down.", "18.1")],
+    ["ceil", h("ceil(x)", "`x` rounded up.", "18.1")],
+    ["round", h("round(x)", "The nearest whole number, halves rounded up.", "18.1")],
+    [
+        "frac",
+        h("frac(x)", "`x` minus its whole part, keeping the sign: `frac(-1.25)` is `-0.25`.", "18.1"),
+    ],
+    ["min", h("min(a, b)", "The smaller of `a` and `b`.", "18.1")],
+    ["max", h("max(a, b)", "The larger of `a` and `b`.", "18.1")],
+    ["clamp", h("clamp(x, lo, hi)", "`x` limited to lo..hi.", "18.1")],
+    ["wrap", h("wrap(x, lo, hi)", "`x` wrapped round into lo..hi, so that hi wraps to lo.", "18.1")],
+    ["bounce", h("bounce(x, lo, hi)", "`x` folded back and forth between lo and hi.", "18.1")],
+    ["sqrt", h("sqrt(x)", "The square root of `x`.", "18.1")],
+    ["exp", h("exp(x)", "e to the power `x`.", "18.1")],
+    ["ln", h("ln(x)", "The natural logarithm of `x`.", "18.1")],
+    ["log10", h("log10(x)", "The base-10 logarithm of `x`.", "18.1")],
+    ["sin", h("sin(a)", "The sine of `a`, in degrees.", "18.1")],
+    ["cos", h("cos(a)", "The cosine of `a`, in degrees.", "18.1")],
+    ["tan", h("tan(a)", "The tangent of `a`, in degrees.", "18.1")],
+    ["asin", h("asin(x)", "The angle whose sine is `x`, in degrees.", "18.1")],
+    ["acos", h("acos(x)", "The angle whose cosine is `x`, in degrees.", "18.1")],
+    ["atan", h("atan(x)", "The angle whose tangent is `x`, in degrees.", "18.1")],
+    ["atan2", h("atan2(y, x)", "The angle of the point (x, y) from the x axis, in degrees.", "18.1")],
+    ["degrees", h("degrees(r)", "Converts radians to degrees.", "18.1")],
+    ["radians", h("radians(d)", "Converts degrees to radians.", "18.1")],
+    [
+        "wave",
+        h("wave(t)", "`sin(t × 360)`: one full wave (0, 1, 0, −1, 0) as `t` goes from 0 to 1.", "18.1"),
+    ],
+    [
+        "bump",
+        h("bump(t)", "`sin(t × 180)`: rises from 0 to 1 and back to 0 as `t` goes from 0 to 1.", "18.1"),
+    ],
+    [
+        "mix",
+        h("mix(a, b, t)", "`(1 − t)·a + t·b`, for numbers, vectors and colours. Colours blend hue the short way round.", "18.1"),
+    ],
+    [
+        "smoothmix",
+        h("smoothmix(a, b, t)", "Like `mix`, but eases in and out. `t` is clamped to 0–1.", "18.1"),
+    ],
+    [
+        "mandel",
+        h("mandel(x, y)", "How quickly the point x + iy escapes the Mandelbrot set, from 0 to 1. 1 means never.", "18.1"),
+    ],
+    ["vec", h("vec(x, y, z)", "The vector `(x, y, z)`.", "18.2")],
+    ["length", h("length(v)", "The length of the vector `v`.", "18.2")],
+    ["normalize", h("normalize(v)", "`v` scaled to length 1. The zero vector stays zero.", "18.2")],
+    ["dot", h("dot(a, b)", "The dot product of two vectors.", "18.2")],
+    ["cross", h("cross(a, b)", "The cross product of two vectors.", "18.2")],
+    [
+        "hsv",
+        h("hsv(h, s, v)", "A colour from hue (degrees), saturation and value, 0–1. A fourth argument is alpha.", "13.1"),
+    ],
+    [
+        "rgb",
+        h("rgb(r, g, b)", "A colour from red, green and blue, 0–1. A fourth argument is alpha.", "13.1"),
+    ],
+    [
+        "noise",
+        h("noise(x)", "Smooth noise from −1 to 1 that changes gently with `x` (a number or vector).", "18.5"),
+    ],
+    ["fbm", h("fbm(x)", "Fractal noise: five layers of `noise`, from −1 to 1.", "18.5")],
+    [
+        "random",
+        h("random(lo, hi)", "A random number from `lo` up to `hi`. The creature's `seed` gene decides the sequence.", "18.5"),
+    ],
+    [
+        "pattern",
+        h("pattern(kind, hue, seed)", "A texture: a pattern kind such as `marble`, a hue that sets the palette, and a seed.", "14"),
+    ],
+    [
+        "gradient",
+        h("gradient(c1, c2 at p, …)", "Colours blended along 0 to 1. Sample it like a call: `skin(0.5)`.", "13.3"),
+    ],
+]);
+const NUMBER_CONSTANTS = new Map([
+    ["pi", "π, 3.14159…"],
+    ["tau", "2π, 6.28318…"],
+    ["golden", "The golden ratio, 1.61803…"],
+    ["sqrt2", "The square root of 2."],
+    ["sqrt3", "The square root of 3."],
+    ["ln2", "The natural logarithm of 2."],
+    ["x_axis", "The vector `(1, 0, 0)`."],
+    ["y_axis", "The vector `(0, 1, 0)`."],
+    ["z_axis", "The vector `(0, 0, 1)`."],
+    ["none", "No texture: `texture none`."],
+]);
+const SHAPE_TEXT = {
+    tube: "A cylinder 1 across and 1 long, along the heading.",
+    cube: "A cube with sides of 1.",
+    cone: "A cone 1 long along the heading, its tip at the front.",
+    ball: "A sphere 1 across.",
+    ring: "A thin torus around the heading, 1 across.",
+    donut: "A fat torus around the heading, 1 across.",
+};
+/** The built-in constants: numbers, vectors, colours, shapes and pattern kinds. */
+export function constantHelp(name) {
+    const text = NUMBER_CONSTANTS.get(name);
+    if (text !== undefined)
+        return h(name, text, name === "none" ? "14" : "18.1");
+    const colour = NAMED_COLOURS.get(name);
+    if (colour) {
+        const alpha = colour.a === 1 ? "" : `, ${colour.a}`;
+        return h(name, `The colour hsv(${colour.h}, ${colour.s}, ${colour.v}${alpha}).`, "13.1");
+    }
+    if (SHAPES.includes(name))
+        return h(name, `A shape. ${SHAPE_TEXT[name]}`, "12");
+    if (PATTERN_KINDS.includes(name))
+        return h(name, "A pattern kind, for `pattern(kind, hue, seed)`.", "14");
+    return undefined;
+}
+/** Keywords, and the inputs `time`, `beat`, `music` and `turtle`. */
+export const KEYWORD_HELP = new Map([
+    ["creature", h("creature Name", "Starts a creature file.", "3")],
+    [
+        "gene",
+        h("gene name = value in min..max", "A value the app may change when mutating, breeding and morphing.", "6.1"),
+    ],
+    [
+        "part",
+        h("part name(a, b) { … }", "A piece of creature: it may move the turtle and lay shapes.", "10"),
+    ],
+    [
+        "function",
+        h("function name(a, b) { … }", "Calculates a value with `return`. It can't change the turtle or lay shapes.", "10"),
+    ],
+    ["return", h("return value", "Leaves a function with a value, or a part early.", "10")],
+    ["let", h("let name = value", "Creates a variable in the current block.", "7")],
+    ["if", h("if condition { … } else { … }", "Runs a block when the condition is true.", "9")],
+    ["else", h("else { … }", "What `if` runs when its condition is false.", "9")],
+    ["repeat", h("repeat n as i { … }", "Runs a block `n` times, with `i` counting from 0.", "9")],
+    ["as", h("repeat n as i", "Names the counter of a `repeat` loop.", "9")],
+    [
+        "for",
+        h("for v from a to b by s { … }", "Runs a block for `v` from `a` to `b`, in steps of `s` (1 if left out).", "9"),
+    ],
+    [
+        "from",
+        h("from", "In `for`: where the loop starts. In a gene: the options it chooses from.", "9"),
+    ],
+    ["to", h("to", "In `for`: where the loop ends.", "9")],
+    ["by", h("by", "In `for`: the step.", "9")],
+    ["while", h("while condition { … }", "Runs a block for as long as the condition is true.", "9")],
+    ["branch", h("branch { … }", "Runs a block, then puts the turtle back as it was.", "11.5")],
+    [
+        "lay",
+        h("lay  /  lay { … }", "Lays the current shape, optionally with an extra shape transform.", "12"),
+    ],
+    [
+        "reshape",
+        h("reshape { … }", "Changes the shape transform for every shape laid afterwards.", "11.7"),
+    ],
+    [
+        "symmetric",
+        h("symmetric x { … }", "Runs a block twice, the second time mirrored. `side` is 1, then −1.", "11.6"),
+    ],
+    [
+        "shape",
+        h("shape s", "The shape for later `lay`s: tube, cube, cone, ball, ring or donut.", "12"),
+    ],
+    ["colour", h("colour c", "The colour for later shapes.", "13.2")],
+    ["color", h("color c", "The colour for later shapes.", "13.2")],
+    ["shine", h("shine x", "Strength of highlights, 0–1.", "13.2")],
+    ["sharpness", h("sharpness x", "How tight the highlights are, 0–1.", "13.2")],
+    ["texture", h("texture p", "The texture for later shapes: a `pattern(…)`, or `none`.", "13.2")],
+    [
+        "background",
+        h("background { … fill p }", "The background the creature is shown against.", "15"),
+    ],
+    ["fill", h("fill p", "What the background shows: a pattern, a colour or a gradient.", "15")],
+    ["dance", h("dance { … }", "The creature's dance style: how music moves it as a whole.", "17")],
+    ["forward", h("forward d", "Moves the turtle `d` along its heading.", "11.2")],
+    ["back", h("back d", "Moves the turtle `d` backwards.", "11.2")],
+    ["move", h("move (x, y, z)", "Moves the turtle along its side, up and heading axes.", "11.2")],
+    ["pitch", h("pitch a", "Turns about the side axis: positive tips the nose down.", "11.3")],
+    ["yaw", h("yaw a", "Turns about the up axis, towards the side axis.", "11.3")],
+    ["roll", h("roll a", "Turns about the heading.", "11.3")],
+    [
+        "rotate",
+        h("rotate a around v", "Turns `a` degrees about the axis `v`, in the turtle's own axes.", "11.3"),
+    ],
+    ["around", h("rotate a around v", "The axis that `rotate` turns about.", "11.3")],
+    [
+        "grow",
+        h("grow k  /  grow (x, y, z)", "Multiplies the turtle's size. Negative values mirror.", "11.4"),
+    ],
+    ["mirror", h("mirror x", "Reverses one of the turtle's axes: x, y or z.", "11.4")],
+    ["in", h("gene name = v in min..max", "A gene's range.", "6.1")],
+    ["step", h("in min..max step s", "A gene that moves in whole steps of `s`.", "6.1")],
+    ["log", h("in min..max log", "A gene that changes by ratios rather than amounts.", "6.1")],
+    ["at", h("colour at p", "Where a gradient stop sits, from 0 to 1.", "13.3")],
+    ["and", h("a and b", "True if both sides are.", "8.1")],
+    ["or", h("a or b", "True if either side is.", "8.1")],
+    ["not", h("not a", "The opposite of a bool.", "8.1")],
+    ["true", h("true", "A bool.", "5")],
+    ["false", h("false", "A bool.", "5")],
+    ["print", h("print(a, b, …)", "Writes its arguments to the app's console.", "18.6")],
+    [
+        "turtle",
+        h("turtle.position", "Reads the turtle: position, heading, up, side, size, mirrored, shape, colour…", "18.4"),
+    ],
+    ["time", h("time", "Seconds since the creature started being shown.", "16")],
+    ["beat", h("beat", "Position within the current beat: 0 on the beat, rising towards 1.", "16")],
+    [
+        "music",
+        h("music.bass", "The music: `bass`, `mid`, `high`, `level` and `hit`, each 0–1.", "16"),
+    ],
+]);
+/** The parts of `music` and `turtle`. */
+export const MEMBER_HELP = new Map([
+    [
+        "music",
+        new Map([
+            ["bass", h("music.bass", "Level of the low frequencies, 0–1.", "16")],
+            ["mid", h("music.mid", "Level of the middle frequencies, 0–1.", "16")],
+            ["high", h("music.high", "Level of the high frequencies, 0–1.", "16")],
+            ["level", h("music.level", "Overall loudness, 0–1.", "16")],
+            ["hit", h("music.hit", "Jumps up on each drum hit or note, then falls back, 0–1.", "16")],
+        ]),
+    ],
+    [
+        "turtle",
+        new Map([
+            [
+                "position",
+                h("turtle.position", "The turtle's position in world space (a vector).", "18.4"),
+            ],
+            ["heading", h("turtle.heading", "The heading, as a unit vector in world space.", "18.4")],
+            ["up", h("turtle.up", "The up axis, as a unit vector.", "18.4")],
+            ["side", h("turtle.side", "The side axis, as a unit vector.", "18.4")],
+            ["size", h("turtle.size", "The size per axis (a vector).", "18.4")],
+            ["mirrored", h("turtle.mirrored", "Whether the turtle is mirrored (a bool).", "18.4")],
+            ["shape", h("turtle.shape", "The current shape.", "18.4")],
+            ["colour", h("turtle.colour", "The current colour.", "18.4")],
+            ["color", h("turtle.color", "The current colour.", "18.4")],
+            ["shine", h("turtle.shine", "The current shine.", "18.4")],
+            ["sharpness", h("turtle.sharpness", "The current sharpness.", "18.4")],
+            ["texture", h("turtle.texture", "The current texture.", "18.4")],
+        ]),
+    ],
+]);
+/** A gene's range in words, such as `3 to 16, steps of 1`. */
+export function geneRange(g) {
+    if (g.options)
+        return `one of ${g.options.map(formatValue).join(", ")}`;
+    if (g.kind === "bool")
+        return "true or false";
+    if (g.kind === "colour")
+        return g.hue?.whole ? "any hue" : `hues ${g.hue.start}° + ${g.hue.length}°`;
+    if (g.min === undefined || g.max === undefined)
+        return "";
+    let text = `${formatValue(g.min)} to ${formatValue(g.max)}`;
+    if (g.step !== undefined)
+        text += `, steps of ${g.step}`;
+    if (g.log)
+        text += ", by ratios";
+    return text;
+}
+const signature = (name, params) => params.length === 0 ? name : `${name}(${params.map((p) => p.name).join(", ")})`;
+const contains = (s, offset) => s.start <= offset && offset <= s.end;
+/** The names that can be used at `offset`, innermost last so they win over outer ones. */
+function symbolsAt(program, offset) {
+    const out = [];
+    const geneOf = (stmt) => program.genes.find((g) => g.decl === stmt);
+    const geneSymbol = (g) => ({
+        name: g.name,
+        kind: "gene",
+        help: h(`gene ${g.fullName}`, [g.description, geneRange(g)].filter(Boolean).join(" · ") || "A gene.", "6"),
+    });
+    const variable = (name, text, section) => ({
+        name,
+        kind: "variable",
+        help: h(name, text, section),
+    });
+    // Declarations that can be used from anywhere in the creature.
+    const items = program.file.items;
+    const selfContained = items.find((s) => (s.kind === "Background" || s.kind === "Dance") && contains(s.span, offset));
+    if (!selfContained) {
+        for (const s of items) {
+            if (s.kind === "Part" || s.kind === "Function") {
+                out.push({
+                    name: s.name,
+                    kind: s.kind === "Part" ? "part" : "function",
+                    help: h(`${s.kind === "Part" ? "part" : "function"} ${signature(s.name, s.params)}`, s.kind === "Part"
+                        ? "A part defined in this creature."
+                        : "A function defined in this creature.", "10"),
+                });
+            }
+        }
+    }
+    const visit = (stmts, inBody) => {
+        for (const s of stmts) {
+            if (s.kind === "Gene") {
+                const g = geneOf(s);
+                if (g)
+                    out.push(geneSymbol(g));
+            }
+            else if (s.kind === "Let" && s.span.start < offset) {
+                out.push(variable(s.name, inBody ? "A variable." : "A global variable.", "7"));
+            }
+        }
+        for (const s of stmts) {
+            if (!contains(s.span, offset))
+                continue;
+            const into = (b) => {
+                if (b && contains(b.span, offset))
+                    visit(b.items, inBody);
+            };
+            switch (s.kind) {
+                case "Part":
+                case "Function":
+                    if (!contains(s.body.span, offset))
+                        break;
+                    for (const p of s.params)
+                        out.push(variable(p.name, `A parameter of \`${s.name}\`.`, "10"));
+                    visit(s.body.items, true);
+                    break;
+                case "Background":
+                case "Dance":
+                    into(s.body);
+                    break;
+                case "If":
+                    for (const b of s.branches)
+                        into(b.block);
+                    into(s.elseBlock);
+                    break;
+                case "Repeat":
+                    if (s.as && contains(s.block.span, offset))
+                        out.push(variable(s.as.name, "The loop's counter, from 0.", "9"));
+                    into(s.block);
+                    break;
+                case "For":
+                    if (contains(s.block.span, offset))
+                        out.push(variable(s.variable.name, "The loop's variable.", "9"));
+                    into(s.block);
+                    break;
+                case "Symmetric":
+                    if (contains(s.block.span, offset))
+                        out.push(variable("side", "1 on the first run, −1 on the mirrored one.", "11.6"));
+                    into(s.block);
+                    break;
+                case "While":
+                case "Branch":
+                case "Reshape":
+                case "Lay":
+                    into(s.block);
+                    break;
+            }
+        }
+    };
+    visit(selfContained ? [selfContained] : items, false);
+    return out;
+}
+// ---------- hover ----------
+/** The token at `offset`, counting a position just after a word as on it. */
+function tokenAt(tokens, offset) {
+    return tokens.findIndex((t) => t.kind !== "newline" && t.kind !== "eof" && t.span.start <= offset && offset <= t.span.end);
+}
+/** Help for the word at `offset`, and where that word is. */
+export function helpAt(program, offset) {
+    const { tokens } = lex(program.text);
+    const i = tokenAt(tokens, offset);
+    const t = tokens[i];
+    if (!t || (t.kind !== "name" && t.kind !== "keyword"))
+        return undefined;
+    const found = (help) => (help ? { span: t.span, help } : undefined);
+    // `music.bass`, `turtle.heading`: the word after the dot.
+    const dot = tokens[i - 1];
+    const owner = tokens[i - 2];
+    if (dot?.text === "." && owner && MEMBER_HELP.has(owner.text)) {
+        return found(MEMBER_HELP.get(owner.text).get(t.text));
+    }
+    if (t.kind === "name") {
+        const symbols = symbolsAt(program, offset).filter((s) => s.name === t.text);
+        if (symbols.length > 0)
+            return found(symbols[symbols.length - 1].help);
+        return found(FUNCTION_HELP.get(t.text) ?? constantHelp(t.text));
+    }
+    return found(KEYWORD_HELP.get(t.text));
+}
+// ---------- completion ----------
+/** What can be typed at `offset`: everything in scope, built-ins and keywords. */
+export function completionsAt(program, offset) {
+    // After `music.` or `turtle.`, only their parts.
+    const before = lex(program.text).tokens.filter((t) => t.kind !== "newline" && t.kind !== "eof" && t.span.end <= offset);
+    let k = before.length - 1;
+    const last = before[k];
+    if (last && (last.kind === "name" || last.kind === "keyword") && last.span.end === offset)
+        k--;
+    const dot = before[k];
+    const owner = before[k - 1];
+    if (dot?.text === "." && owner && MEMBER_HELP.has(owner.text)) {
+        return [...MEMBER_HELP.get(owner.text).entries()].map(([label, help]) => ({
+            label,
+            kind: "member",
+            detail: help.text,
+        }));
+    }
+    const out = new Map();
+    const add = (c) => out.set(c.label, c);
+    for (const k of KEYWORDS) {
+        if (k === "time" || k === "beat" || k === "music" || k === "turtle") {
+            add({ label: k, kind: "input", detail: KEYWORD_HELP.get(k).text });
+        }
+        else {
+            add({ label: k, kind: "keyword", detail: KEYWORD_HELP.get(k)?.title ?? "" });
+        }
+    }
+    for (const [name, help] of FUNCTION_HELP)
+        add({ label: name, kind: "function", detail: help.title });
+    for (const name of BUILTIN_CONSTANTS.keys()) {
+        add({ label: name, kind: "constant", detail: constantHelp(name)?.text ?? "" });
+    }
+    for (const s of symbolsAt(program, offset)) {
+        add({ label: s.name, kind: s.kind, detail: s.kind === "gene" ? s.help.text : s.help.title });
+    }
+    return [...out.values()];
+}
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,oFAAoF;AAGpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAc,MAAM,YAAY,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAqBjE,MAAM,CAAC,GAAG,CAAC,KAAa,EAAE,IAAY,EAAE,OAAe,EAAQ,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;AAE7F,8BAA8B;AAC9B,MAAM,CAAC,MAAM,aAAa,GAA8B,IAAI,GAAG,CAAC;IAC9D,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,4BAA4B,EAAE,MAAM,CAAC,CAAC;IAC1D,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,EAAE,2CAA2C,EAAE,MAAM,CAAC,CAAC;IAC3E,CAAC,OAAO,EAAE,CAAC,CAAC,UAAU,EAAE,mBAAmB,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,EAAE,iBAAiB,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC,OAAO,EAAE,CAAC,CAAC,UAAU,EAAE,8CAA8C,EAAE,MAAM,CAAC,CAAC;IAChF;QACE,MAAM;QACN,CAAC,CAAC,SAAS,EAAE,uEAAuE,EAAE,MAAM,CAAC;KAC9F;IACD,CAAC,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,6BAA6B,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,4BAA4B,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC,OAAO,EAAE,CAAC,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC,MAAM,EAAE,CAAC,CAAC,iBAAiB,EAAE,wDAAwD,EAAE,MAAM,CAAC,CAAC;IAChG,CAAC,QAAQ,EAAE,CAAC,CAAC,mBAAmB,EAAE,8CAA8C,EAAE,MAAM,CAAC,CAAC;IAC1F,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,EAAE,yBAAyB,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,+BAA+B,EAAE,MAAM,CAAC,CAAC;IAC3D,CAAC,OAAO,EAAE,CAAC,CAAC,UAAU,EAAE,+BAA+B,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,8BAA8B,EAAE,MAAM,CAAC,CAAC;IAC5D,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,gCAAgC,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,iCAAiC,EAAE,MAAM,CAAC,CAAC;IAC/D,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,EAAE,0CAA0C,EAAE,MAAM,CAAC,CAAC;IAC1E,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,EAAE,4CAA4C,EAAE,MAAM,CAAC,CAAC;IAC5E,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,EAAE,6CAA6C,EAAE,MAAM,CAAC,CAAC;IAC7E,CAAC,OAAO,EAAE,CAAC,CAAC,aAAa,EAAE,4DAA4D,EAAE,MAAM,CAAC,CAAC;IACjG,CAAC,SAAS,EAAE,CAAC,CAAC,YAAY,EAAE,8BAA8B,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC,SAAS,EAAE,CAAC,CAAC,YAAY,EAAE,8BAA8B,EAAE,MAAM,CAAC,CAAC;IACpE;QACE,MAAM;QACN,CAAC,CAAC,SAAS,EAAE,yEAAyE,EAAE,MAAM,CAAC;KAChG;IACD;QACE,MAAM;QACN,CAAC,CACC,SAAS,EACT,0EAA0E,EAC1E,MAAM,CACP;KACF;IACD;QACE,KAAK;QACL,CAAC,CACC,cAAc,EACd,6FAA6F,EAC7F,MAAM,CACP;KACF;IACD;QACE,WAAW;QACX,CAAC,CAAC,oBAAoB,EAAE,0DAA0D,EAAE,MAAM,CAAC;KAC5F;IACD;QACE,QAAQ;QACR,CAAC,CACC,cAAc,EACd,sFAAsF,EACtF,MAAM,CACP;KACF;IACD,CAAC,KAAK,EAAE,CAAC,CAAC,cAAc,EAAE,yBAAyB,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC,QAAQ,EAAE,CAAC,CAAC,WAAW,EAAE,+BAA+B,EAAE,MAAM,CAAC,CAAC;IACnE,CAAC,WAAW,EAAE,CAAC,CAAC,cAAc,EAAE,qDAAqD,EAAE,MAAM,CAAC,CAAC;IAC/F,CAAC,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,iCAAiC,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC,OAAO,EAAE,CAAC,CAAC,aAAa,EAAE,mCAAmC,EAAE,MAAM,CAAC,CAAC;IACxE;QACE,KAAK;QACL,CAAC,CACC,cAAc,EACd,qFAAqF,EACrF,MAAM,CACP;KACF;IACD;QACE,KAAK;QACL,CAAC,CACC,cAAc,EACd,qEAAqE,EACrE,MAAM,CACP;KACF;IACD;QACE,OAAO;QACP,CAAC,CACC,UAAU,EACV,8EAA8E,EAC9E,MAAM,CACP;KACF;IACD,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,sDAAsD,EAAE,MAAM,CAAC,CAAC;IACpF;QACE,QAAQ;QACR,CAAC,CACC,gBAAgB,EAChB,wFAAwF,EACxF,MAAM,CACP;KACF;IACD;QACE,SAAS;QACT,CAAC,CACC,0BAA0B,EAC1B,sFAAsF,EACtF,IAAI,CACL;KACF;IACD;QACE,UAAU;QACV,CAAC,CACC,0BAA0B,EAC1B,mEAAmE,EACnE,MAAM,CACP;KACF;CACF,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAgC,IAAI,GAAG,CAAC;IAC5D,CAAC,IAAI,EAAE,aAAa,CAAC;IACrB,CAAC,KAAK,EAAE,cAAc,CAAC;IACvB,CAAC,QAAQ,EAAE,4BAA4B,CAAC;IACxC,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAClC,CAAC,OAAO,EAAE,uBAAuB,CAAC;IAClC,CAAC,KAAK,EAAE,6BAA6B,CAAC;IACtC,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IACrC,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IACrC,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IACrC,CAAC,MAAM,EAAE,6BAA6B,CAAC;CACxC,CAAC,CAAC;AAEH,MAAM,UAAU,GAA2B;IACzC,IAAI,EAAE,oDAAoD;IAC1D,IAAI,EAAE,yBAAyB;IAC/B,IAAI,EAAE,wDAAwD;IAC9D,IAAI,EAAE,oBAAoB;IAC1B,IAAI,EAAE,4CAA4C;IAClD,KAAK,EAAE,2CAA2C;CACnD,CAAC;AAEF,mFAAmF;AACnF,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO,CAAC,CAAC,IAAI,EAAE,kBAAkB,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,GAAG,KAAK,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3F,CAAC;IACD,IAAK,MAA4B,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC9C,OAAO,CAAC,CAAC,IAAI,EAAE,YAAY,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACvD,IAAK,aAAmC,CAAC,QAAQ,CAAC,IAAI,CAAC;QACrD,OAAO,CAAC,CAAC,IAAI,EAAE,iDAAiD,EAAE,IAAI,CAAC,CAAC;IAC1E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,qEAAqE;AACrE,MAAM,CAAC,MAAM,YAAY,GAA8B,IAAI,GAAG,CAAC;IAC7D,CAAC,UAAU,EAAE,CAAC,CAAC,eAAe,EAAE,yBAAyB,EAAE,GAAG,CAAC,CAAC;IAChE;QACE,MAAM;QACN,CAAC,CACC,+BAA+B,EAC/B,kEAAkE,EAClE,KAAK,CACN;KACF;IACD;QACE,MAAM;QACN,CAAC,CAAC,uBAAuB,EAAE,6DAA6D,EAAE,IAAI,CAAC;KAChG;IACD;QACE,UAAU;QACV,CAAC,CACC,2BAA2B,EAC3B,6EAA6E,EAC7E,IAAI,CACL;KACF;IACD,CAAC,QAAQ,EAAE,CAAC,CAAC,cAAc,EAAE,kDAAkD,EAAE,IAAI,CAAC,CAAC;IACvF,CAAC,KAAK,EAAE,CAAC,CAAC,kBAAkB,EAAE,0CAA0C,EAAE,GAAG,CAAC,CAAC;IAC/E,CAAC,IAAI,EAAE,CAAC,CAAC,+BAA+B,EAAE,0CAA0C,EAAE,GAAG,CAAC,CAAC;IAC3F,CAAC,MAAM,EAAE,CAAC,CAAC,YAAY,EAAE,6CAA6C,EAAE,GAAG,CAAC,CAAC;IAC7E,CAAC,QAAQ,EAAE,CAAC,CAAC,qBAAqB,EAAE,mDAAmD,EAAE,GAAG,CAAC,CAAC;IAC9F,CAAC,IAAI,EAAE,CAAC,CAAC,eAAe,EAAE,uCAAuC,EAAE,GAAG,CAAC,CAAC;IACxE;QACE,KAAK;QACL,CAAC,CACC,8BAA8B,EAC9B,wEAAwE,EACxE,GAAG,CACJ;KACF;IACD;QACE,MAAM;QACN,CAAC,CAAC,MAAM,EAAE,0EAA0E,EAAE,GAAG,CAAC;KAC3F;IACD,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,gCAAgC,EAAE,GAAG,CAAC,CAAC;IACtD,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,qBAAqB,EAAE,GAAG,CAAC,CAAC;IAC3C,CAAC,OAAO,EAAE,CAAC,CAAC,uBAAuB,EAAE,oDAAoD,EAAE,GAAG,CAAC,CAAC;IAChG,CAAC,QAAQ,EAAE,CAAC,CAAC,cAAc,EAAE,oDAAoD,EAAE,MAAM,CAAC,CAAC;IAC3F;QACE,KAAK;QACL,CAAC,CACC,mBAAmB,EACnB,mEAAmE,EACnE,IAAI,CACL;KACF;IACD;QACE,SAAS;QACT,CAAC,CAAC,eAAe,EAAE,8DAA8D,EAAE,MAAM,CAAC;KAC3F;IACD;QACE,WAAW;QACX,CAAC,CACC,mBAAmB,EACnB,qEAAqE,EACrE,MAAM,CACP;KACF;IACD;QACE,OAAO;QACP,CAAC,CAAC,SAAS,EAAE,oEAAoE,EAAE,IAAI,CAAC;KACzF;IACD,CAAC,QAAQ,EAAE,CAAC,CAAC,UAAU,EAAE,8BAA8B,EAAE,MAAM,CAAC,CAAC;IACjE,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE,8BAA8B,EAAE,MAAM,CAAC,CAAC;IAC/D,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE,8BAA8B,EAAE,MAAM,CAAC,CAAC;IAC/D,CAAC,WAAW,EAAE,CAAC,CAAC,aAAa,EAAE,oCAAoC,EAAE,MAAM,CAAC,CAAC;IAC7E,CAAC,SAAS,EAAE,CAAC,CAAC,WAAW,EAAE,0DAA0D,EAAE,MAAM,CAAC,CAAC;IAC/F;QACE,YAAY;QACZ,CAAC,CAAC,yBAAyB,EAAE,+CAA+C,EAAE,IAAI,CAAC;KACpF;IACD,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,+DAA+D,EAAE,IAAI,CAAC,CAAC;IAC5F,CAAC,OAAO,EAAE,CAAC,CAAC,aAAa,EAAE,4DAA4D,EAAE,IAAI,CAAC,CAAC;IAC/F,CAAC,SAAS,EAAE,CAAC,CAAC,WAAW,EAAE,yCAAyC,EAAE,MAAM,CAAC,CAAC;IAC9E,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,iCAAiC,EAAE,MAAM,CAAC,CAAC;IAChE,CAAC,MAAM,EAAE,CAAC,CAAC,gBAAgB,EAAE,uDAAuD,EAAE,MAAM,CAAC,CAAC;IAC9F,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,EAAE,yDAAyD,EAAE,MAAM,CAAC,CAAC;IAC1F,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,iDAAiD,EAAE,MAAM,CAAC,CAAC;IAC9E,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,0BAA0B,EAAE,MAAM,CAAC,CAAC;IACzD;QACE,QAAQ;QACR,CAAC,CACC,mBAAmB,EACnB,iEAAiE,EACjE,MAAM,CACP;KACF;IACD,CAAC,QAAQ,EAAE,CAAC,CAAC,mBAAmB,EAAE,qCAAqC,EAAE,MAAM,CAAC,CAAC;IACjF;QACE,MAAM;QACN,CAAC,CAAC,2BAA2B,EAAE,uDAAuD,EAAE,MAAM,CAAC;KAChG;IACD,CAAC,QAAQ,EAAE,CAAC,CAAC,UAAU,EAAE,+CAA+C,EAAE,MAAM,CAAC,CAAC;IAClF,CAAC,IAAI,EAAE,CAAC,CAAC,2BAA2B,EAAE,iBAAiB,EAAE,KAAK,CAAC,CAAC;IAChE,CAAC,MAAM,EAAE,CAAC,CAAC,oBAAoB,EAAE,0CAA0C,EAAE,KAAK,CAAC,CAAC;IACpF,CAAC,KAAK,EAAE,CAAC,CAAC,iBAAiB,EAAE,oDAAoD,EAAE,KAAK,CAAC,CAAC;IAC1F,CAAC,IAAI,EAAE,CAAC,CAAC,aAAa,EAAE,0CAA0C,EAAE,MAAM,CAAC,CAAC;IAC5E,CAAC,KAAK,EAAE,CAAC,CAAC,SAAS,EAAE,yBAAyB,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,yBAAyB,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,yBAAyB,EAAE,KAAK,CAAC,CAAC;IACrD,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC,OAAO,EAAE,CAAC,CAAC,gBAAgB,EAAE,4CAA4C,EAAE,MAAM,CAAC,CAAC;IACpF;QACE,QAAQ;QACR,CAAC,CACC,iBAAiB,EACjB,+EAA+E,EAC/E,MAAM,CACP;KACF;IACD,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,iDAAiD,EAAE,IAAI,CAAC,CAAC;IAC5E,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,oEAAoE,EAAE,IAAI,CAAC,CAAC;IAC/F;QACE,OAAO;QACP,CAAC,CAAC,YAAY,EAAE,gEAAgE,EAAE,IAAI,CAAC;KACxF;CACF,CAAC,CAAC;AAEH,yCAAyC;AACzC,MAAM,CAAC,MAAM,WAAW,GAAmD,IAAI,GAAG,CAAC;IACjF;QACE,OAAO;QACP,IAAI,GAAG,CAAC;YACN,CAAC,MAAM,EAAE,CAAC,CAAC,YAAY,EAAE,oCAAoC,EAAE,IAAI,CAAC,CAAC;YACrE,CAAC,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,uCAAuC,EAAE,IAAI,CAAC,CAAC;YACtE,CAAC,MAAM,EAAE,CAAC,CAAC,YAAY,EAAE,qCAAqC,EAAE,IAAI,CAAC,CAAC;YACtE,CAAC,OAAO,EAAE,CAAC,CAAC,aAAa,EAAE,wBAAwB,EAAE,IAAI,CAAC,CAAC;YAC3D,CAAC,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,0DAA0D,EAAE,IAAI,CAAC,CAAC;SAC1F,CAAC;KACH;IACD;QACE,QAAQ;QACR,IAAI,GAAG,CAAC;YACN;gBACE,UAAU;gBACV,CAAC,CAAC,iBAAiB,EAAE,kDAAkD,EAAE,MAAM,CAAC;aACjF;YACD,CAAC,SAAS,EAAE,CAAC,CAAC,gBAAgB,EAAE,+CAA+C,EAAE,MAAM,CAAC,CAAC;YACzF,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,gCAAgC,EAAE,MAAM,CAAC,CAAC;YAChE,CAAC,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,kCAAkC,EAAE,MAAM,CAAC,CAAC;YACtE,CAAC,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,+BAA+B,EAAE,MAAM,CAAC,CAAC;YACnE,CAAC,UAAU,EAAE,CAAC,CAAC,iBAAiB,EAAE,0CAA0C,EAAE,MAAM,CAAC,CAAC;YACtF,CAAC,OAAO,EAAE,CAAC,CAAC,cAAc,EAAE,oBAAoB,EAAE,MAAM,CAAC,CAAC;YAC1D,CAAC,QAAQ,EAAE,CAAC,CAAC,eAAe,EAAE,qBAAqB,EAAE,MAAM,CAAC,CAAC;YAC7D,CAAC,OAAO,EAAE,CAAC,CAAC,cAAc,EAAE,qBAAqB,EAAE,MAAM,CAAC,CAAC;YAC3D,CAAC,OAAO,EAAE,CAAC,CAAC,cAAc,EAAE,oBAAoB,EAAE,MAAM,CAAC,CAAC;YAC1D,CAAC,WAAW,EAAE,CAAC,CAAC,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,CAAC,CAAC;YACtE,CAAC,SAAS,EAAE,CAAC,CAAC,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,CAAC,CAAC;SACjE,CAAC;KACH;CACF,CAAC,CAAC;AAEH,8DAA8D;AAC9D,MAAM,UAAU,SAAS,CAAC,CAAW;IACnC,IAAI,CAAC,CAAC,OAAO;QAAE,OAAO,UAAU,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACxE,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,eAAe,CAAC;IAC9C,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;QACrB,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAI,CAAC,KAAK,OAAO,CAAC,CAAC,GAAI,CAAC,MAAM,GAAG,CAAC;IAChF,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAC1D,IAAI,IAAI,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC5D,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;QAAE,IAAI,IAAI,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,IAAI,CAAC,CAAC,GAAG;QAAE,IAAI,IAAI,aAAa,CAAC;IACjC,OAAO,IAAI,CAAC;AACd,CAAC;AAUD,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,MAAe,EAAE,EAAE,CAClD,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;AAElF,MAAM,QAAQ,GAAG,CAAC,CAAO,EAAE,MAAc,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,MAAM,IAAI,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;AAEnF,0FAA0F;AAC1F,SAAS,SAAS,CAAC,OAAoB,EAAE,MAAc;IACrD,MAAM,GAAG,GAAc,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAG,CAAC,IAAU,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,CAAC,CAAW,EAAW,EAAE,CAAC,CAAC;QAC5C,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,CAAC,CACL,QAAQ,CAAC,CAAC,QAAQ,EAAE,EACpB,CAAC,CAAC,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS,EACtE,GAAG,CACJ;KACF,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,IAAY,EAAE,OAAe,EAAW,EAAE,CAAC,CAAC;QAC1E,IAAI;QACJ,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC;KAC7B,CAAC,CAAC;IAEH,+DAA+D;IAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;IACjC,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CACnF,CAAC;IACF,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAC/C,GAAG,CAAC,IAAI,CAAC;oBACP,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU;oBAC7C,IAAI,EAAE,CAAC,CACL,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAC3E,CAAC,CAAC,IAAI,KAAK,MAAM;wBACf,CAAC,CAAC,kCAAkC;wBACpC,CAAC,CAAC,sCAAsC,EAC1C,IAAI,CACL;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,KAAsB,EAAE,MAAe,EAAQ,EAAE;QAC9D,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACtB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBACpB,IAAI,CAAC;oBAAE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;YACjC,CAAC;iBAAM,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,MAAM,EAAE,CAAC;gBACrD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QACD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC;gBAAE,SAAS;YACxC,MAAM,IAAI,GAAG,CAAC,CAAoB,EAAE,EAAE;gBACpC,IAAI,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC;oBAAE,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC5D,CAAC,CAAC;YACF,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;gBACf,KAAK,MAAM,CAAC;gBACZ,KAAK,UAAU;oBACb,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;wBAAE,MAAM;oBAC1C,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM;wBACtB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC,IAAI,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;oBACpE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;oBAC1B,MAAM;gBACR,KAAK,YAAY,CAAC;gBAClB,KAAK,OAAO;oBACV,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;oBACb,MAAM;gBACR,KAAK,IAAI;oBACP,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ;wBAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;oBAC1C,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;oBAClB,MAAM;gBACR,KAAK,QAAQ;oBACX,IAAI,CAAC,CAAC,EAAE,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC;wBACxC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,6BAA6B,EAAE,GAAG,CAAC,CAAC,CAAC;oBACpE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;oBACd,MAAM;gBACR,KAAK,KAAK;oBACR,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC;wBAChC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,EAAE,GAAG,CAAC,CAAC,CAAC;oBACnE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;oBACd,MAAM;gBACR,KAAK,WAAW;oBACd,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC;wBAChC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,6CAA6C,EAAE,MAAM,CAAC,CAAC,CAAC;oBACpF,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;oBACd,MAAM;gBACR,KAAK,OAAO,CAAC;gBACb,KAAK,QAAQ,CAAC;gBACd,KAAK,SAAS,CAAC;gBACf,KAAK,KAAK;oBACR,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;oBACd,MAAM;YACV,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACtD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8BAA8B;AAE9B,6EAA6E;AAC7E,SAAS,OAAO,CAAC,MAAwB,EAAE,MAAc;IACvD,OAAO,MAAM,CAAC,SAAS,CACrB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,MAAM,IAAI,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAC7F,CAAC;AACJ,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,MAAM,CACpB,OAAoB,EACpB,MAAc;IAEd,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IACxE,MAAM,KAAK,GAAG,CAAC,IAAsB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEtF,0DAA0D;IAC1D,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,IAAI,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5E,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC;QACxE,OAAO,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,mCAAmC;AAEnC,kFAAkF;AAClF,MAAM,UAAU,aAAa,CAAC,OAAoB,EAAE,MAAc;IAChE,iDAAiD;IACjD,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAC5C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,MAAM,CACxE,CAAC;IACF,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,MAAM;QAAE,CAAC,EAAE,CAAC;IAC/F,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,IAAI,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9D,OAAO,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAE,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;YACzE,KAAK;YACL,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,IAAI,CAAC,IAAI;SAClB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC1C,MAAM,GAAG,GAAG,CAAC,CAAa,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACnD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;YACpE,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,aAAa;QACtC,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC7D,KAAK,MAAM,IAAI,IAAI,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5C,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC;QAC3C,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;AAC3B,CAAC"}

package/dist/index.d.ts

@@ -7,6 +7,9 @@ export { check, type CheckResult } from "./checker.js";
 export { format, formatText, type FormatResult } from "./format.js";
 export { build, buildBackground, DEFAULT_LIMITS, type BackgroundResult, type BuildOptions, type BuildResult, type Inputs, type LaidShape, type Limits, type MusicInputs, } from "./interpreter.js";
 export type { GeneInfo, GeneKind, GeneSection, HueArc } from "./genes.js";
+export { breed, geneEdits, geneLiteral, morph, mutate, valuesOf, writeGenes, type GeneSet, type GeneticsOptions, type GeneValues, type MutateOptions, } from "./genetics.js";
+export { completionsAt, constantHelp, FUNCTION_HELP, geneRange, helpAt, KEYWORD_HELP, MEMBER_HELP, type Completion, type CompletionKind, type Help, } from "./help.js";
+export { mulberry32 } from "./noise.js";
 export { BUILTIN_CONSTANTS, BUILTIN_FUNCTIONS, isBuiltinName, type BuiltinFunction, } from "./builtins.js";
 export { hsv, rgb, hexColour, toRgb, mixColour, sampleGradient, NAMED_COLOURS } from "./colour.js";
 export { formatValue, typeOf, SHAPES, PATTERN_KINDS } from "./values.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,6CAA6C;AAC7C,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC,mBAAmB,UAAU,CAAC;AAC9B,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EACL,KAAK,EACL,eAAe,EACf,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzE,YAAY,EACV,MAAM,EACN,QAAQ,EACR,OAAO,EACP,eAAe,EACf,SAAS,EACT,QAAQ,EACR,KAAK,EACL,GAAG,GACJ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,IAAI,GACV,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,6CAA6C;AAC7C,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC,mBAAmB,UAAU,CAAC;AAC9B,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EACL,KAAK,EACL,eAAe,EACf,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,EACL,KAAK,EACL,SAAS,EACT,WAAW,EACX,KAAK,EACL,MAAM,EACN,QAAQ,EACR,UAAU,EACV,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,MAAM,EACN,YAAY,EACZ,WAAW,EACX,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,IAAI,GACV,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzE,YAAY,EACV,MAAM,EACN,QAAQ,EACR,OAAO,EACP,eAAe,EACf,SAAS,EACT,QAAQ,EACR,KAAK,EACL,GAAG,GACJ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,IAAI,GACV,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 // The GenoCode language: lexer, parser, checker, formatter and interpreter
-// (docs/LANGUAGE.md). Genetics is added in roadmap phase 3.
+// (docs/LANGUAGE.md), and genetics: mutating, breeding and morphing genes.
 /** The file extension for GenoCode files. */
 export const FILE_EXTENSION = ".genie";
 export { lex, KEYWORDS } from "./lexer.js";
@@ -7,6 +7,9 @@ export { parse } from "./parser.js";
 export { check } from "./checker.js";
 export { format, formatText } from "./format.js";
 export { build, buildBackground, DEFAULT_LIMITS, } from "./interpreter.js";
+export { breed, geneEdits, geneLiteral, morph, mutate, valuesOf, writeGenes, } from "./genetics.js";
+export { completionsAt, constantHelp, FUNCTION_HELP, geneRange, helpAt, KEYWORD_HELP, MEMBER_HELP, } from "./help.js";
+export { mulberry32 } from "./noise.js";
 export { BUILTIN_CONSTANTS, BUILTIN_FUNCTIONS, isBuiltinName, } from "./builtins.js";
 export { hsv, rgb, hexColour, toRgb, mixColour, sampleGradient, NAMED_COLOURS } from "./colour.js";
 export { formatValue, typeOf, SHAPES, PATTERN_KINDS } from "./values.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,4DAA4D;AAE5D,6CAA6C;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AAGvC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAA8C,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,KAAK,EAAoB,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,KAAK,EAAoB,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAqB,MAAM,aAAa,CAAC;AACpE,OAAO,EACL,KAAK,EACL,eAAe,EACf,cAAc,GAQf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,GAEd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAWzE,OAAO,EACL,gBAAgB,EAChB,OAAO,GAKR,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,2EAA2E;AAE3E,6CAA6C;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC;AAGvC,OAAO,EAAE,GAAG,EAAE,QAAQ,EAA8C,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,KAAK,EAAoB,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,KAAK,EAAoB,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAqB,MAAM,aAAa,CAAC;AACpE,OAAO,EACL,KAAK,EACL,eAAe,EACf,cAAc,GAQf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,KAAK,EACL,SAAS,EACT,WAAW,EACX,KAAK,EACL,MAAM,EACN,QAAQ,EACR,UAAU,GAKX,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,MAAM,EACN,YAAY,EACZ,WAAW,GAIZ,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,GAEd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAWzE,OAAO,EACL,gBAAgB,EAChB,OAAO,GAKR,MAAM,aAAa,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@genocode/core",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "The GenoCode language: parser, checker, formatter, interpreter and genetics.",
   "license": "MIT",
   "repository": {

package/reference/LANGUAGE.md

@@ -912,6 +912,16 @@ A morph through several creatures (a loop) is a chain of these morphs between ne
 and B share a program, a morph is smooth all the way; when their programs differ, the creature
 changes shape at the halfway point.
 
+### 19.4 Saving
+
+A creature that has been mutated, bred or morphed is saved as an ordinary creature file: its
+program, with each gene's new value written into the gene's line. Nothing else in the program
+changes, except that the file is laid out by the formatter, and a gene whose value hasn't changed
+keeps the text it was written with. The new values are written readably: stepped numbers exactly,
+other numbers to four significant figures, colours as `hsv(…)`, and choices by name, always within
+the gene's range. The automatic `seed` gene has no line of its own, so it isn't saved yet: a saved
+creature that uses `random` starts again from seed 0.
+
 ## 20. Building a creature
 
 1. **Checking.** The file is read and checked: syntax, names, gene rules, function rules, and types

package/reference/creatures/StarBurstShell.genie

@@ -0,0 +1,102 @@
+creature StarBurstShell
+// A spiraling geometric shell composed of bead spikes that unfurls into a sprawling celestial star.
+// Fixed color gene ranges and reserved keyword variables.
+
+gene unfurl = 0.45 in 0..1    // 0 packs the spikes into a tight spiral shell; 1 explodes them into a star
+gene gloss = 0.75 in 0..1     // intensity of the metallic shell sheen
+gene focus = 0.40 in 0..1     // sharpness of the light reflections
+gene heightOffset = 8.0 in -15..15 // vertical expansion amplitude as it opens
+
+shine gloss
+sharpness focus
+
+// Wrap the top-level part call in a branch to protect downstream rendering
+branch {
+    shellSpikes
+}
+
+forward heightOffset * unfurl
+pitch 90
+
+// Generate 6 primary crown spikes circling the top axis
+repeat 6 {
+    branch {
+        crownSpike
+    }
+    yaw 60
+}
+
+// The core body structure: 10 concentric, winding layers of beads
+part shellSpikes {
+    gene maxRadius = 12 in 5..20
+    gene baseBeadSize = 0.75 in 0.2..1.5
+    
+    // Galactic neon palette gradient with mandatory range specifications
+    gene coreColor = hsv(240, 0.85, 0.2) in hsv(0, 0, 0)..hsv(360, 1, 1)   // Deep space blue
+    gene midColor1 = hsv(300, 0.90, 0.5) in hsv(0, 0, 0)..hsv(360, 1, 1)   // Cosmic magenta
+    gene midColor2 = hsv(340, 0.95, 0.8) in hsv(0, 0, 0)..hsv(360, 1, 1)   // Electric pink
+    gene outerColor = hsv(15, 0.80, 0.95) in hsv(0, 0, 0)..hsv(360, 1, 1)  // Nebula orange
+    
+    let skin = gradient(coreColor, midColor1, midColor2, outerColor)
+    shape ball
+    
+    repeat 10 as layer {
+        let latAngle = 180 * layer / 10
+        colour skin(layer / 10)
+        
+        // As unfurl approaches 1, structural layout transitions from flat spirals to a wide-latitude sphere
+        let distance = mix(layer, sin(latAngle) * maxRadius, unfurl)
+        let verticalZ = unfurl * cos(latAngle) * maxRadius
+        let stepCount = tau * layer
+        
+        repeat floor(stepCount) as s {
+            let lonAngle = 360 * s / stepCount
+            
+            branch {
+                // Positional placement using standard trigonometric displacement
+                move (distance * cos(lonAngle), distance * sin(lonAngle), verticalZ)
+                lay { grow baseBeadSize }
+            }
+        }
+    }
+}
+
+// A twisting, needle-sharp spike branch that reacts heavily to the unfurl gene
+part crownSpike {
+    gene twistFactor = 1.25 in -3..3 // how sharply the crown arms curve outward
+    
+    // Crown color parameters with mandatory range specifications
+    gene rootColor = hsv(160, 0.70, 0.6) in hsv(0, 0, 0)..hsv(360, 1, 1)  // Turquoise heart
+    gene bodyColor = hsv(200, 0.80, 0.8) in hsv(0, 0, 0)..hsv(360, 1, 1)  // Cyan mid-section
+    gene flareColor = hsv(280, 0.85, 0.7) in hsv(0, 0, 0)..hsv(360, 1, 1) // Violet edge
+    gene apexColor = hsv(0, 0.0, 1.0) in hsv(0, 0, 0)..hsv(360, 1, 1)     // Pure white tips
+    
+    let skin = gradient(rootColor, bodyColor, flareColor, apexColor)
+    
+    branch {
+        forward 3.0
+        pitch -25
+        yaw 15
+        roll 45
+        shape ball
+        
+        // Iteratively chain 25 progressively scaling segments to build a fine tip
+        for segment from 1 to 25 {
+            let taper = bump(segment / 26) // custom envelope tracking
+            colour skin(taper)
+            
+            yaw 8
+            branch {
+                forward 0.15
+                pitch 45 * taper * twistFactor
+                // Drastically changes length/width profile when unrolled
+                lay { grow (unfurl, unfurl, unfurl * 4 * (taper + 0.5)) }
+            }
+            move (0.35 * unfurl, 0, 0)
+        }
+    }
+}
+
+background {
+    fill gradient(hsv(275, 0.6, 0.08), hsv(220, 0.5, 0.25))
+}

package/reference/creatures/StarBurstShell9.genie

@@ -0,0 +1,102 @@
+creature StarBurstShell
+// A spiraling geometric shell composed of bead spikes that unfurls into a sprawling celestial star.
+// Fixed color gene ranges and reserved keyword variables.
+
+gene unfurl       = 0.2016 in 0..1     // 0 packs the spikes into a tight spiral shell; 1 explodes them into a star
+gene gloss        = 0.5104 in 0..1     // intensity of the metallic shell sheen
+gene focus        = 0.3599 in 0..1     // sharpness of the light reflections
+gene heightOffset = 9.545  in -15..15  // vertical expansion amplitude as it opens
+
+shine gloss
+sharpness focus
+
+// Wrap the top-level part call in a branch to protect downstream rendering
+branch {
+  shellSpikes
+}
+
+forward heightOffset * unfurl
+pitch 90
+
+// Generate 6 primary crown spikes circling the top axis
+repeat 6 {
+  branch {
+    crownSpike
+  }
+  yaw 60
+}
+
+// The core body structure: 10 concentric, winding layers of beads
+part shellSpikes {
+  gene maxRadius    = 10.95  in 5..20
+  gene baseBeadSize = 0.6653 in 0.2..1.5
+
+  // Galactic neon palette gradient with mandatory range specifications
+  gene coreColor  = hsv(240, 0.85, 0.2) in hsv(0, 0, 0)..hsv(360, 1, 1)    // Deep space blue
+  gene midColor1  = hsv(300, 0.87, 0.49) in hsv(0, 0, 0)..hsv(360, 1, 1)   // Cosmic magenta
+  gene midColor2  = hsv(35.9, 0.81, 0.71) in hsv(0, 0, 0)..hsv(360, 1, 1)  // Electric pink
+  gene outerColor = hsv(38.8, 0.79, 0.75) in hsv(0, 0, 0)..hsv(360, 1, 1)  // Nebula orange
+
+  let skin = gradient(coreColor, midColor1, midColor2, outerColor)
+  shape ball
+
+  repeat 10 as layer {
+    let latAngle = 180 * layer / 10
+    colour skin(layer / 10)
+
+    // As unfurl approaches 1, structural layout transitions from flat spirals to a wide-latitude sphere
+    let distance = mix(layer, sin(latAngle) * maxRadius, unfurl)
+    let verticalZ = unfurl * cos(latAngle) * maxRadius
+    let stepCount = tau * layer
+
+    repeat floor(stepCount) as s {
+      let lonAngle = 360 * s / stepCount
+
+      branch {
+        // Positional placement using standard trigonometric displacement
+        move (distance * cos(lonAngle), distance * sin(lonAngle), verticalZ)
+        lay { grow baseBeadSize }
+      }
+    }
+  }
+}
+
+// A twisting, needle-sharp spike branch that reacts heavily to the unfurl gene
+part crownSpike {
+  gene twistFactor = 1.161 in -3..3  // how sharply the crown arms curve outward
+
+  // Crown color parameters with mandatory range specifications
+  gene rootColor  = hsv(184.3, 0.71, 0.68) in hsv(0, 0, 0)..hsv(360, 1, 1)  // Turquoise heart
+  gene bodyColor  = hsv(184.8, 0.8, 0.76) in hsv(0, 0, 0)..hsv(360, 1, 1)   // Cyan mid-section
+  gene flareColor = hsv(253.4, 0.74, 0.7) in hsv(0, 0, 0)..hsv(360, 1, 1)   // Violet edge
+  gene apexColor  = hsv(0, 0.03, 1) in hsv(0, 0, 0)..hsv(360, 1, 1)         // Pure white tips
+
+  let skin = gradient(rootColor, bodyColor, flareColor, apexColor)
+
+  branch {
+    forward 3.0
+    pitch -25
+    yaw 15
+    roll 45
+    shape ball
+
+    // Iteratively chain 25 progressively scaling segments to build a fine tip
+    for segment from 1 to 25 {
+      let taper = bump(segment / 26)  // custom envelope tracking
+      colour skin(taper)
+
+      yaw 8
+      branch {
+        forward 0.15
+        pitch 45 * taper * twistFactor
+        // Drastically changes length/width profile when unrolled
+        lay { grow (unfurl, unfurl, unfurl * 4 * (taper + 0.5)) }
+      }
+      move (0.35 * unfurl, 0, 0)
+    }
+  }
+}
+
+background {
+  fill gradient(hsv(275, 0.6, 0.08), hsv(220, 0.5, 0.25))
+}