Merge pull request 'v0.3.0: updates, left-to-right bits and "Loading" manual section' (#7) from dev into main

Reviewed-on: #7

CHANGELOG.md

@@ -1,11 +1,5 @@
 # Changelog
 
-## [v0.3.1] - 2026-06-14
-- Support for non-consecutive ranges ([#13](https://git.kb28.ch/HEL/rivet-typst/pulls/13))
-- Prevent drawing separators on starting lines of fields ([#17](https://git.kb28.ch/HEL/rivet-typst/pulls/17))
-- Fix end line on non-consecutive ranges ending at the highest bit not being draw ([#18](https://git.kb28.ch/HEL/rivet-typst/pulls/18))
-- Add documentation for `start` property of structures ([61f13df815f](https://git.kb28.ch/HEL/rivet-typst/commit/6f13df815f99fd6be8b6b3a02b4d53bcc8fe0aff))
-
 ## [v0.3.0] - 2025-05-03
 - updated CeTZ to 0.3.4
 - updated to Typst 0.13.1

README.md

@@ -9,7 +9,7 @@ It is based on the [homonymous Python script](https://git.kb28.ch/HEL/rivet/)
   <tr>
     <td>
       <a href="./gallery/example1.typ">
-        <img src="./gallery/example1.png" width="1000px" alt="A black on white diagram showing the bit structure of a machine instruction, detailing operands, flags and selectors.">
+        <img src="./gallery/example1.png" width="1000px">
       </a>
     </td>
   </tr>
@@ -19,7 +19,7 @@ It is based on the [homonymous Python script](https://git.kb28.ch/HEL/rivet/)
   <tr>
     <td>
       <a href="./gallery/example2.typ">
-        <img src="./gallery/example2.png" width="1000px" alt="A white on blue diagram showing the bit structure of RISC-V memory instructions, detailing operands, flags and selectors.">
+        <img src="./gallery/example2.png" width="1000px">
       </a>
     </td>
   </tr>
@@ -35,7 +35,7 @@ For more information, see the [manual](manual.pdf)
 
 To use this package, simply import `schema` from [rivet](https://typst.app/universe/package/rivet) and call `schema.load` to parse a schema description. Then use `schema.render` to render it, et voilà !
 ```typ
-#import "@preview/rivet:0.3.1": schema
+#import "@preview/rivet:0.3.0": schema
-#let doc = schema.load(yaml("path/to/schema.yaml"))
+#let doc = schema.load("path/to/schema.yaml")
 #schema.render(doc)
 ```

gallery/example1.typ

@@ -1,6 +1,6 @@
-#import "@preview/rivet:0.3.1": schema, config
+#import "../src/lib.typ": schema, config
 
-#let example = schema.load(yaml("./example1.yaml"))
+#let example = schema.load("/gallery/example1.yaml")
 #schema.render(example, config: config.config(
   full-page: true
 ))

gallery/example2.typ

@@ -1,6 +1,6 @@
-#import "@preview/rivet:0.3.1": schema, config
+#import "../src/lib.typ": schema, config
 
-#let example = schema.load(yaml("./example2.yaml"))
+#let example = schema.load("/gallery/example2.yaml")
 #schema.render(example, config: config.blueprint(
   full-page: true,
   left-labels: true

gallery/example3.typ

@@ -1,6 +1,6 @@
-#import "@preview/rivet:0.3.1": schema, config
+#import "../src/lib.typ": schema, config
 
-#let example = schema.load(yaml("/gallery/example1.yaml"))
+#let example = schema.load("/gallery/example1.yaml")
 //#schema.render(example)
 
 = Chapter 1

gallery/riscv/riscv.typ

@@ -1,14 +1,14 @@
-#import "@preview/rivet:0.3.1": *
+#import "../../src/lib.typ": *
 
 #let conf = config.config(
   full-page: true,
   left-labels: true
 )
-#let alu = schema.load(yaml("./alu_instr.yaml"))
+#let alu = schema.load("/gallery/riscv/alu_instr.yaml")
 #schema.render(alu, config: conf)
 
-#let branch = schema.load(yaml("./branch_instr.yaml"))
+#let branch = schema.load("/gallery/riscv/branch_instr.yaml")
 #schema.render(branch, config: conf)
 
-#let mem = schema.load(yaml("./mem_instr.yaml"))
+#let mem = schema.load("/gallery/riscv/mem_instr.yaml")
 #schema.render(mem, config: conf)

gallery/test.typ

@@ -1,17 +1,16 @@
-#import "@preview/rivet:0.3.1": *
+#import "../src/lib.typ": *
 
-#let test-yaml = schema.load(yaml("./test.yaml"))
+#let test-yaml = schema.load("/gallery/test.yaml")
 #schema.render(test-yaml, config: config.config(
   full-page: true
 ))
 
-#let test-json = schema.load(json("./test.json"))
+#let test-json = schema.load("/gallery/test.json")
 #schema.render(test-json, config: config.blueprint(
   full-page: true
 ))
 
-#let test-xml-raw = schema.xml-loader.parse(xml("./test.xml").first())
+#let test-xml = schema.load("/gallery/test.xml")
-#let test-xml = schema.load(test-xml-raw)
 #schema.render(test-xml, config: config.dark(
   full-page: true
 ))

manual.typ

@@ -105,7 +105,7 @@ Since the XML format is quite different from the other, you might find it helpfu
 
 A schema contains a dictionary of structures. There must be at least one defined structure named "main".
 
-It can also optionally contain a "colors" dictionary. More details about this in #link(<format-colors>)[Colors]
+It can also optionnaly contain a "colors" dictionary. More details about this in #link(<format-colors>)[Colors]
 
 ```json
 {
@@ -152,34 +152,6 @@ The range name (or key) defines the left- and rightmost bits (e.g. `7-4` goes fr
 }
 ```
 
-=== Start <format-start>
-
-By default, structures start at bit 0, but you may want to number bits from 1, or another arbitrary value. To do this, you can set the `start` property of a structure to the desired start value. For example,
-
-```json
-"main": {
-  "bits": 8,
-  "start": 4,
-  "ranges": {
-    "11-7": { ... },
-    "6-4": { ... }
-  }
-}
-```
-
-#let start-schema = (structures: (main: (bits: 8, start: 4, ranges: ("11-7": (name: ""), "6-4": (name: "")))))
-
-would render as
-
-#align(
-  center,
-  schema.render(
-    schema.load(start-schema),
-    width: 50%
-  )
-)
-
-
 == Range <format-range>
 
 A range represents a group of consecutive bits. It can have a name (displayed in the bit cells), a description (displayed under the structure) and / or values.
@@ -363,7 +335,7 @@ structures:
 #let x = schema.xml-loader.load("schema.xml")
 #let s = schema.load(x)
 // From file
-#let x = schema.xml-loader.parse(xml("schema.xml").first())
+#let x = schema.xml-loader.parse(yaml("schema.yaml").first())
 #let s = schema.load(x)
 // Raw block
 #let s = schema.load(```xml

src/lib.typ

@@ -1,4 +1,4 @@
-#let version = version(0,3,1)
+#let version = version(0,3,0)
 
 #import "config.typ"
 #import "schema.typ"

src/renderer.typ

@@ -387,10 +387,8 @@
   }
   let range-boundaries = ()
   for r in struct.ranges.values() {
-    let start-i = to-real-i(if config.ltr-bits {r.start} else {r.end})
+    let i = to-real-i(if config.ltr-bits {r.start} else {r.end})
-    let end-i = to-real-i(if config.ltr-bits {r.end} else {r.start}) + 1
+    range-boundaries.push(i)
-    range-boundaries.push(start-i)
-    range-boundaries.push(end-i)
   }
 
   // Draw colors
@@ -409,11 +407,6 @@
       indices.push(r.start)
       indices.push(r.end)
     }
