@woosh/meep-engine 3.16.0 → 3.17.0

package/src/shade/renderer/particles/isa/particle_assembly.d.ts

@@ -71,12 +71,13 @@ export function assemble_particle_program(text: string): ParticleProgram;
  * .init                         ; section — everything until the next section directive
  *   LOAD_BUILTIN.3 r0, EMITTER_POSITION
  *   RANDOM.2 r1
- *   SCALE.2 r1, r1, r2
+ *   MUL.2 r1, r1, #0.5          ; a literal where a register could stand
  *   STORE_ATTR r1, @1, 3        ; store r1 into the 3-component attribute at record word 1
  *
  * .update
  *   LOAD_ATTR.1 r0, @7, 1
  *   CMP_GE.1 r0, r0, r1
+ *   MOV.3 r2, r0.xxx            ; a register read through a swizzle: lane 0 three times
  *   KILL r0
  * ```
  *
@@ -91,16 +92,24 @@ export function assemble_particle_program(text: string): ParticleProgram;
  *
  * | role | spelling | example |
  * |---|---|---|
- * | register / destination | `r<slot>` | `r3` |
+ * | destination | `r<slot>` | `r3` |
+ * | register source | `r<slot>`, optionally `.<selectors>` | `r3`, `r3.yyy`, `r0.zyx` |
+ * | literal source | `#<float>` | `#1.5` |
  * | constant-pool word | `c<word>` | `c0` |
  * | attribute word offset | `@<word>` | `@7` |
  * | attribute component count | a bare integer `1..4` | `3` |
  * | builtin | a {@link VM_BUILTIN} name | `EMITTER_POSITION` |
  * | curve handle | `k<handle>` | `k2` |
- * | swizzle pattern | `.<four of xyzw>` | `.xxyz` |
  *
- * `STORE_ATTR` and `KILL` carry a *source* register in the destination slot — the ISA's own
- * encoding, spelled here the way it is encoded rather than reordered to read like a store.
+ * A register source's selectors say which lane of the value each lane of the instruction reads, one
+ * letter of `xyzw` per lane the instruction spans; left off, lane `c` reads lane `c`. A literal is
+ * the same value in every lane. The destination is only ever a plain register.
+ *
+ * ## What older text still means
+ *
+ * Two mnemonics that were opcodes are now spellings of an operand, and documents that carry them read
+ * as the instruction they meant: `SWIZZLE.n rd, rs, .xyzw` is `MOV.n rd, rs.xyzw`, and `SCALE.n rd,
+ * rv, rs` is `MUL.n rd, rv, rs.xxxx`. The disassembler never writes either.
  */
 /** Section directive introducing the INIT stream. @type {string} */
 export const PARTICLE_ASSEMBLY_SECTION_INIT: string;
@@ -110,11 +119,11 @@ export const PARTICLE_ASSEMBLY_SECTION_UPDATE: string;
 export const PARTICLE_ASSEMBLY_DIRECTIVE_REGISTERS: string;
 /** Directive declaring one constant-pool entry. @type {string} */
 export const PARTICLE_ASSEMBLY_DIRECTIVE_CONST: string;
+/** Opens a literal in a register slot: `#1.5`. @type {string} */
+export const PARTICLE_ASSEMBLY_IMMEDIATE_PREFIX: string;
 /**
- * Separates a mnemonic from the lane count it spans: `ADD.3`.
- *
- * The same character opens a directive and a swizzle pattern, but never in this position — a line
- * starts with either a directive or a mnemonic, and a swizzle is an operand.
+ * Separates a mnemonic from the lane count it spans: `ADD.3`. Also separates a register from its
+ * selectors: `r3.yyy`. The same character opens a directive, but never in either of those positions.
  *
  * @type {string}
  */
@@ -127,9 +136,6 @@ export const PARTICLE_ASSEMBLY_WIDTH_SEPARATOR: string;
  * a bound the parser tries to allocate that pool and takes the page with it, which is a worse answer
  * to a typo than a marker on the line.
  *
