desmost 0.8.2 → 0.9.0

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,8HAA8H;AAC9H,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;AAM3C;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;CAAG;AAEhD,WAAiB,kBAAkB;IAElC,+EAA+E;IAC/E,MAAa,aAAc,SAAQ,kBAAkB;KAAG;IAA3C,gCAAa,gBAA8B,CAAA;IAExD,yDAAyD;IACzD,MAAa,YAAa,SAAQ,kBAAkB;KAAG;IAA1C,+BAAY,eAA8B,CAAA;IAEvD,qEAAqE;IACrE,MAAa,eAAgB,SAAQ,kBAAkB;KAAG;IAA7C,kCAAe,kBAA8B,CAAA;IAE1D,+DAA+D;IAC/D,MAAa,WAAY,SAAQ,kBAAkB;KAAG;IAAzC,8BAAW,cAA8B,CAAA;IAGtD,4CAA4C;IAC5C,MAAa,kBAAmB,SAAQ,kBAAkB;KAAG;IAAhD,qCAAkB,qBAA8B,CAAA;IAE7D,oDAAoD;IACpD,MAAa,eAAgB,SAAQ,kBAAkB;KAAG;IAA7C,kCAAe,kBAA8B,CAAA;AAC3D,CAAC,EApBgB,kBAAkB,KAAlB,kBAAkB,QAoBlC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,8HAA8H;AAC9H,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;AAM3C;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAE5C,IAAI,CAA2B;CAC/B;AAED,WAAiB,kBAAkB;IASlC,+EAA+E;IAC/E,MAAa,aAAc,SAAQ,kBAAkB;QAClB;QAAlC,YAAY,GAAW,EAAW,IAAW;YAAI,KAAK,CAAC,GAAG,CAAC,CAAC;YAA1B,SAAI,GAAJ,IAAI,CAAO;YAAgB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAAC,CAAC;KAC5F;IAFY,gCAAa,gBAEzB,CAAA;IAED,yDAAyD;IACzD,MAAa,YAAa,SAAQ,kBAAkB;QACjB;QAAlC,YAAY,GAAW,EAAW,IAAW;YAAI,KAAK,CAAC,GAAG,CAAC,CAAC;YAA1B,SAAI,GAAJ,IAAI,CAAO;YAAgB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAAC,CAAC;KAC3F;IAFY,+BAAY,eAExB,CAAA;IAED,qEAAqE;IACrE,MAAa,eAAgB,SAAQ,kBAAkB;QACpB;QAAlC,YAAY,GAAW,EAAW,IAAW;YAAI,KAAK,CAAC,GAAG,CAAC,CAAC;YAA1B,SAAI,GAAJ,IAAI,CAAO;YAAgB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAAC,CAAC;KAC9F;IAFY,kCAAe,kBAE3B,CAAA;IAED,+DAA+D;IAC/D,MAAa,WAAY,SAAQ,kBAAkB;QAChB;QAAlC,YAAY,GAAW,EAAW,IAAW;YAAI,KAAK,CAAC,GAAG,CAAC,CAAC;YAA1B,SAAI,GAAJ,IAAI,CAAO;YAAgB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAAC,CAAC;KAC1F;IAFY,8BAAW,cAEvB,CAAA;IAED,4CAA4C;IAC5C,MAAa,kBAAmB,SAAQ,kBAAkB;QACvB;QAAlC,YAAY,GAAW,EAAW,IAAW;YAAI,KAAK,CAAC,GAAG,CAAC,CAAC;YAA1B,SAAI,GAAJ,IAAI,CAAO;YAAgB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAAC,CAAC;KACjG;IAFY,qCAAkB,qBAE9B,CAAA;IAED,oDAAoD;IACpD,MAAa,eAAgB,SAAQ,kBAAkB;QACpB;QAAlC,YAAY,GAAW,EAAW,IAAW;YAAI,KAAK,CAAC,GAAG,CAAC,CAAC;YAA1B,SAAI,GAAJ,IAAI,CAAO;YAAgB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAAC,CAAC;KAC9F;IAFY,kCAAe,kBAE3B,CAAA;AACF,CAAC,EAtCgB,kBAAkB,KAAlB,kBAAkB,QAsClC"}

package/dist/index.d.ts

@@ -1,3 +1,3 @@
-export { compile, type DesmostOptions } from "./compiler/index.js";
-export { decompile } from "./decompiler/index.js";
+export { compile } from "./compiler/index.js";
+export type { DesmostOptions } from "./options.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.internal.d.ts

@@ -1,4 +1,4 @@
-export { fill_defaults, DEFAULT_OPTIONS } from "./compiler/options.js";
+export { DEFAULT_OPTIONS } from "./options.js";
 export type { DesmostDebug } from "./compiler/compile.js";
 export { Ast } from "./parser/index.js";
 export { desmos_to_ast, ast_to_source } from "./decompiler/decompile.js";

package/dist/index.internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.internal.d.ts","sourceRoot":"","sources":["../src/index.internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACpE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.internal.d.ts","sourceRoot":"","sources":["../src/index.internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.internal.js

@@ -1,4 +1,4 @@
-export { fill_defaults, DEFAULT_OPTIONS } from "./compiler/options.js";
+export { DEFAULT_OPTIONS } from "./options.js";
 export { Ast } from "./parser/index.js";
 export { desmos_to_ast, ast_to_source } from "./decompiler/decompile.js";
 //# sourceMappingURL=index.internal.js.map

package/dist/index.internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.internal.js","sourceRoot":"","sources":["../src/index.internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGpE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.internal.js","sourceRoot":"","sources":["../src/index.internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -1,3 +1,2 @@
 export { compile } from "./compiler/index.js";
-export { decompile } from "./decompiler/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAuB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/magic/expr/latex.d.ts

@@ -4,7 +4,6 @@ export declare class LatexIncantation extends ArgIncantation<EXPR> {
     readonly identifier = "latex";
     readonly requires_arg = true;
     readonly arg_type = Incantation.ArgType.LATEX;
-    apply(target: Desmos.ExpressionState, data: string): void;
-    evaluate_arg(data: string): string;
+    apply(target: Desmos.ExpressionState, data: string): asserts target is Desmos.Expression;
 }
 //# sourceMappingURL=latex.d.ts.map