-    // ensure first and last bits are included
-    if not indices.contains(0) { indices.insert(0, struct.start) }
-    if not indices.contains(struct.bits + struct.start - 1) {
-      indices.push(struct.bits + struct.start - 1)
-    }
   }
 
   for i in range(struct.bits) {
@@ -460,9 +453,8 @@
   let desc-y = bits-y + bit-h * 2
 
   // Names + simple descriptions
-  for (i, range_) in ranges.enumerate() {
+  for range_ in ranges {
     let start-i = to-real-i(if config.ltr-bits {range_.start} else {range_.end})
-    let end-i = to-real-i(if config.ltr-bits {range_.end} else {range_.start})
     let start-x = bits-x + start-i * bit-w
     let width = rng.bits(range_) * bit-w
 
@@ -472,28 +464,6 @@
     let line-x = if config.ltr-bits {start-x + width} else {start-x}
     shapes += draw-line(border-col, (line-x, bits-y), (line-x, bits-y + bit-h))
     shapes += draw-text(range_.name, txt-col, name-x, name-y, fill: bg-col)
-
-    // paint end line only if needed
-    let is-not-limit = if config.ltr-bits { start-i != 0 } else { end-i != struct.bits - 1 }
-    if (
-        is-not-limit
-        and ranges
-          .at(
-            i
-              + {
-                if config.ltr-bits and i < ranges.len() - 1 { 1 } else { -1 }
-              },
-          )
-          .end
-          != range_.start - 1
-    ) {
-      line-x += if config.ltr-bits { -width } else { width }
-      shapes += draw-line(
-        border-col,
-        (line-x, bits-y),
-        (line-x, bits-y + bit-h),
-      )
-    }
     
     if range_.description != "" {
       let shapes_
@@ -598,4 +568,4 @@
     config: config,
     render: render.with(config)
   )
-}
+}

src/xml-loader.typ

@@ -76,9 +76,8 @@
   }
 
   return (
-    bits: int(elmt.attrs.bits),
+    bits: elmt.attrs.bits,
-    ranges: ranges,
+    ranges: ranges
-    start: elmt.attrs.at("start", default: 0)
   )
 }
 

typst.toml

@@ -1,6 +1,6 @@
 [package]
 name = "rivet"
-version = "0.3.1"
+version = "0.3.0"
 compiler = "0.13.1"
 repository = "https://git.kb28.ch/HEL/rivet-typst"
 entrypoint = "src/lib.typ"
@@ -9,6 +9,6 @@ authors = [
 ]
 categories = [ "visualization" ]
 license = "Apache-2.0"
-description = "Register / Instruction Visualizer & Explainer Tool, using CeTZ"
+description = "Register / Instruction Visualizer & Explainer Tool with Typst, using CeTZ"
 keywords = [ "assembly", "instruction", "binary" ]
 exclude = [ "gallery", "justfile", "docs" ]