kei-lisp-plugin-graphics 1.1.0 → 3.0.0

package/dist/index.d.ts

@@ -5,23 +5,17 @@ import { Cons, InterpretedSymbol, KeiLispPlugin, LispValue, PluginContext } from
  * @class
  * @classdesc Canvas2D drawing plugin for the kei-lisp interpreter. Implements
  *            the `KeiLispPlugin` contract (`name` / `has` / `apply`) and
- *            exposes 45 `g…` Lisp functions that proxy to a 2D rendering
+ *            exposes 75 `g…` Lisp functions that proxy to a 2D rendering
  *            context.
  * @author Keisuke Ikeda
- * @this {GraphicsPlugin}
  */
-declare class GraphicsPlugin extends Object implements KeiLispPlugin {
+declare class GraphicsPlugin implements KeiLispPlugin {
   #private;
   /**
-   * Dispatch map from a Lisp function name (InterpretedSymbol) to the name of
-   * the GraphicsPlugin method that implements it.
+   * Lists every Lisp function name this plugin registers.
+   * @return the sorted `g…` function names
    */
-  static readonly buildInFunctions: Map<InterpretedSymbol, string>;
-  /**
-   * Builds the dispatch table.
-   * @return the dispatch table
-   */
-  static setup(): Map<InterpretedSymbol, string>;
+  static functionNames(): string[];
   /**
    * Plugin identifier, used for diagnostics.
    */
@@ -49,28 +43,10 @@ declare class GraphicsPlugin extends Object implements KeiLispPlugin {
    * @return the method's result, or `Cons.nil` if dispatch fails
    */
   apply(aSymbol: InterpretedSymbol, arguments_: Cons, _context: PluginContext): LispValue;
-  /**
-   * Resolves the procedure name and invokes the matching method.
-   * @param procedure - the Lisp symbol
-   * @param arguments_ - the evaluated argument list
-   * @return the method's result, or `Cons.nil` if not registered
-   */
-  selectProcedure(procedure: InterpretedSymbol, arguments_: Cons): LispValue;
-  /**
-   * Looks up and invokes the JS method that implements the given Lisp symbol.
-   * Throws `TypeError` when the dispatch table points to a method that does
-   * not exist on the instance — this matches the legacy behavior, where the
-   * Ramda `R.invoker(1, methodName)(args, this)` call would surface the same
-   * error by attempting to call `undefined`.
-   * @param procedure - the Lisp symbol
-   * @param arguments_ - the evaluated argument list
-   * @return the method's result
-   */
-  buildInFunction(procedure: InterpretedSymbol, arguments_: Cons): LispValue;
   /**
    * Checks whether the canvas exposes a usable 2D context, and narrows
    * `this.ctx` to non-null for the caller when it returns true.
-   * @return type predicate — true when ctx is non-null
+   * @return type predicate — true when context is non-null
    */
   checkSupport(): this is GraphicsPlugin & {
     ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D;
@@ -79,7 +55,7 @@ declare class GraphicsPlugin extends Object implements KeiLispPlugin {
   gArc(arguments_: Cons): LispValue;
   gArcTo(arguments_: Cons): LispValue;
   gBezCurveTo(arguments_: Cons): LispValue;
-  gClear(): LispValue;
+  gClear(arguments_: Cons): LispValue;
   gClose(): LispValue;
   gColor(arguments_: Cons): LispValue;
   gFill(): LispValue;
@@ -97,8 +73,18 @@ declare class GraphicsPlugin extends Object implements KeiLispPlugin {
   gOpen(): LispValue;
   gPattern(arguments_: Cons): LispValue;
   gQuadCurveTo(arguments_: Cons): LispValue;
-  gSaveJpeg(): LispValue;
-  gSavePng(): LispValue;
+  gSaveJpeg(arguments_: Cons): LispValue;
+  gSavePng(arguments_: Cons): LispValue;
+  /**
+   * Shared implementation of `gsave-jpeg` / `gsave-png`. With no argument it
+   * triggers a browser download; with a single string argument it writes the
+   * encoded image to that file path on Node.js.
+   * @param arguments_ - the evaluated argument list (empty, or one path string)
+   * @param mimeType - the image MIME type to encode
+   * @param label - the format name used in diagnostics ("jpeg" / "png")
+   * @return `t` on success, `Cons.nil` otherwise
+   */
+  saveCanvas(arguments_: Cons, mimeType: string, label: string): LispValue;
   gScale(arguments_: Cons): LispValue;
   gShadowBlur(arguments_: Cons): LispValue;
   gShadowColor(arguments_: Cons): LispValue;
@@ -121,7 +107,7 @@ declare class GraphicsPlugin extends Object implements KeiLispPlugin {
   /**
    * Pushes the current drawing state (styles, transform, clip) onto the
    * context's state stack. Pairs with `gRestore` to let Lisp callers manage
-   * state explicitly. Replaces the legacy per-method `ctx.save()` calls, which
+   * state explicitly. Replaces the legacy per-method `context.save()` calls, which
    * pushed state on every draw with no matching `restore()` and grew the stack
    * unbounded.
    * @return `t` on success, `Cons.nil` otherwise
@@ -133,6 +119,36 @@ declare class GraphicsPlugin extends Object implements KeiLispPlugin {
    * @return `t` on success, `Cons.nil` otherwise
    */
   gRestore(): LispValue;
+  gEllipse(arguments_: Cons): LispValue;
+  gRoundRect(arguments_: Cons): LispValue;
+  gLineDash(arguments_: Cons): LispValue;
+  gLineDashOffset(arguments_: Cons): LispValue;
+  gMiterLimit(arguments_: Cons): LispValue;
+  gClip(): LispValue;
+  gIsPointInPath(arguments_: Cons): LispValue;
+  gIsPointInStroke(arguments_: Cons): LispValue;
+  gTransform(arguments_: Cons): LispValue;
+  gSetTransform(arguments_: Cons): LispValue;
+  gResetTransform(): LispValue;
+  gComposite(arguments_: Cons): LispValue;
+  gFilter(arguments_: Cons): LispValue;
+  gImageSmoothing(arguments_: Cons): LispValue;
+  gMeasureText(arguments_: Cons): LispValue;
+  gLetterSpacing(arguments_: Cons): LispValue;
+  gWordSpacing(arguments_: Cons): LispValue;
+  gFontKerning(arguments_: Cons): LispValue;
+  gFontStretch(arguments_: Cons): LispValue;
+  gFontVariant(arguments_: Cons): LispValue;
+  gTextRendering(arguments_: Cons): LispValue;
+  gClearRect(arguments_: Cons): LispValue;
+  gReset(): LispValue;
+  gWidth(): LispValue;
+  gHeight(): LispValue;
+  gPixel(arguments_: Cons): LispValue;
+  gSetPixel(arguments_: Cons): LispValue;
+  gLinearGradient(arguments_: Cons): LispValue;
+  gRadialGradient(arguments_: Cons): LispValue;
+  gConicGradient(arguments_: Cons): LispValue;
   /**
    * Parses a color spec from the head of the argument Cons. Accepts
    * (1 string), (3 numbers — rgb), or (4 numbers — rgba); falls back to