package/dist/magic/expr/latex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"latex.d.ts","sourceRoot":"","sources":["../../../src/magic/expr/latex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAGxE,qBAAa,gBAAiB,SAAQ,cAAc,CAAC,IAAI,CAAC;IAEzD,SAAkB,WAAW,+EACiD;IAE9E,SAAkB,UAAU,WAAY;IACxC,SAAkB,YAAY,QAAO;IACrC,SAAkB,QAAQ,6BAAgC;IAE1D,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAOhD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAI3C"}
+{"version":3,"file":"latex.d.ts","sourceRoot":"","sources":["../../../src/magic/expr/latex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAGxE,qBAAa,gBAAiB,SAAQ,cAAc,CAAC,IAAI,CAAC;IAEzD,SAAkB,WAAW,+EACiD;IAE9E,SAAkB,UAAU,WAAY;IACxC,SAAkB,YAAY,QAAO;IACrC,SAAkB,QAAQ,6BAAgC;IAE1D,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,UAAU;CAMxF"}

package/dist/magic/expr/latex.js

@@ -6,11 +6,8 @@ export class LatexIncantation extends ArgIncantation {
     arg_type = Incantation.ArgType.LATEX;
     apply(target, data) {
         target.type = "expression";
-        // @ts-expect-error: outdated types
+        // @ts-expect-error: previous assignment type-narrows
         target.latex = data === "" ? " " : data;
     }
-    evaluate_arg(data) {
-        return data;
-    }
 }
 //# sourceMappingURL=latex.js.map

package/dist/magic/expr/latex.js.map

@@ -1 +1 @@
-{"version":3,"file":"latex.js","sourceRoot":"","sources":["../../../src/magic/expr/latex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAa,MAAM,gBAAgB,CAAC;AAGxE,MAAM,OAAO,gBAAiB,SAAQ,cAAoB;IAEvC,WAAW,GAC1B,2EAA2E,CAAA;IAE5D,UAAU,GAAK,OAAO,CAAA;IACtB,YAAY,GAAG,IAAI,CAAA;IACnB,QAAQ,GAAO,WAAW,CAAC,OAAO,CAAC,KAAK,CAAA;IAE1D,KAAK,CAAC,MAA8B,EAAE,IAAY;QAEjD,MAAM,CAAC,IAAI,GAAG,YAAY,CAAC;QAC3B,mCAAmC;QACnC,MAAM,CAAC,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACzC,CAAC;IAEQ,YAAY,CAAC,IAAY;QAEjC,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}
+{"version":3,"file":"latex.js","sourceRoot":"","sources":["../../../src/magic/expr/latex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAa,MAAM,gBAAgB,CAAC;AAGxE,MAAM,OAAO,gBAAiB,SAAQ,cAAoB;IAEvC,WAAW,GAC1B,2EAA2E,CAAA;IAE5D,UAAU,GAAK,OAAO,CAAA;IACtB,YAAY,GAAG,IAAI,CAAA;IACnB,QAAQ,GAAO,WAAW,CAAC,OAAO,CAAC,KAAK,CAAA;IAE1D,KAAK,CAAC,MAA8B,EAAE,IAAY;QAEjD,MAAM,CAAC,IAAI,GAAG,YAAY,CAAC;QAC3B,qDAAqD;QACrD,MAAM,CAAC,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACzC,CAAC;CACD"}

package/dist/magic/expr/text.d.ts

@@ -5,6 +5,6 @@ export declare class TextIncantation extends ArgIncantation<EXPR> {
     readonly alias = "note";
     readonly requires_arg = true;
     readonly arg_type = Incantation.ArgType.STRING;
-    apply(target: Desmos.ExpressionState, data: string): void;
+    apply(target: Desmos.ExpressionState, data: string): asserts target is Desmos.Note;
 }
 //# sourceMappingURL=text.d.ts.map

package/dist/magic/expr/text.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/magic/expr/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAGxE,qBAAa,eAAgB,SAAQ,cAAc,CAAC,IAAI,CAAC;IAExD,SAAkB,WAAW,yEACiC;IAE9D,SAAkB,UAAU,UAAW;IACvC,SAAkB,KAAK,UAAgB;IACvC,SAAkB,YAAY,QAAO;IACrC,SAAkB,QAAQ,8BAAiC;IAElD,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,MAAM;CAM3D"}
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../src/magic/expr/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAGxE,qBAAa,eAAgB,SAAQ,cAAc,CAAC,IAAI,CAAC;IAExD,SAAkB,WAAW,yEACiC;IAE9D,SAAkB,UAAU,UAAW;IACvC,SAAkB,KAAK,UAAgB;IACvC,SAAkB,YAAY,QAAO;IACrC,SAAkB,QAAQ,8BAAiC;IAElD,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI;CAM3F"}

package/dist/magic/expr/text.js

@@ -7,7 +7,7 @@ export class TextIncantation extends ArgIncantation {
     arg_type = Incantation.ArgType.STRING;
     apply(target, data) {
         target.type = "text";
-        // @ts-expect-error: outdated types
+        // @ts-expect-error: previous assignment type-narrows
         target.text = data;
     }
 }

package/dist/magic/expr/text.js.map

@@ -1 +1 @@
-{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/magic/expr/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAa,MAAM,gBAAgB,CAAC;AAGxE,MAAM,OAAO,eAAgB,SAAQ,cAAoB;IAEtC,WAAW,GAC1B,2DAA2D,CAAA;IAE5C,UAAU,GAAK,MAAM,CAAA;IACrB,KAAK,GAAU,MAAM,CAAA;IACrB,YAAY,GAAG,IAAI,CAAA;IACnB,QAAQ,GAAO,WAAW,CAAC,OAAO,CAAC,MAAM,CAAA;IAElD,KAAK,CAAC,MAA8B,EAAE,IAAY;QAE1D,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC;QACrB,mCAAmC;QACnC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IACpB,CAAC;CACD"}
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/magic/expr/text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAa,MAAM,gBAAgB,CAAC;AAGxE,MAAM,OAAO,eAAgB,SAAQ,cAAoB;IAEtC,WAAW,GAC1B,2DAA2D,CAAA;IAE5C,UAAU,GAAK,MAAM,CAAA;IACrB,KAAK,GAAU,MAAM,CAAA;IACrB,YAAY,GAAG,IAAI,CAAA;IACnB,QAAQ,GAAO,WAAW,CAAC,OAAO,CAAC,MAAM,CAAA;IAElD,KAAK,CAAC,MAA8B,EAAE,IAAY;QAE1D,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC;QACrB,qDAAqD;QACrD,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;IACpB,CAAC;CACD"}

package/dist/magic/global/dark-mode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dark-mode.d.ts","sourceRoot":"","sources":["../../../src/magic/global/dark-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG1D,qBAAa,mBAAoB,SAAQ,WAAW,CAAC,MAAM,CAAC;IAE3D,SAAkB,WAAW,qEACuC;IAEpE,SAAkB,UAAU,UAAS;IAErC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU;CAM/B"}
+{"version":3,"file":"dark-mode.d.ts","sourceRoot":"","sources":["../../../src/magic/global/dark-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG1D,qBAAa,mBAAoB,SAAQ,WAAW,CAAC,MAAM,CAAC;IAE3D,SAAkB,WAAW,qEACuC;IAEpE,SAAkB,UAAU,UAAS;IAErC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU;CAI/B"}

package/dist/magic/global/dark-mode.js

@@ -3,9 +3,7 @@ export class DarkModeIncantation extends Incantation {
     description = "Enable dark mode for the calculator, which inverts all colours.";
     identifier = "dark";
     apply(target) {
-        target.updateSettings({
-            invertedColors: true,
-        });
+        target.updateSettings({ invertedColors: true });
     }
 }
 //# sourceMappingURL=dark-mode.js.map

package/dist/magic/global/dark-mode.js.map

@@ -1 +1 @@
-{"version":3,"file":"dark-mode.js","sourceRoot":"","sources":["../../../src/magic/global/dark-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAe,MAAM,gBAAgB,CAAC;AAG1D,MAAM,OAAO,mBAAoB,SAAQ,WAAmB;IAEzC,WAAW,GAC1B,iEAAiE,CAAA;IAElD,UAAU,GAAG,MAAM,CAAA;IAErC,KAAK,CAAC,MAAyB;QAE9B,MAAM,CAAC,cAAc,CAAC;YACrB,cAAc,EAAE,IAAI;SACpB,CAAC,CAAC;IACJ,CAAC;CACD"}
+{"version":3,"file":"dark-mode.js","sourceRoot":"","sources":["../../../src/magic/global/dark-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAe,MAAM,gBAAgB,CAAC;AAG1D,MAAM,OAAO,mBAAoB,SAAQ,WAAmB;IAEzC,WAAW,GAC1B,iEAAiE,CAAA;IAElD,UAAU,GAAG,MAAM,CAAA;IAErC,KAAK,CAAC,MAAyB;QAE9B,MAAM,CAAC,cAAc,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;CACD"}

package/dist/magic/global/desmos.d.ts

@@ -1,11 +1,14 @@
 import { Incantation, ArgIncantation, type GLOBAL } from "../incantation.js";
+import { type Unrecoverable } from "../../errors.js";
+import type { DesmostOptions } from "../../options.js";
 type DesmosSettings = Desmos.GraphConfiguration & Desmos.GraphSettings;
 export declare class DesmosIncantation extends ArgIncantation<GLOBAL> {
-    readonly description = "Set the configuration of the calculator via `Calculator.updateSettings()`.";
+    readonly description = "Tweak calculator settings via `Calculator.updateSettings()`.";
     readonly identifier = "desmos";
     readonly requires_arg = false;
     readonly arg_type = Incantation.ArgType.OBJECT;
     apply(target: Desmos.Calculator, data?: DesmosSettings): void;
+    evaluate_arg(raw: string, options: DesmostOptions): Unrecoverable<DesmosSettings>;
 }
 export {};
 //# sourceMappingURL=desmos.d.ts.map

package/dist/magic/global/desmos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"desmos.d.ts","sourceRoot":"","sources":["../../../src/magic/global/desmos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG1E,KAAK,cAAc,GAAG,MAAM,CAAC,kBAAkB,GAAG,MAAM,CAAC,aAAa,CAAA;AAGtE,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,MAAM,CAAC;IAE5D,SAAkB,WAAW,gFACkD;IAE/E,SAAkB,UAAU,YAAa;IACzC,SAAkB,YAAY,SAAQ;IACtC,SAAkB,QAAQ,8BAAiC;IAElD,KAAK,CACb,MAAM,EAAE,MAAM,CAAC,UAAU,EACzB,IAAI,CAAC,EAAE,cAAc,GACnB,IAAI;CAMP"}
+{"version":3,"file":"desmos.d.ts","sourceRoot":"","sources":["../../../src/magic/global/desmos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,KAAK,cAAc,GAAG,MAAM,CAAC,kBAAkB,GAAG,MAAM,CAAC,aAAa,CAAA;AAGtE,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,MAAM,CAAC;IAE5D,SAAkB,WAAW,kEACoC;IAEjE,SAAkB,UAAU,YAAa;IACzC,SAAkB,YAAY,SAAQ;IACtC,SAAkB,QAAQ,8BAAiC;IAElD,KAAK,CACb,MAAM,EAAE,MAAM,CAAC,UAAU,EACzB,IAAI,CAAC,EAAE,cAAc,GACnB,IAAI;IAOE,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,aAAa,CAAC,cAAc,CAAC;CAkB1F"}

package/dist/magic/global/desmos.js

@@ -1,6 +1,7 @@
 import { Incantation, ArgIncantation } from "../incantation.js";
+import { UnrecoverableError } from "../../errors.js";
 export class DesmosIncantation extends ArgIncantation {
-    description = "Set the configuration of the calculator via `Calculator.updateSettings()`.";
+    description = "Tweak calculator settings via `Calculator.updateSettings()`.";
     identifier = "desmos";
     requires_arg = false;
     arg_type = Incantation.ArgType.OBJECT;
@@ -9,5 +10,17 @@ export class DesmosIncantation extends ArgIncantation {
             target.updateSettings(data);
         }
     }
+    evaluate_arg(raw, options) {
+        let out = super.evaluate_arg(raw, options);
+        if (options.check_args) {
+            if (Object.keys(out).length === 0) {
+                throw new UnrecoverableError.MissingInput(`/${this.identifier} received empty settings`, {
+                    hint: `Provide settings like \`/desmos{expressionsCollapsed: true}\``,
+                    note: `Use just /desmos (without \`{}\`) if you want it as an indicator`,
+                });
+            }
+        }
+        return out;
+    }
 }
 //# sourceMappingURL=desmos.js.map

package/dist/magic/global/desmos.js.map

@@ -1 +1 @@
-{"version":3,"file":"desmos.js","sourceRoot":"","sources":["../../../src/magic/global/desmos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAe,MAAM,gBAAgB,CAAC;AAM1E,MAAM,OAAO,iBAAkB,SAAQ,cAAsB;IAE1C,WAAW,GAC1B,4EAA4E,CAAA;IAE7D,UAAU,GAAK,QAAQ,CAAA;IACvB,YAAY,GAAG,KAAK,CAAA;IACpB,QAAQ,GAAO,WAAW,CAAC,OAAO,CAAC,MAAM,CAAA;IAElD,KAAK,CACb,MAAyB,EACzB,IAAqB;QAGrB,IAAI,IAAI,IAAI,SAAS,EAAE,CAAC;YACvB,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;IACF,CAAC;CACD"}
+{"version":3,"file":"desmos.js","sourceRoot":"","sources":["../../../src/magic/global/desmos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAe,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAsB,MAAM,cAAc,CAAC;AAOtE,MAAM,OAAO,iBAAkB,SAAQ,cAAsB;IAE1C,WAAW,GAC1B,8DAA8D,CAAA;IAE/C,UAAU,GAAK,QAAQ,CAAA;IACvB,YAAY,GAAG,KAAK,CAAA;IACpB,QAAQ,GAAO,WAAW,CAAC,OAAO,CAAC,MAAM,CAAA;IAElD,KAAK,CACb,MAAyB,EACzB,IAAqB;QAGrB,IAAI,IAAI,IAAI,SAAS,EAAE,CAAC;YACvB,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;IACF,CAAC;IAEQ,YAAY,CAAC,GAAW,EAAE,OAAuB;QAEzD,IAAI,GAAG,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAmB,CAAC;QAE7D,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACxB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,kBAAkB,CAAC,YAAY,CACxC,IAAI,IAAI,CAAC,UAAU,0BAA0B,EAC7C;oBACC,IAAI,EAAE,+DAA+D;oBACrE,IAAI,EAAE,kEAAkE;iBACxE,CACD,CAAC;YACH,CAAC;QACF,CAAC;QAED,OAAO,GAAG,CAAC;IACZ,CAAC;CACD"}

package/dist/magic/global/viewport.d.ts

@@ -1,4 +1,6 @@
 import { Incantation, ArgIncantation, type GLOBAL } from "../incantation.js";
+import { type Unrecoverable } from "../../errors.js";
+import type { DesmostOptions } from "../../options.js";
 interface ViewportBounds {
     left?: number;
     right?: number;
@@ -11,6 +13,7 @@ export declare class ViewportIncantation extends ArgIncantation<GLOBAL> {
     readonly requires_arg = true;
     readonly arg_type = Incantation.ArgType.OBJECT;
     apply(target: Desmos.Calculator, data: ViewportBounds): void;
+    evaluate_arg(raw: string, options: DesmostOptions): Unrecoverable<ViewportBounds>;
 }
 export {};
 //# sourceMappingURL=viewport.d.ts.map

package/dist/magic/global/viewport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewport.d.ts","sourceRoot":"","sources":["../../../src/magic/global/viewport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG1E,UAAU,cAAc;IAEvB,IAAI,CAAC,EAAI,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAI,MAAM,CAAC;CAChC;AAGD,qBAAa,mBAAoB,SAAQ,cAAc,CAAC,MAAM,CAAC;IAE9D,SAAkB,WAAW,sEACwC;IAErE,SAAkB,UAAU,cAAe;IAC3C,SAAkB,YAAY,QAAO;IACrC,SAAkB,QAAQ,8BAAiC;IAE3D,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,cAAc;CAarD"}
+{"version":3,"file":"viewport.d.ts","sourceRoot":"","sources":["../../../src/magic/global/viewport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,UAAU,cAAc;IAEvB,IAAI,CAAC,EAAI,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAI,MAAM,CAAC;CAChC;AAKD,qBAAa,mBAAoB,SAAQ,cAAc,CAAC,MAAM,CAAC;IAE9D,SAAkB,WAAW,sEACwC;IAErE,SAAkB,UAAU,cAAe;IAC3C,SAAkB,YAAY,QAAO;IACrC,SAAkB,QAAQ,8BAAiC;IAElD,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,cAAc;IAcrD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,aAAa,CAAC,cAAc,CAAC;CAiC1F"}

package/dist/magic/global/viewport.js

@@ -1,4 +1,6 @@
 import { Incantation, ArgIncantation } from "../incantation.js";
+import { UnrecoverableError } from "../../errors.js";
+const VALID_KEYS = ["left", "right", "bottom", "top"];
 export class ViewportIncantation extends ArgIncantation {
     description = "Set the bounds of the viewport via `Calculator.setMathBounds()`.";
     identifier = "viewport";
@@ -9,5 +11,26 @@ export class ViewportIncantation extends ArgIncantation {
         let { left = existing.left, right = existing.right, bottom = existing.bottom, top = existing.top, } = data;
         target.setMathBounds({ left, right, bottom, top });
     }
+    evaluate_arg(raw, options) {
+        let out = super.evaluate_arg(raw, options);
+        if (options.check_args) {
+            if (Object.keys(out).length === 0) {
+                throw new UnrecoverableError.InvalidArgument(`/${this.identifier} received empty viewport bounds`, {
+                    hint: `Provide bounds like \`/viewport{left: -8, right: 8}\``,
+                    note: `Missing bounds are kept as their defaults`,
+                    flagged_by: "check_args",
+                });
+            }
+            let invalid_keys = Object.keys(out).filter(key => !VALID_KEYS.includes(key));
+            if (invalid_keys.length > 0) {
+                let plural = invalid_keys.length > 1 ? "fields" : "field";
+                throw new UnrecoverableError.InvalidArgument(`/${this.identifier} received invalid ${plural}: [${invalid_keys.join(", ")}]`, {
+                    hint: `Valid fields are: [${VALID_KEYS.join(", ")}]`,
+                    flagged_by: "check_args",
+                });
+            }
+        }
+        return out;
+    }
 }
 //# sourceMappingURL=viewport.js.map

package/dist/magic/global/viewport.js.map

@@ -1 +1 @@
-{"version":3,"file":"viewport.js","sourceRoot":"","sources":["../../../src/magic/global/viewport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAe,MAAM,gBAAgB,CAAC;AAU1E,MAAM,OAAO,mBAAoB,SAAQ,cAAsB;IAE5C,WAAW,GAC1B,kEAAkE,CAAA;IAEnD,UAAU,GAAK,UAAU,CAAA;IACzB,YAAY,GAAG,IAAI,CAAA;IACnB,QAAQ,GAAO,WAAW,CAAC,OAAO,CAAC,MAAM,CAAA;IAE3D,KAAK,CAAC,MAAyB,EAAE,IAAoB;QAEpD,IAAI,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CAAC,eAAe,CAAC;QAEvD,IAAI,EACH,IAAI,GAAK,QAAQ,CAAC,IAAI,EACtB,KAAK,GAAI,QAAQ,CAAC,KAAK,EACvB,MAAM,GAAG,QAAQ,CAAC,MAAM,EACxB,GAAG,GAAM,QAAQ,CAAC,GAAG,GACrB,GAAG,IAAI,CAAC;QAET,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IACpD,CAAC;CACD"}
+{"version":3,"file":"viewport.js","sourceRoot":"","sources":["../../../src/magic/global/viewport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAe,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAsB,MAAM,cAAc,CAAC;AAUtE,MAAM,UAAU,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAGtD,MAAM,OAAO,mBAAoB,SAAQ,cAAsB;IAE5C,WAAW,GAC1B,kEAAkE,CAAA;IAEnD,UAAU,GAAK,UAAU,CAAA;IACzB,YAAY,GAAG,IAAI,CAAA;IACnB,QAAQ,GAAO,WAAW,CAAC,OAAO,CAAC,MAAM,CAAA;IAElD,KAAK,CAAC,MAAyB,EAAE,IAAoB;QAE7D,IAAI,QAAQ,GAAG,MAAM,CAAC,gBAAgB,CAAC,eAAe,CAAC;QAEvD,IAAI,EACH,IAAI,GAAK,QAAQ,CAAC,IAAI,EACtB,KAAK,GAAI,QAAQ,CAAC,KAAK,EACvB,MAAM,GAAG,QAAQ,CAAC,MAAM,EACxB,GAAG,GAAM,QAAQ,CAAC,GAAG,GACrB,GAAG,IAAI,CAAC;QAET,MAAM,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IACpD,CAAC;IAEQ,YAAY,CAAC,GAAW,EAAE,OAAuB;QAEzD,IAAI,GAAG,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAmB,CAAC;QAE7D,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACxB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,kBAAkB,CAAC,eAAe,CAC3C,IAAI,IAAI,CAAC,UAAU,iCAAiC,EACpD;oBACC,IAAI,EAAE,uDAAuD;oBAC7D,IAAI,EAAE,2CAA2C;oBACjD,UAAU,EAAE,YAAY;iBACxB,CACD,CAAC;YACH,CAAC;YAED,IAAI,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YAE7E,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,IAAI,MAAM,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;gBAE1D,MAAM,IAAI,kBAAkB,CAAC,eAAe,CAC3C,IAAI,IAAI,CAAC,UAAU,qBAAqB,MAAM,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAC9E;oBACC,IAAI,EAAE,sBAAsB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;oBACpD,UAAU,EAAE,YAAY;iBACxB,CACD,CAAC;YACH,CAAC;QACF,CAAC;QAED,OAAO,GAAG,CAAC;IACZ,CAAC;CACD"}

package/dist/magic/incantation.d.ts

@@ -1,4 +1,5 @@
-import { type Unrecoverable } from "../errors.js";
+import type { DesmostOptions } from "../options.js";
+import { UnrecoverableError, type Unrecoverable } from "../errors.js";
 /**
  * An *Incantation* is like a slash command that tells Desmost to do something - like changing the properties of an expression, or applying some settings to the calculator as a whole.
  *
@@ -40,9 +41,19 @@ export declare abstract class ArgIncantation<Effect extends Incantation.Effect =
      * ## Notes
      *
      * Child incantation classes should override this method, though the defaults should cover most cases (except `ArgType.ENUM`).
+     *
+     * Validity checks for missing or invalid values, incorrect types, and unknown fields should be performed here, so that `.apply()` can assume the data it receives is guaranteed to be valid.
      */
-    evaluate_arg(raw: string): Unrecoverable<unknown>;
+    evaluate_arg(raw: string, options: DesmostOptions): Unrecoverable<unknown>;
+    protected require_nonempty(arg: object, msg?: string, info?: UnrecoverableError.Info): Unrecoverable<void>;
+    protected require_known(arg: object, valid_fields: string[], info?: UnrecoverableError.Info): Unrecoverable<void>;
 }
+/** An incantation that affects the entire Desmos calculator state, like `/desmos` or `/viewport`. */
+export type GLOBAL = Incantation.Effect.GLOBAL;
+/** An incantation that affects only the expression immediately following it, like `/hide` or `/slider`. */
+export type LOCAL = Incantation.Effect.LOCAL;
+/** An incantation that produces an expression, like `/latex` or `/text`. */
+export type EXPR = Incantation.Effect.EXPR;
 export declare namespace Incantation {
     /** The kind of effect an incantation produces - it either modifies only one block, or modifies the calculator as a whole. */
     enum Effect {
@@ -65,10 +76,4 @@ export declare namespace Incantation {
         OBJECT = "Object"
     }
 }
-/** An incantation that affects the entire Desmos calculator state, like `/desmos` or `/viewport`. */
-export type GLOBAL = Incantation.Effect.GLOBAL;
-/** An incantation that affects only the expression immediately following it, like `/hide` or `/slider`. */
-export type LOCAL = Incantation.Effect.LOCAL;
-/** An incantation that produces an expression, like `/latex` or `/text`. */
-export type EXPR = Incantation.Effect.EXPR;
 //# sourceMappingURL=incantation.d.ts.map

package/dist/magic/incantation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"incantation.d.ts","sourceRoot":"","sources":["../../src/magic/incantation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAGnE;;;;;;;;;;;;GAYG;AACH,8BAAsB,WAAW,CAChC,MAAM,SAAS,WAAW,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM;IAGtD,kEAAkE;IAClE,kBAAyB,WAAW,EAAE,MAAM,CAAA;IAE5C,2FAA2F;IAC3F,kBAAyB,UAAU,EAAE,MAAM,CAAA;IAE3C,6EAA6E;IAC7E,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAA;IAG9B,0FAA0F;aAC1E,KAAK,CACpB,MAAM,EAAE,MAAM,SAAS,MAAM,GAAG,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,eAAe,EAC1E,IAAI,CAAC,EAAE,OAAO,GACZ,IAAI;IAEP,4EAA4E;IAC5E,SAAS,CAAC,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,EACnE,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,CAAC,GACT,OAAO,CAAC,MAAM,IAAI,CAAC;CAStB;AAGD;;GAEG;AACH,8BAAsB,cAAc,CACnC,MAAM,SAAS,WAAW,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAEtD,SAAQ,WAAW,CAAC,MAAM,CAAC;IAE3B,qEAAqE;IACrE,SAAgB,YAAY,EAAE,OAAO,CAAO;IAE5C,0DAA0D;IAC1D,kBAAyB,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAA;IAGtD;;;;;;;;OAQG;IACI,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC;CAkBxD;AAGD,yBAAiB,WAAW,CAC5B;IACC,6HAA6H;IAC7H,KAAY,MAAM;QAEjB,qGAAqG;QACrG,MAAM,IAAA;QAEN,2GAA2G;QAC3G,KAAK,IAAA;QAEL,4EAA4E;QAC5E,IAAI,IAAA;KACJ;IAED,mFAAmF;IACnF,KAAY,OAAO;QAElB,yHAAyH;QACzH,MAAM,WAAW;QAEjB,qDAAqD;QACrD,KAAK,UAAU;QAEf,uGAAuG;QACvG,IAAI,SAAS;QAEb,oHAAoH;QACpH,MAAM,WAAW;KACjB;CACD;AAKD,qGAAqG;AACrG,MAAM,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC;AAE/C,2GAA2G;AAC3G,MAAM,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;AAE7C,4EAA4E;AAC5E,MAAM,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC"}
+{"version":3,"file":"incantation.d.ts","sourceRoot":"","sources":["../../src/magic/incantation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAGnE;;;;;;;;;;;;GAYG;AACH,8BAAsB,WAAW,CAChC,MAAM,SAAS,WAAW,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM;IAGtD,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAErC,2FAA2F;IAC3F,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAEpC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IAGvB,0FAA0F;IAC1F,QAAQ,CAAC,KAAK,CACb,MAAM,EAAE,MAAM,SAAS,MAAM,GAAG,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,eAAe,EAC1E,IAAI,CAAC,EAAE,OAAO,GACZ,IAAI;IAEP,4EAA4E;IAC5E,SAAS,CAAC,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,EACnE,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,CAAC,GACT,OAAO,CAAC,MAAM,IAAI,CAAC;CAStB;AAGD;;GAEG;AACH,8BAAsB,cAAc,CACnC,MAAM,SAAS,WAAW,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAEtD,SAAQ,WAAW,CAAC,MAAM,CAAC;IAE3B,qEAAqE;IACrE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAO;IAErC,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAA;IAG/C;;;;;;;;;;OAUG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,aAAa,CAAC,OAAO,CAAC;IAqB1E,SAAS,CAAC,gBAAgB,CACzB,GAAG,EAAE,MAAM,EACX,GAAG,CAAC,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,kBAAkB,CAAC,IAAI,GAC5B,aAAa,CAAC,IAAI,CAAC;IAUtB,SAAS,CAAC,aAAa,CACtB,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EAAE,EACtB,IAAI,CAAC,EAAE,kBAAkB,CAAC,IAAI,GAC5B,aAAa,CAAC,IAAI,CAAC;CAetB;AAGD,qGAAqG;AACrG,MAAM,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC;AAE/C,2GAA2G;AAC3G,MAAM,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;AAE7C,4EAA4E;AAC5E,MAAM,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC;AAG3C,yBAAiB,WAAW,CAC5B;IACC,6HAA6H;IAC7H,KAAY,MAAM;QAEjB,qGAAqG;QACrG,MAAM,IAAA;QAEN,2GAA2G;QAC3G,KAAK,IAAA;QAEL,4EAA4E;QAC5E,IAAI,IAAA;KACJ;IAED,mFAAmF;IACnF,KAAY,OAAO;QAElB,yHAAyH;QACzH,MAAM,WAAW;QAEjB,qDAAqD;QACrD,KAAK,UAAU;QAEf,uGAAuG;QACvG,IAAI,SAAS;QAEb,oHAAoH;QACpH,MAAM,WAAW;KACjB;CACD"}

package/dist/magic/incantation.js

@@ -1,4 +1,5 @@
 import Json5 from "json5";
+import dedent from "dedent";
 import { UnrecoverableError } from "../errors.js";
 /**
  * An *Incantation* is like a slash command that tells Desmost to do something - like changing the properties of an expression, or applying some settings to the calculator as a whole.
@@ -19,7 +20,7 @@ export class Incantation {
     /** Error if the `actual` type of the given expression is not `required`. */
     require_expr_type(actual, required) {
         if ((actual ?? "expression") !== required) {
-            throw new UnrecoverableError.IllegalIncantation(`/${this.identifier} can only applied to ${required === "expression" ? "latex" : required} expressions, but target block has type: ${actual}`);
+            throw new UnrecoverableError.IllegalIncantation(`/${this.identifier} can only applied to ${required === "expression" ? "latex" : required} blocks, but target block has type: ${actual}`);
         }
     }
 }
@@ -37,12 +38,15 @@ export class ArgIncantation extends Incantation {
      * ## Notes
      *
      * Child incantation classes should override this method, though the defaults should cover most cases (except `ArgType.ENUM`).
+     *
+     * Validity checks for missing or invalid values, incorrect types, and unknown fields should be performed here, so that `.apply()` can assume the data it receives is guaranteed to be valid.
      */
-    evaluate_arg(raw) {
+    evaluate_arg(raw, options) {
         switch (this.arg_type) {
-            case Incantation.ArgType.STRING: return raw;
             case Incantation.ArgType.LATEX: return raw;
             case Incantation.ArgType.ENUM: return raw;
+            case Incantation.ArgType.STRING:
+                return (options.dedent_text) ? dedent(raw) : raw.trim();
             case Incantation.ArgType.OBJECT: {
                 try {
                     return Json5.parse(`{${raw}}`);
@@ -54,6 +58,22 @@ export class ArgIncantation extends Incantation {
             }
         }
     }
+    require_nonempty(arg, msg, info) {
+        if (Object.entries(arg).length === 0) {
+            throw new UnrecoverableError.MissingInput(msg ?? `/${this.identifier} received an empty argument {}`, info);
+        }
+    }
+    require_known(arg, valid_fields, info) {
+        // TODO accumulate
+        for (let field of Object.keys(arg)) {
+            if (!valid_fields.includes(field)) {
+                throw new UnrecoverableError.InvalidArgument(`/${this.identifier} received invalid field: ${field}`, {
+                    hint: `Valid fields are [${valid_fields.join(", ")}]`,
+                    ...info,
+                });
+            }
+        }
+    }
 }
 (function (Incantation) {
     /** The kind of effect an incantation produces - it either modifies only one block, or modifies the calculator as a whole. */

package/dist/magic/incantation.js.map

@@ -1 +1 @@
-{"version":3,"file":"incantation.js","sourceRoot":"","sources":["../../src/magic/incantation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,kBAAkB,EAAsB,MAAM,WAAW,CAAC;AAGnE;;;;;;;;;;;;GAYG;AACH,MAAM,OAAgB,WAAW;IAUhC,6EAA6E;IAC7D,KAAK,CAAS;IAS9B,4EAA4E;IAClE,iBAAiB,CAC1B,MAAe,EACf,QAAW;QAGX,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC,KAAK,QAAQ,EACzC,CAAC;YACA,MAAM,IAAI,kBAAkB,CAAC,kBAAkB,CAC9C,IAAI,IAAI,CAAC,UAAU,wBAAwB,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,4CAA4C,MAAM,EAAE,CAC7I,CAAC;QACH,CAAC;IACF,CAAC;CACD;AAGD;;GAEG;AACH,MAAM,OAAgB,cAGrB,SAAQ,WAAmB;IAE3B,qEAAqE;IACrD,YAAY,GAAY,IAAI,CAAA;IAM5C;;;;;;;;OAQG;IACI,YAAY,CAAC,GAAW;QAE9B,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvB,KAAK,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,GAAG,CAAC;YAC5C,KAAK,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAE,OAAO,GAAG,CAAC;YAC5C,KAAK,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAG,OAAO,GAAG,CAAC;YAE5C,KAAK,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;gBACjC,IAAI,CAAC;oBACJ,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;gBAChC,CAAC;gBACD,OAAO,CAAC,EAAE,CAAC;oBACV,yBAAyB;oBACzB,MAAM,IAAI,kBAAkB,CAAC,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBACzD,CAAC;YACF,CAAC;QACF,CAAC;IACF,CAAC;CACD;AAGD,WAAiB,WAAW;IAE3B,6HAA6H;IAC7H,IAAY,MAUX;IAVD,WAAY,MAAM;QAEjB,qGAAqG;QACrG,uCAAM,CAAA;QAEN,2GAA2G;QAC3G,qCAAK,CAAA;QAEL,4EAA4E;QAC5E,mCAAI,CAAA;IACL,CAAC,EAVW,MAAM,GAAN,kBAAM,KAAN,kBAAM,QAUjB;IAED,mFAAmF;IACnF,IAAY,OAaX;IAbD,WAAY,OAAO;QAElB,yHAAyH;QACzH,4BAAiB,CAAA;QAEjB,qDAAqD;QACrD,0BAAe,CAAA;QAEf,uGAAuG;QACvG,wBAAa,CAAA;QAEb,oHAAoH;QACpH,4BAAiB,CAAA;IAClB,CAAC,EAbW,OAAO,GAAP,mBAAO,KAAP,mBAAO,QAalB;AACF,CAAC,EA9BgB,WAAW,KAAX,WAAW,QA8B3B"}
+{"version":3,"file":"incantation.js","sourceRoot":"","sources":["../../src/magic/incantation.ts"],"names":[],"mappings":"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"}

package/dist/magic/local/anim.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anim.d.ts","sourceRoot":"","sources":["../../../src/magic/local/anim.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGzD,qBAAa,eAAgB,SAAQ,WAAW,CAAC,KAAK,CAAC;IAEtD,SAAkB,WAAW,oCACM;IAEnC,SAAkB,UAAU,UAAS;IAE5B,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe;CAM7C"}
+{"version":3,"file":"anim.d.ts","sourceRoot":"","sources":["../../../src/magic/local/anim.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGzD,qBAAa,eAAgB,SAAQ,WAAW,CAAC,KAAK,CAAC;IAEtD,SAAkB,WAAW,oCACM;IAEnC,SAAkB,UAAU,UAAS;IAE5B,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe;CAK7C"}

package/dist/magic/local/anim.js

@@ -4,7 +4,6 @@ export class AnimIncantation extends Incantation {
     identifier = "anim";
     apply(target) {
         super.require_expr_type(target.type, "expression");
-        // @ts-expect-error: outdated types
         target.playing = true;
     }
 }

package/dist/magic/local/anim.js.map

@@ -1 +1 @@
-{"version":3,"file":"anim.js","sourceRoot":"","sources":["../../../src/magic/local/anim.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,gBAAgB,CAAC;AAGzD,MAAM,OAAO,eAAgB,SAAQ,WAAkB;IAEpC,WAAW,GAC1B,gCAAgC,CAAA;IAEjB,UAAU,GAAG,MAAM,CAAA;IAE5B,KAAK,CAAC,MAA8B;QAE5C,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACnD,mCAAmC;QACnC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACvB,CAAC;CACD"}
+{"version":3,"file":"anim.js","sourceRoot":"","sources":["../../../src/magic/local/anim.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,gBAAgB,CAAC;AAGzD,MAAM,OAAO,eAAgB,SAAQ,WAAkB;IAEpC,WAAW,GAC1B,gCAAgC,CAAA;IAEjB,UAAU,GAAG,MAAM,CAAA;IAE5B,KAAK,CAAC,MAA8B;QAE5C,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;IACvB,CAAC;CACD"}

package/dist/magic/local/colour.d.ts

@@ -1,12 +1,13 @@
 import { Incantation, ArgIncantation, type LOCAL } from "../incantation.js";
 import { DesmosColour } from "../../desmos.js";
+import type { DesmostOptions } from "../../options.js";
 export declare class ColourIncantation extends ArgIncantation<LOCAL> {
-    readonly description = "";
+    readonly description = "Change the colour of a rendered expression, such as a line, region, polygon, etc.";
     readonly identifier = "color";
     readonly alias = "colour";
     readonly requires_arg = true;
     readonly arg_type = Incantation.ArgType.ENUM;
     apply(target: Desmos.ExpressionState, data: DesmosColour): void;
-    evaluate_arg(data: string): DesmosColour;
+    evaluate_arg(data: string, options: DesmostOptions): DesmosColour;
 }
 //# sourceMappingURL=colour.d.ts.map

package/dist/magic/local/colour.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"colour.d.ts","sourceRoot":"","sources":["../../../src/magic/local/colour.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGzE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,KAAK,CAAC;IAE3D,SAAkB,WAAW,MACxB;IAEL,SAAkB,UAAU,WAAY;IACxC,SAAkB,KAAK,YAAkB;IACzC,SAAkB,YAAY,QAAO;IACrC,SAAkB,QAAQ,4BAA+B;IAEhD,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,YAAY;IAMxD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;CAejD"}
+{"version":3,"file":"colour.d.ts","sourceRoot":"","sources":["../../../src/magic/local/colour.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,qBAAa,iBAAkB,SAAQ,cAAc,CAAC,KAAK,CAAC;IAE3D,SAAkB,WAAW,uFACyD;IAEtF,SAAkB,UAAU,WAAY;IACxC,SAAkB,KAAK,YAAkB;IACzC,SAAkB,YAAY,QAAO;IACrC,SAAkB,QAAQ,4BAA+B;IAEhD,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,YAAY;IAMxD,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,YAAY;CAe1E"}

package/dist/magic/local/colour.js

@@ -1,8 +1,8 @@
 import { Incantation, ArgIncantation } from "../incantation.js";
-import { UnrecoverableError } from "../../errors.js";
 import { DesmosColour } from "../../desmos.js";
+import { UnrecoverableError } from "../../errors.js";
 export class ColourIncantation extends ArgIncantation {
-    description = "";
+    description = "Change the colour of a rendered expression, such as a line, region, polygon, etc.";
     identifier = "color";
     alias = "colour";
     requires_arg = true;
@@ -11,7 +11,7 @@ export class ColourIncantation extends ArgIncantation {
         super.require_expr_type(target.type, "expression");
         target.color = data;
     }
-    evaluate_arg(data) {
+    evaluate_arg(data, options) {
         switch (data.trim().toUpperCase()) {
             case "RED": return DesmosColour.RED;
             case "BLUE": return DesmosColour.BLUE;

package/dist/magic/local/colour.js.map

@@ -1 +1 @@
-{"version":3,"file":"colour.js","sourceRoot":"","sources":["../../../src/magic/local/colour.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAc,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,MAAM,OAAO,iBAAkB,SAAQ,cAAqB;IAEzC,WAAW,GAC1B,EAAE,CAAA;IAEa,UAAU,GAAK,OAAO,CAAA;IACtB,KAAK,GAAU,QAAQ,CAAA;IACvB,YAAY,GAAG,IAAI,CAAA;IACnB,QAAQ,GAAO,WAAW,CAAC,OAAO,CAAC,IAAI,CAAA;IAEhD,KAAK,CAAC,MAA8B,EAAE,IAAkB;QAEhE,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;IACrB,CAAC;IAEQ,YAAY,CAAC,IAAY;QAEjC,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;YACnC,KAAK,KAAK,CAAC,CAAI,OAAO,YAAY,CAAC,GAAG,CAAC;YACvC,KAAK,MAAM,CAAC,CAAG,OAAO,YAAY,CAAC,IAAI,CAAC;YACxC,KAAK,OAAO,CAAC,CAAE,OAAO,YAAY,CAAC,KAAK,CAAC;YACzC,KAAK,QAAQ,CAAC,CAAC,OAAO,YAAY,CAAC,MAAM,CAAC;YAC1C,KAAK,QAAQ,CAAC,CAAC,OAAO,YAAY,CAAC,MAAM,CAAC;YAC1C,KAAK,OAAO,CAAC,CAAE,OAAO,YAAY,CAAC,KAAK,CAAC;YACzC;gBACC,MAAM,IAAI,kBAAkB,CAC3B,qBAAqB,IAAI,IAAI,CAC7B,CAAC;QACJ,CAAC;IACF,CAAC;CACD"}
+{"version":3,"file":"colour.js","sourceRoot":"","sources":["../../../src/magic/local/colour.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAc,MAAM,gBAAgB,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAIlD,MAAM,OAAO,iBAAkB,SAAQ,cAAqB;IAEzC,WAAW,GAC1B,mFAAmF,CAAA;IAEpE,UAAU,GAAK,OAAO,CAAA;IACtB,KAAK,GAAU,QAAQ,CAAA;IACvB,YAAY,GAAG,IAAI,CAAA;IACnB,QAAQ,GAAO,WAAW,CAAC,OAAO,CAAC,IAAI,CAAA;IAEhD,KAAK,CAAC,MAA8B,EAAE,IAAkB;QAEhE,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;IACrB,CAAC;IAEQ,YAAY,CAAC,IAAY,EAAE,OAAuB;QAE1D,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;YACnC,KAAK,KAAK,CAAC,CAAI,OAAO,YAAY,CAAC,GAAG,CAAC;YACvC,KAAK,MAAM,CAAC,CAAG,OAAO,YAAY,CAAC,IAAI,CAAC;YACxC,KAAK,OAAO,CAAC,CAAE,OAAO,YAAY,CAAC,KAAK,CAAC;YACzC,KAAK,QAAQ,CAAC,CAAC,OAAO,YAAY,CAAC,MAAM,CAAC;YAC1C,KAAK,QAAQ,CAAC,CAAC,OAAO,YAAY,CAAC,MAAM,CAAC;YAC1C,KAAK,OAAO,CAAC,CAAE,OAAO,YAAY,CAAC,KAAK,CAAC;YACzC;gBACC,MAAM,IAAI,kBAAkB,CAC3B,qBAAqB,IAAI,IAAI,CAC7B,CAAC;QACJ,CAAC;IACF,CAAC;CACD"}

package/dist/magic/local/label.d.ts

@@ -1,4 +1,5 @@
 import { Incantation, ArgIncantation, type LOCAL } from "../incantation.js";
+import type { DesmostOptions } from "../../options.js";
 interface LabelOptions {
     text: string;
     show?: boolean;
@@ -11,7 +12,7 @@ export declare class LabelIncantation extends ArgIncantation<LOCAL> {
     readonly requires_arg = true;
     readonly arg_type = Incantation.ArgType.OBJECT;
     apply(target: Desmos.ExpressionState, data: LabelOptions): void;
-    evaluate_arg(raw: string): LabelOptions;
+    evaluate_arg(raw: string, options: DesmostOptions): LabelOptions;
 }
 export {};
 //# sourceMappingURL=label.d.ts.map

package/dist/magic/local/label.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../../../src/magic/local/label.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGzE,UAAU,YAAY;IAErB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,OAAO,MAAM,CAAC,UAAU,CAAC;IAC/C,GAAG,CAAC,EAAE,MAAM,OAAO,MAAM,CAAC,iBAAiB,CAAC;CAC5C;AAGD,qBAAa,gBAAiB,SAAQ,cAAc,CAAC,KAAK,CAAC;IAE1D,SAAkB,WAAW,iDACmB;IAEhD,SAAkB,UAAU,WAAY;IACxC,SAAkB,YAAY,QAAO;IACrC,SAAkB,QAAQ,8BAAiC;IAElD,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,YAAY;IAUxD,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY;CA8BhD"}
+{"version":3,"file":"label.d.ts","sourceRoot":"","sources":["../../../src/magic/local/label.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,UAAU,YAAY;IAErB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,OAAO,MAAM,CAAC,UAAU,CAAC;IAC/C,GAAG,CAAC,EAAE,MAAM,OAAO,MAAM,CAAC,iBAAiB,CAAC;CAC5C;AAUD,qBAAa,gBAAiB,SAAQ,cAAc,CAAC,KAAK,CAAC;IAE1D,SAAkB,WAAW,iDACmB;IAEhD,SAAkB,UAAU,WAAY;IACxC,SAAkB,YAAY,QAAO;IACrC,SAAkB,QAAQ,8BAAiC;IAElD,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,YAAY;IAUxD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,YAAY;CAkDzE"}

package/dist/magic/local/label.js

@@ -1,5 +1,10 @@
-import { UnrecoverableError } from "../../errors.js";
 import { Incantation, ArgIncantation } from "../incantation.js";
+import { UnrecoverableError } from "../../errors.js";
+const VALID_FIELDS = ["text", "show", "size", "pos"];
+const VALID_POSITIONS = [
+    "ABOVE", "BELOW", "LEFT", "RIGHT",
+    "ABOVE_LEFT", "ABOVE_RIGHT", "BELOW_LEFT", "BELOW_RIGHT",
+];
 export class LabelIncantation extends ArgIncantation {
     description = "Label a block that evaluates to a point(s).";
     identifier = "label";
@@ -9,28 +14,43 @@ export class LabelIncantation extends ArgIncantation {
         super.require_expr_type(target.type, "expression");
         target.label = data.text;
         target.showLabel = data.show ?? true;
-        // @ts-expect-error: outdated types TODO check
+        // @ts-expect-error: outdated types
         if (data.size != undefined)
             target.labelSize = data.size;
         if (data.pos != undefined)
             target.labelOrientation = data.pos;
     }
-    evaluate_arg(raw) {
-        let out = super.evaluate_arg(raw);
-        if (!("text" in out)) {
-            throw new UnrecoverableError.InvalidArgument(`/label requires a \`text\` argument, such as: \`/label{ text: "sup world!" }\``);
+    evaluate_arg(raw, options) {
+        let out = super.evaluate_arg(raw, options);
+        if (options.check_args) {
+            super.require_nonempty(out, `/label received empty argument`, {
+                hint: `You can provide [${VALID_FIELDS.join(", ")}]`,
+                flagged_by: "check_args",
+            });
+            if (!("text" in out)) {
+                throw new UnrecoverableError.MissingInput(`/label is missing label text`, {
+                    hint: `Provide text for the label: \`/label{text: "sup world!"}\``,
+                    flagged_by: "check_args",
+                });
+            }
+            super.require_known(out, VALID_FIELDS);
         }
         if (typeof out.pos != "undefined") {
-            let pos = out.pos.trim().toUpperCase();
-            switch (pos) {
-                case "ABOVE":
-                case "BELOW":
-                case "LEFT":
-                case "RIGHT":
-                    out.pos = pos;
-                    break;
-                default:
-                    throw new UnrecoverableError.InvalidArgument(`/label: Invalid label position: ${pos}`);
+            let pos = out.pos.trim().toUpperCase().replaceAll("-", "_");
+            if (VALID_POSITIONS.includes(pos)) {
+                // @ts-expect-error: validated
+                out.pos = pos;
+            }
+            else {
+                // @ts-expect-error: indexing
+                let orientation = Desmos.LabelOrientations[pos];
+                if (options.check_args && orientation == undefined) {
+                    throw new UnrecoverableError.InvalidArgument(`/label received invalid label position: ${pos}`, {
+                        hint: `Valid label positions are ${VALID_POSITIONS.join(", ")}`,
+                        flagged_by: "check_args"
+                    });
+                }
+                out.pos = orientation;
             }
         }
         return out;

package/dist/magic/local/label.js.map

@@ -1 +1 @@
-{"version":3,"file":"label.js","sourceRoot":"","sources":["../../../src/magic/local/label.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAc,MAAM,gBAAgB,CAAC;AAYzE,MAAM,OAAO,gBAAiB,SAAQ,cAAqB;IAExC,WAAW,GAC1B,6CAA6C,CAAA;IAE9B,UAAU,GAAK,OAAO,CAAA;IACtB,YAAY,GAAG,IAAI,CAAA;IACnB,QAAQ,GAAO,WAAW,CAAC,OAAO,CAAC,MAAM,CAAA;IAElD,KAAK,CAAC,MAA8B,EAAE,IAAkB;QAEhE,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACnD,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC;QACzB,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;QACrC,8CAA8C;QAC9C,IAAI,IAAI,CAAC,IAAI,IAAI,SAAS;YAAE,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC;QACzD,IAAI,IAAI,CAAC,GAAG,IAAK,SAAS;YAAE,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC;IAChE,CAAC;IAEQ,YAAY,CAAC,GAAW;QAEhC,IAAI,GAAG,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,CAAiB,CAAC;QAElD,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,kBAAkB,CAAC,eAAe,CAC3C,gFAAgF,CAChF,CAAC;QACH,CAAC;QAED,IAAI,OAAO,GAAG,CAAC,GAAG,IAAI,WAAW,EAAE,CAAC;YACnC,IAAI,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAEvC,QAAQ,GAAG,EAAE,CAAC;gBACb,KAAK,OAAO,CAAC;gBACb,KAAK,OAAO,CAAC;gBACb,KAAK,MAAM,CAAC;gBACZ,KAAK,OAAO;oBACX,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC;oBACd,MAAM;gBAEP;oBACC,MAAM,IAAI,kBAAkB,CAAC,eAAe,CAC3C,mCAAmC,GAAG,EAAE,CACxC,CAAC;YACJ,CAAC;QACF,CAAC;QAED,OAAO,GAAG,CAAC;IACZ,CAAC;CACD"}
+{"version":3,"file":"label.js","sourceRoot":"","sources":["../../../src/magic/local/label.ts"],"names":[],"mappings":"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"}

package/dist/magic/local/line.d.ts

@@ -1,4 +1,6 @@
 import { Incantation, ArgIncantation, type LOCAL } from "../incantation.js";
+import type { DesmostOptions } from "../../options.js";
+import { type Unrecoverable } from "../../errors.js";
 interface LineOptions {
     style?: keyof typeof Desmos.Styles;
     width?: number;
@@ -10,6 +12,7 @@ export declare class LineIncantation extends ArgIncantation<LOCAL> {
     readonly requires_arg = true;
     readonly arg_type = Incantation.ArgType.OBJECT;
     apply(target: Desmos.ExpressionState, data: LineOptions): void;
+    evaluate_arg(raw: string, options: DesmostOptions): Unrecoverable<LineOptions>;
 }
 export {};
 //# sourceMappingURL=line.d.ts.map

package/dist/magic/local/line.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"line.d.ts","sourceRoot":"","sources":["../../../src/magic/local/line.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAGzE,UAAU,WAAW;IAEpB,KAAK,CAAC,EAAI,MAAM,OAAO,MAAM,CAAC,MAAM,CAAC;IACrC,KAAK,CAAC,EAAI,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAGD,qBAAa,eAAgB,SAAQ,cAAc,CAAC,KAAK,CAAC;IAEzD,SAAkB,WAAW,8CACgB;IAE7C,SAAkB,UAAU,UAAW;IACvC,SAAkB,YAAY,QAAO;IACrC,SAAkB,QAAQ,8BAAiC;IAElD,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,WAAW;CAQhE"}
+{"version":3,"file":"line.d.ts","sourceRoot":"","sources":["../../../src/magic/local/line.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,UAAU,WAAW;IAEpB,KAAK,CAAC,EAAI,MAAM,OAAO,MAAM,CAAC,MAAM,CAAC;IACrC,KAAK,CAAC,EAAI,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAKD,qBAAa,eAAgB,SAAQ,cAAc,CAAC,KAAK,CAAC;IAEzD,SAAkB,WAAW,8CACgB;IAE7C,SAAkB,UAAU,UAAW;IACvC,SAAkB,YAAY,QAAO;IACrC,SAAkB,QAAQ,8BAAiC;IAElD,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,eAAe,EAAE,IAAI,EAAE,WAAW;IASvD,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,aAAa,CAAC,WAAW,CAAC;CAWvF"}