merpeeps-pack-c4 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Merpeeps contributors
+
+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,62 @@
+# merpeeps-pack-c4
+
+The Merpeeps C4 model stencil pack, distributed as **YAML data only**.
+Includes nine stencils for people, software and external systems, containers,
+components, databases, web browsers, mobile apps, and message buses.
+
+## Install and read
+
+```bash
+npm install merpeeps-pack-c4
+```
+
+From a Node.js ES module:
+
+```js
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const yaml = readFileSync(require.resolve('merpeeps-pack-c4'), 'utf8');
+```
+
+The explicit data path `merpeeps-pack-c4/c4.merpeeps-pack.yml` resolves to the
+same file. Pass the text to your host application's YAML parser and compatible
+Merpeeps pack loader. This package does not include a parser or runtime
+dependencies. Do not import or require the YAML directly as JavaScript;
+`require.resolve` locates the data without executing it.
+
+## Contents and scope
+
+The tarball contains only:
+
+- `c4.merpeeps-pack.yml`
+- `LICENSE`
+- `README.md`
+- `package.json`
+
+The YAML defines stencil labels, text, shapes, core icon references, fill and
+stroke defaults, and hints. External systems use grey styling. It does not
+contain custom icon geometry or new artwork. Your host supplies shape
+rendering and implementations of the referenced core icons; this package
+supplies neither a renderer nor glyph implementations.
+
+Installing with npm only makes the data available to your project. It does
+not automatically install anything into the Merpeeps desktop app or register
+a Mermaid plugin. The desktop already embeds this same default pack.
+The separate `merpeeps-mermaid-layout` package provides layout functionality,
+not an automatic installation mechanism for this pack.
+
+## Source and publishing
+
+The canonical source is
+[`src/Merpeeps.Core/Packs/c4.merpeeps-pack.yml`](https://github.com/sargemonkey/merpeeps/blob/main/src/Merpeeps.Core/Packs/c4.merpeeps-pack.yml).
+From the repository, `npm pack` and `npm publish` run `prepack` to copy that
+file and the root MIT license into this package. Edit the canonical YAML, not
+the generated package copy. Installing the resulting tarball needs no
+repository checkout, build, or install lifecycle script.
+
+See the [pack usage guide](https://github.com/sargemonkey/merpeeps/blob/main/docs/GUIDE.md#stencil-packs)
+and the [manual publishing checklist](https://github.com/sargemonkey/merpeeps/blob/main/docs/PUBLISHING.md).
+
+MIT licensed — see [LICENSE](./LICENSE).

package/c4.merpeeps-pack.yml

@@ -0,0 +1,79 @@
+id: c4
+name: C4 model
+spec: 1
+licence: MIT
+url: https://c4model.com
+
+# C4 distinguishes people, systems, containers and components. The convention
+# that external things are grey is carried in the fills below.
+stencils:
+  - label: Person
+    text: User
+    shape: Stadium
+    icon: user
+    fill: "#DAE8FC"
+    stroke: "#6C8EBF"
+    hint: A human actor
+
+  - label: Software system
+    text: System
+    shape: RoundedRect
+    fill: "#DAE8FC"
+    stroke: "#6C8EBF"
+    hint: A whole system you own
+
+  - label: External system
+    text: External system
+    shape: RoundedRect
+    icon: cloud
+    fill: "#F5F5F5"
+    stroke: "#666666"
+    hint: A system someone else owns
+
+  - label: Container
+    text: Web Application
+    shape: RoundedRect
+    icon: server
+    fill: "#D5E8D4"
+    stroke: "#82B366"
+    hint: A deployable — app, service, function
+
+  - label: Component
+    text: Controller
+    shape: Rectangle
+    icon: cog
+    fill: "#D5E8D4"
+    stroke: "#82B366"
+    hint: A grouping inside a container
+
+  - label: Database
+    text: Database
+    shape: Cylinder
+    icon: database
+    fill: "#F8CECC"
+    stroke: "#B85450"
+    hint: A datastore container
+
+  - label: Web browser
+    text: Single-Page App
+    shape: RoundedRect
+    icon: browser
+    fill: "#DAE8FC"
+    stroke: "#6C8EBF"
+    hint: A browser-delivered container
+
+  - label: Mobile app
+    text: Mobile App
+    shape: RoundedRect
+    icon: mobile
+    fill: "#DAE8FC"
+    stroke: "#6C8EBF"
+    hint: A phone or tablet container
+
+  - label: Message bus
+    text: Event Bus
+    shape: Subroutine
+    icon: queue
+    fill: "#FFF2CC"
+    stroke: "#D6B656"
+    hint: Asynchronous transport between containers

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "merpeeps-pack-c4",
+  "version": "0.1.0",
+  "description": "Data-only Merpeeps C4 model stencil pack for people, software systems, containers, and components.",
+  "keywords": [
+    "merpeeps",
+    "mermaid",
+    "c4",
+    "c4-model",
+    "software-architecture",
+    "diagram",
+    "stencils",
+    "yaml",
+    "data-only"
+  ],
+  "license": "MIT",
+  "author": "Merpeeps contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sargemonkey/merpeeps.git",
+    "directory": "packages/merpeeps-pack-c4"
+  },
+  "homepage": "https://github.com/sargemonkey/merpeeps/blob/main/docs/GUIDE.md#stencil-packs",
+  "bugs": {
+    "url": "https://github.com/sargemonkey/merpeeps/issues"
+  },
+  "main": "./c4.merpeeps-pack.yml",
+  "exports": {
+    ".": "./c4.merpeeps-pack.yml",
+    "./c4.merpeeps-pack.yml": "./c4.merpeeps-pack.yml"
+  },
+  "files": [
+    "c4.merpeeps-pack.yml",
+    "LICENSE",
+    "README.md",
+    "package.json"
+  ],
+  "scripts": {
+    "prepack": "node ../../scripts/prepare-domain-pack.mjs c4",
+    "release:check": "node ../../oracle/package-consumer-test.mjs merpeeps-pack-c4",
+    "prepublishOnly": "npm run release:check"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}