- * Generous against any real program: an effect's constants are its literals, and the whole
- * instruction budget is {@link PARTICLE_VM_MAX_INSTRUCTIONS} per section.
- *
  * @type {number}
  */
 export const PARTICLE_ASSEMBLY_MAX_CONSTANTS: number;
@@ -145,5 +151,23 @@ export type ParticleAssemblyDiagnostic = {
     line: number;
     message: string;
 };
+export type ParsedOperand = {
+    /**
+     * a {@link VM_KIND }: `REG` or `IMM` for a register-role slot, `NONE` for any other
+     */
+    kind: number;
+    /**
+     * the operand word
+     */
+    word: number;
+    /**
+     * for a register written with selectors, how many the text spelled
+     */
+    selectors?: number;
+    /**
+     * the text the operand was read from, for messages
+     */
+    token?: string;
+};
 import { ParticleProgram } from "./ParticleProgram.js";
 //# sourceMappingURL=particle_assembly.d.ts.map

package/src/shade/renderer/particles/isa/particle_assembly.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"particle_assembly.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/particles/isa/particle_assembly.js"],"names":[],"mappings":"AAkJA;;;;;;;;GAQG;AAEH;;;;;;;;;;;GAWG;AACH,sDALW,eAAe;IAEE,MAAM,GAAvB,MAAM;IACJ,MAAM,CAmClB;AAwID;;;;;;;;;;;GAWG;AACH,8CAHW,MAAM;aACM,eAAe,GAAC,IAAI;iBAAe,0BAA0B,EAAE;EA8IrF;AAED;;;;;;;;GAQG;AACH,gDAJW,MAAM,GACJ,eAAe,CAkB3B;AA9eD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,oEAAoE;AACpE,6CAD0D,MAAM,CACV;AAEtD,sEAAsE;AACtE,+CAD4D,MAAM,CACR;AAE1D,+DAA+D;AAC/D,oDADqD,MAAM,CACO;AAElE,kEAAkE;AAClE,gDADwD,MAAM,CACJ;AAE1D;;;;;;;GAOG;AACH,gDAFU,MAAM,CAEqC;AAErD;;;;;;;;;;;;GAYG;AACH,8CAFU,MAAM,CAEoC;;;;;;;;;;UAyCtC,MAAM;aACN,MAAM;;gCAnJY,sBAAsB"}
+{"version":3,"file":"particle_assembly.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/particles/isa/particle_assembly.js"],"names":[],"mappings":"AA0KA;;;;;;;;GAQG;AAMH;;;;;;;;;;;GAWG;AACH,sDALW,eAAe;IAEE,MAAM,GAAvB,MAAM;IACJ,MAAM,CAmClB;AA0JD;;;;;;;;;;;GAWG;AACH,8CAHW,MAAM;aACM,eAAe,GAAC,IAAI;iBAAe,0BAA0B,EAAE;EA8IrF;AAED;;;;;;;;GAQG;AACH,gDAJW,MAAM,GACJ,eAAe,CAkB3B;AAjhBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AAEH,oEAAoE;AACpE,6CAD0D,MAAM,CACV;AAEtD,sEAAsE;AACtE,+CAD4D,MAAM,CACR;AAE1D,+DAA+D;AAC/D,oDADqD,MAAM,CACO;AAElE,kEAAkE;AAClE,gDADwD,MAAM,CACJ;AAE1D,iEAAiE;AACjE,iDADuD,MAAM,CACP;AAEtD;;;;;GAKG;AACH,gDAFU,MAAM,CAEqC;AAErD;;;;;;;;;GASG;AACH,8CAFU,MAAM,CAEoC;;;;;;;;;;UA+CtC,MAAM;aACN,MAAM;;;;;;UA+hBN,MAAM;;;;UACN,MAAM;;;;gBACN,MAAM;;;;YACN,MAAM;;gCA7sBY,sBAAsB"}