@driftsys/markspec 0.0.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 driftsys
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,110 @@
+# MarkSpec
+
+[![CI](https://github.com/driftsys/markspec/actions/workflows/ci.yaml/badge.svg)](https://github.com/driftsys/markspec/actions/workflows/ci.yaml)
+[![JSR](https://jsr.io/badges/@driftsys/markspec)](https://jsr.io/@driftsys/markspec)
+[![npm](https://img.shields.io/npm/v/@driftsys/markspec)](https://www.npmjs.com/package/@driftsys/markspec)
+[![Docs](https://img.shields.io/badge/docs-driftsys.github.io%2Fmarkspec-blue)](https://driftsys.github.io/markspec/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+A Markdown flavor for traceable industrial documentation, and a CLI toolchain
+that processes it.
+
+> Early development. The [language specification](docs/spec/language.md) is
+> stable. Tooling is not yet functional.
+
+## Tools
+
+```text
+markspec format          # stamp ULIDs, normalize attributes
+markspec validate        # check broken refs, missing Ids
+markspec compile <paths> # build traceability graph → JSON
+markspec export          # JSON → csv, reqif, yaml
+markspec insert          # scaffold requirement block
+
+markspec doc build       # document PDF
+markspec book build      # PDF + HTML book
+markspec book dev        # live preview
+markspec deck build      # presentation PDF
+markspec deck dev        # live preview
+
+markspec lsp             # LSP server
+markspec mcp             # MCP server
+```
+
+## Modules
+
+```text
+core/      ← parser, validator, compiler, reporter, formatter
+render/    ← Typst WASM, Mustache substitution, captions
+book/      ← multi-file PDF + HTML book builder
+deck/      ← Touying-based slide deck builder
+cli/       ← subcommand handlers
+lsp/       ← LSP server
+mcp/       ← MCP server
+```
+
+One binary. One install. Three rendering targets (document, book, deck).
+
+## Markdown extensions
+
+MarkSpec extends CommonMark with constructs that render as plain Markdown on
+GitHub and GitLab — no tooling required to read.
+
+**Entry blocks** — a list item with a typed ID and an indented body:
+
+```markdown
+- [SRS_BRK_0001] Sensor input debouncing
+
+  The sensor driver shall debounce raw inputs to eliminate electrical noise
+  before processing.
+
+  Id: SRS_01HGW2Q8MNP3\
+  Satisfies: SYS_BRK_0042\
+  Labels: ASIL-B
+```
+
+**Table captions** — emphasized paragraph above a pipe table:
+
+```markdown
+_Table: Sensor thresholds_
+
+| Sensor   | Min | Max  |
+| -------- | --- | ---- |
+| Pressure | 0   | 1023 |
+```
+
+**Figure captions** — emphasized paragraph below an image:
+
+```markdown
+![System overview](overview.svg)
+
+_Figure: High-level architecture of the braking system_
+```
+
+**In-code entries** — requirements in doc comments, same format:
+
+```rust
+/// [SRS_BRK_0001] Sensor input debouncing
+///
+/// The sensor driver shall reject transient noise shorter
+/// than the configured debounce window.
+///
+/// Id: SRS_01HGW2Q8MNP3 \
+/// Satisfies: SYS_BRK_0042 \
+/// Labels: ASIL-B
+#[test]
+fn swt_brk_0001_debounce_filters_noise() {
+    // test implementation
+}
+```
+
+**Mustache variables** — `{{project.name}}` substitution from `project.yaml`,
+resolved at build time.
+
+## License
+
+[MIT](LICENSE)
+
+---
+
+Part of the [DriftSys](https://github.com/driftsys) ecosystem.

package/esm/mod.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @module core
+ *
+ * Core library for MarkSpec — parser, validator, ID graph,
+ * traceability, and all output formats (JSON, ReqIF, CSV, PDF).
+ *
+ * This is the library boundary. Everything outside core/ imports
+ * from core/mod.ts, never from internal paths.
+ */
+export declare const VERSION = "0.0.1";
+//# sourceMappingURL=mod.d.ts.map

package/esm/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/esm/mod.js

@@ -0,0 +1,10 @@
+/**
+ * @module core
+ *
+ * Core library for MarkSpec — parser, validator, ID graph,
+ * traceability, and all output formats (JSON, ReqIF, CSV, PDF).
+ *
+ * This is the library boundary. Everything outside core/ imports
+ * from core/mod.ts, never from internal paths.
+ */
+export const VERSION = "0.0.1";

package/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@driftsys/markspec",
+  "version": "0.0.3",
+  "description": "Markdown flavor and toolchain for traceable industrial documentation",
+  "keywords": [
+    "markdown",
+    "requirements",
+    "traceability",
+    "iso-26262",
+    "aspice",
+    "documentation"
+  ],
+  "homepage": "https://driftsys.github.io/markspec/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/driftsys/markspec.git"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/driftsys/markspec/issues"
+  },
+  "main": "./script/mod.js",
+  "module": "./esm/mod.js",
+  "exports": {
+    ".": {
+      "import": "./esm/mod.js",
+      "require": "./script/mod.js"
+    }
+  },
+  "scripts": {},
+  "_generatedBy": "dnt@dev"
+}

package/script/mod.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @module core
+ *
+ * Core library for MarkSpec — parser, validator, ID graph,
+ * traceability, and all output formats (JSON, ReqIF, CSV, PDF).
+ *
+ * This is the library boundary. Everything outside core/ imports
+ * from core/mod.ts, never from internal paths.
+ */
+export declare const VERSION = "0.0.1";
+//# sourceMappingURL=mod.d.ts.map

package/script/mod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../src/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/script/mod.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * @module core
+ *
+ * Core library for MarkSpec — parser, validator, ID graph,
+ * traceability, and all output formats (JSON, ReqIF, CSV, PDF).
+ *
+ * This is the library boundary. Everything outside core/ imports
+ * from core/mod.ts, never from internal paths.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = void 0;
+exports.VERSION = "0.0.1";

package/script/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}