merpeeps-pack-flowchart 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-flowchart
+
+The Merpeeps Flowchart stencil pack, distributed as **YAML data only**.
+Includes ten stencils for processes, decisions, terminals, subprocesses,
+data stores, connectors, preparation, input/output, manual operations, and
+rounded steps.
+
+## Install and read
+
+```bash
+npm install merpeeps-pack-flowchart
+```
+
+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-flowchart'), 'utf8');
+```
+
+The explicit data path `merpeeps-pack-flowchart/flowchart.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:
+
+- `flowchart.merpeeps-pack.yml`
+- `LICENSE`
+- `README.md`
+- `package.json`
+
+The YAML defines stencil labels, text, shapes, and hints. This pack leaves
+colours to the host defaults and declares no icons or custom icon geometry.
+It includes no new artwork. Your host supplies shape rendering; 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/flowchart.merpeeps-pack.yml`](https://github.com/sargemonkey/merpeeps/blob/main/src/Merpeeps.Core/Packs/flowchart.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/flowchart.merpeeps-pack.yml

@@ -0,0 +1,57 @@
+id: flowchart
+name: Flowchart
+spec: 1
+licence: MIT
+
+# Plain mermaid flowchart shapes, named for what they mean rather than what they
+# look like — the reason to pick a rhombus is that it is a decision.
+stencils:
+  - label: Process
+    text: Process
+    shape: Rectangle
+    hint: A step that does something
+
+  - label: Decision
+    text: Decision?
+    shape: Rhombus
+    hint: A branch — label the edges yes/no
+
+  - label: Terminal
+    text: Start
+    shape: Stadium
+    hint: Where a flow begins or ends
+
+  - label: Subprocess
+    text: Subprocess
+    shape: Subroutine
+    hint: A step defined elsewhere
+
+  - label: Data store
+    text: Store
+    shape: Cylinder
+    hint: A database or persistent store
+
+  - label: Connector
+    text: A
+    shape: Circle
+    hint: Joins flows across a page break
+
+  - label: Preparation
+    text: Prepare
+    shape: Hexagon
+    hint: Setup or initialisation
+
+  - label: Input / output
+    text: Input
+    shape: Parallelogram
+    hint: Data entering or leaving
+
+  - label: Manual operation
+    text: Manual step
+    shape: Trapezoid
+    hint: A step a person performs
+
+  - label: Rounded
+    text: Step
+    shape: RoundedRect
+    hint: A softer process box

package/package.json

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