merpeeps-pack-architecture 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,64 @@
+# merpeeps-pack-architecture
+
+The Merpeeps Architecture stencil pack, distributed as **YAML data only**.
+Includes 12 stencils for services, API gateways, databases, caches, queues,
+object storage, functions, authentication, web and mobile clients, cloud
+providers, and workers.
+
+## Install and read
+
+```bash
+npm install merpeeps-pack-architecture
+```
+
+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-architecture'), 'utf8');
+```
+
+The explicit data path
+`merpeeps-pack-architecture/architecture.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:
+
+- `architecture.merpeeps-pack.yml`
+- `LICENSE`
+- `README.md`
+- `package.json`
+
+The YAML defines stencil labels, text, shapes, core icon references, fill and
+stroke defaults, and hints. 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/architecture.merpeeps-pack.yml`](https://github.com/sargemonkey/merpeeps/blob/main/src/Merpeeps.Core/Packs/architecture.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/architecture.merpeeps-pack.yml

@@ -0,0 +1,103 @@
+id: architecture
+name: Architecture
+spec: 1
+licence: MIT
+
+# Infrastructure pieces, for the diagram you draw when explaining how a service
+# is actually deployed.
+stencils:
+  - label: Service
+    text: Service
+    shape: Rectangle
+    icon: server
+    fill: "#D5E8D4"
+    stroke: "#82B366"
+    hint: A running process
+
+  - label: API gateway
+    text: API Gateway
+    shape: Hexagon
+    icon: gateway
+    fill: "#FFE6CC"
+    stroke: "#D79B00"
+    hint: Front door for inbound traffic
+
+  - label: Database
+    text: Database
+    shape: Cylinder
+    icon: database
+    fill: "#F8CECC"
+    stroke: "#B85450"
+    hint: Relational or document store
+
+  - label: Cache
+    text: Cache
+    shape: Cylinder
+    icon: cache
+    fill: "#F8CECC"
+    stroke: "#B85450"
+    hint: Redis, Memcached, and friends
+
+  - label: Queue
+    text: Queue
+    shape: Subroutine
+    icon: queue
+    fill: "#FFF2CC"
+    stroke: "#D6B656"
+    hint: A message queue or topic
+
+  - label: Object storage
+    text: Storage
+    shape: Cylinder
+    icon: storage
+    fill: "#FFF2CC"
+    stroke: "#D6B656"
+    hint: Blob or object storage
+
+  - label: Function
+    text: Function
+    shape: RoundedRect
+    icon: function
+    fill: "#E1D5E7"
+    stroke: "#9673A6"
+    hint: Serverless or lambda
+
+  - label: Auth
+    text: Auth Service
+    shape: RoundedRect
+    icon: shield
+    fill: "#E1D5E7"
+    stroke: "#9673A6"
+    hint: Identity, authorisation, secrets
+
+  - label: Client
+    text: Web Client
+    shape: RoundedRect
+    icon: browser
+    fill: "#DAE8FC"
+    stroke: "#6C8EBF"
+    hint: Browser front end
+
+  - label: Mobile client
+    text: Mobile Client
+    shape: RoundedRect
+    icon: mobile
+    fill: "#DAE8FC"
+    stroke: "#6C8EBF"
+    hint: Phone or tablet front end
+
+  - label: Cloud
+    text: Cloud Provider
+    shape: RoundedRect
+    icon: cloud
+    fill: "#F5F5F5"
+    stroke: "#666666"
+    hint: A managed or third-party service
+
+  - label: Worker
+    text: Worker
+    shape: Rectangle
+    icon: cog
+    fill: "#D5E8D4"
+    stroke: "#82B366"
+    hint: Background or scheduled processing

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "merpeeps-pack-architecture",
+  "version": "0.1.0",
+  "description": "Data-only Merpeeps architecture stencil pack for services, gateways, storage, and infrastructure diagrams.",
+  "keywords": [
+    "merpeeps",
+    "mermaid",
+    "architecture",
+    "infrastructure",
+    "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-architecture"
+  },
+  "homepage": "https://github.com/sargemonkey/merpeeps/blob/main/docs/GUIDE.md#stencil-packs",
+  "bugs": {
+    "url": "https://github.com/sargemonkey/merpeeps/issues"
+  },
+  "main": "./architecture.merpeeps-pack.yml",
+  "exports": {
+    ".": "./architecture.merpeeps-pack.yml",
+    "./architecture.merpeeps-pack.yml": "./architecture.merpeeps-pack.yml"
+  },
+  "files": [
+    "architecture.merpeeps-pack.yml",
+    "LICENSE",
+    "README.md",
+    "package.json"
+  ],
+  "scripts": {
+    "prepack": "node ../../scripts/prepare-domain-pack.mjs architecture",
+    "release:check": "node ../../oracle/package-consumer-test.mjs merpeeps-pack-architecture",
+    "prepublishOnly": "npm run release:check"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}