Invisra / printspec

← All docsView source on GitHub

printspec v0.1.0 release notes draft

printspec v0.1.0 is the first experimental public release of Invisra’s JSON Schema and offline tooling stack for practical parametric 3D-printable parts.

Highlights

  • JSON Schemas for practical parametric part definitions.
  • Offline TypeScript and Python validation using bundled schemas.
  • Static hosted schema references at https://schemas.invisra.ai/printspec/0.1.0/.
  • CLI commands for validation, source generation, BOM output, browser form metadata, part-family listing, and bundle export.
  • Starter OpenSCAD and CadQuery source generators for supported part families.
  • Deterministic project/part bundle export with manifest, README, generated source, BOM files when applicable, and optional experimental PartCAD stub metadata.
  • Browser/editor metadata helpers for rendering schema-driven parameter forms.

Installed packages status

The npm package name is @invisra/printspec and the Python package name is printspec. Only claim registry availability after the package has actually been published to npm/PyPI. Before publication, use the repository checkout instructions in the README.

Hosted schemas

  • Base index: https://schemas.invisra.ai/
  • Project index: https://schemas.invisra.ai/printspec/
  • v0.1.0 index: https://schemas.invisra.ai/printspec/0.1.0/
  • Root schema: https://schemas.invisra.ai/printspec/0.1.0/printspec.schema.json
  • Version manifest: https://schemas.invisra.ai/printspec/0.1.0/manifest.json

Validators use bundled schemas offline; hosted schema URLs are references for documentation and external tooling.

CLI examples

printspec validate examples/part-families/rounded-rectangular-plate.basic.json
printspec list-part-families
printspec form-metadata rounded_rectangular_plate
printspec bom examples/projects/simple-enclosure-project.json --format markdown
printspec to-openscad examples/part-families/round-spacer.basic.json --output round-spacer.scad
printspec to-cadquery examples/part-families/electronics-standoff.m3.json --output standoff.py

Supported generators

v0.1.0 includes starter OpenSCAD and CadQuery source generators for:

  • rounded_rectangular_plate
  • spacer_block
  • round_spacer
  • electronics_standoff

Bundle export

printspec bundle examples/part-families/rounded-rectangular-plate.basic.json --output bundle --overwrite

Bundles are deterministic source bundles. They do not include STL, STEP, or 3MF outputs and do not execute CAD tools.

Known limitations

  • No STL, STEP, or 3MF export.
  • No CAD execution.
  • Limited generator coverage.
  • Composable/project schemas are early.
  • Warning expressions are documentation-only.
  • PartCAD support is a stub/experimental metadata export, not full PartCAD integration.

Safety and non-goals

printspec is experimental and does not provide certified engineering validation. Review generated source, dimensions, tolerances, materials, printer settings, and mechanical suitability before printing or use. Do not use generated designs without appropriate review for safety-critical, load-bearing, medical, electrical, regulated, or production applications.

  • README: README.md
  • Release process: docs/release-process.md
  • Hosted schemas: docs/hosted-schemas.md
  • Bundle docs: docs/bundles.md
  • Browser/editor metadata: docs/form-metadata.md
  • Safety: docs/safety.md
  • Changelog: CHANGELOG.md