base-node (.bn) v0.13.1

Base Node (.bn) Versioning & Evolution Specification

This document defines the versioning scheme, stability guarantees, and lifecycle management for the Base Node (.bn) ecosystem: the language grammar, the standard library (stdlib/), the targets, and the reference implementations (Python, Rust, Blender extension).

---

1. The Four Versioning Tiers#

The .bn ecosystem separates concerns across four distinct tiers:

┌────────────────────────────────────────────────────────┐
│ Tier 1: Language Edition (Syntax & Grammar)            │
│         e.g., Edition 2026                             │
└──────────────────────────┬─────────────────────────────┘
                           │
┌──────────────────────────▼─────────────────────────────┐
│ Tier 2: Targets (what each destination accepts)        │
│         e.g., blender-geometry, gltf, blade            │
└──────────────────────────┬─────────────────────────────┘
                           │
┌──────────────────────────▼─────────────────────────────┐
│ Tier 3: Standard Library Modules (stdlib/)             │
│         e.g., math@0.13.1, curves2d@0.13.1                  │
│         Manifest: stdlib/manifest.json                 │
└──────────────────────────┬─────────────────────────────┘
                           │
┌──────────────────────────▼─────────────────────────────┐
│ Tier 4: Toolchain & Reference Packages                 │
│         Python: base-node 0.13.1                        │
│         Rust:   base-node 0.13.1                        │
│         Blender Extension: 0.13.1                       │
└────────────────────────────────────────────────────────┘

---

2. Tier 1: Language Edition (edition)#

To balance rapid language innovation with long-term code preservation, .bn uses Language Editions (inspired by Rust and WGSL epochs):

Source Annotation (Pragma)#

Source files can optionally declare their target edition in the file header:

// @edition 2026

When omitted, the compiler defaults to the latest stable edition supported by the runtime.

---

3. Tier 2: Targets (targets/)#

A target is what one destination accepts: one file per destination, targets/<name>.json, and no target defined from another. Its fields and the way a text is checked against it are in targets.

---

4. Tier 3: Standard Library (stdlib/)#

The standard library modules provide reusable computational geometry, math, and stylization functions.

The manifest: stdlib/manifest.json and the heads of the modules#

[stdlib/manifest.json](../stdlib/manifest.json) holds what is the library's:

{
  "stdlib_version": "0.13.1",
  "edition": "2026",
  "description": "Standard Library for the Base Node (.bn) language"
}

Each module says the rest in the head of its .bn (below), so that adding a module adds its file and edits no shared list. base_node.manifest.manifest("stdlib") reads them into one manifest, the modules by name:

"curves2d": {
  "name": "curves2d",
  "version": "0.13.1",
  "edition": "2026",
  "tier": "free",
  "targets": ["blender-geometry", "blender-gp"],
  "file": "curves2d.bn",
  "dependencies": ["math"],
  "description": "2D curves, resampling, curvature analysis, and path operations"
}

tier is free or pro. A free module is in this repository under MIT OR Apache-2.0 and uses free modules only. A pro module belongs to a paid pack (// @pack smart-materials, "pack" in its entry), installed in the Module Folder of the add-on preferences; it may use free modules. Its dependencies are the modules its use lines name.

Module Header Metadata#

Every official .bn standard library file must include standardized metadata comments before its use imports:

// Base Node Standard Library — Module curves2d
// @module curves2d
// @version 0.13.1
// @target blender-geometry, blender-gp
// @edition 2026
// @description 2D curves, resampling, curvature analysis, and path operations

use math (bump, fbm)
...

---

5. Lifecycle & Stability Policy (Pre-LTS vs LTS)#

Phase 1: Pre-LTS (0.x.y) — Active Rapid Iteration#

Phase 2: Long-Term Support (1.0.0 LTS)#

---

6. Tier 4: Toolchain & Implementation Synchronicity#

All tools and packages maintained within the repository share a synchronized version number:

ComponentPathVersion Scheme
Python reference package[python/pyproject.toml](file:///home/marcgardent/base-node-language/python/pyproject.toml)SemVer (0.13.1)
Rust WASM crate[rust/Cargo.toml](file:///home/marcgardent/base-node-language/rust/Cargo.toml)SemVer (0.13.1)
Blender Extension[base-node-for-blender/blender_manifest.toml](file:///home/marcgardent/base-node-language/base-node-for-blender/blender_manifest.toml)SemVer (0.13.1)
Extension Repository Index[site/extensions/index.json](file:///home/marcgardent/base-node-language/site/extensions/index.json)SemVer (0.13.1)

CLI Version Reporting#

Running base-node --version reports:

base-node 0.13.1 (Language Edition 2026, Stdlib 0.13.1)