pf2e-primer 0.1.0

package/dist/manifest.webmanifest

@@ -0,0 +1,13 @@
+{
+  "name": "PF2e Primer",
+  "short_name": "PF2e Primer",
+  "description": "A hands-on introduction to Pathfinder 2e: the three pillars of play, with live demos of every core rule.",
+  "start_url": ".",
+  "scope": ".",
+  "display": "standalone",
+  "background_color": "#14161b",
+  "theme_color": "#14161b",
+  "icons": [
+    { "src": "icon.svg", "sizes": "any", "type": "image/svg+xml", "purpose": "any maskable" }
+  ]
+}

package/dist/sw.js

@@ -0,0 +1,60 @@
+/* Service worker — offline support for the hosted (GitHub Pages) PWA.
+   Network-first for the app page (fresh when online, cached when offline),
+   cache-first for static assets. Cache version is stamped at build time so a
+   redeploy refreshes clients automatically. */
+const CACHE = "pf2e-primer-20260914005112";
+/* Every cache this app has ever made starts with PREFIX. The sweep below is
+   scoped to it on purpose: the three PF2e tools share an origin when they are
+   served from one host (GitHub Pages does it, and so does the toolbox), and an
+   unscoped sweep would delete the other two apps' offline caches every time
+   this one activated. */
+const PREFIX = "pf2e-primer-";
+const SHELL = ["./", "./index.html", "./manifest.webmanifest", "./icon.svg"];
+
+self.addEventListener("install", (e) => {
+  e.waitUntil(
+    caches.open(CACHE)
+      .then((c) => c.addAll(SHELL).catch(() => {}))
+      .then(() => self.skipWaiting())
+  );
+});
+
+self.addEventListener("activate", (e) => {
+  e.waitUntil(
+    caches.keys()
+      .then((keys) => Promise.all(keys.filter((k) => k.startsWith(PREFIX) && k !== CACHE)
+        .map((k) => caches.delete(k))))
+      .then(() => self.clients.claim())
+  );
+});
+
+self.addEventListener("fetch", (e) => {
+  const req = e.request;
+  if (req.method !== "GET") return;
+
+  if (req.mode === "navigate") {
+    e.respondWith(
+      fetch(req)
+        .then((res) => {
+          const copy = res.clone();
+          caches.open(CACHE).then((c) => c.put("./index.html", copy));
+          return res;
+        })
+        .catch(() => caches.match("./index.html").then((r) => r || caches.match("./")))
+    );
+    return;
+  }
+
+  e.respondWith(
+    caches.match(req).then((r) =>
+      r ||
+      fetch(req).then((res) => {
+        if (res.ok && new URL(req.url).origin === self.location.origin) {
+          const copy = res.clone();
+          caches.open(CACHE).then((c) => c.put(req, copy));
+        }
+        return res;
+      }).catch(() => r)
+    )
+  );
+});

package/notice.md

@@ -0,0 +1,124 @@
+# Third-Party Notices & Attribution
+
+**pf2e-primer**
+
+This file records the licensing of the two distinct kinds of material in this
+package: the application **code**, and the Pathfinder **rules text** it bundles
+(condition and action descriptions). They are covered by different licenses and
+the distinction below is intentional.
+
+---
+
+## 1. Application code
+
+All original source code in this package is released under the **MIT License**.
+See the [`LICENSE`](./LICENSE) file for the full text.
+
+```
+Copyright (c) 2026 Whyte Erminae
+```
+
+The MIT License covers only the code authored for this project. It does **not**
+cover the Pathfinder game content described in section 2, which carries its own
+license and notice. The two pregenerated characters and the teaching NPC shown by this app are
+original fiction, not Paizo content; every number on them is derived arithmetic.
+
+---
+
+## 2. Pathfinder rules content (ORC License)
+
+The bundled reference data consists of the **rules expressions of Pathfinder
+Second Edition conditions and actions** — their names and functional effect text.
+Under the Open RPG Creative License this is **Licensed Material** (the copyrighted
+expression of game mechanics), used here under that license. It originates with
+**Paizo Inc.** and is derived from the open-source [Foundry VTT `pf2e`
+system](https://github.com/foundryvtt/pf2e) data.
+
+### ORC Notice
+
+This product is licensed under the ORC License located at the Library of Congress
+at TX 9-307-067 and available online at various locations including
+paizo.com/orclicense, azoralaw.com/orclicense, and others. All warranties are
+disclaimed as set forth therein.
+
+### Attribution
+
+This product is based on the following Licensed Material:
+
+Pathfinder Player Core © 2023 Paizo Inc., Designed by Logan Bonner, Jason
+Bulmahn, Stephen Radney-MacFarland, and Mark Seifter.
+
+Pathfinder Player Core 2 © 2024 Paizo Inc.
+
+Pathfinder GM Core © 2023 Paizo Inc., Designed by Logan Bonner and Mark Seifter.
+
+Pathfinder Treasure Vault (Remastered) © 2025 Paizo Inc.
+
+Pathfinder Dark Archive (Remastered) © 2025 Paizo Inc.
+
+> NOTE — The precise list of source books is generated into `GENERATED_REF_META`
+> in `data/reference.generated.js` from the licenses recorded in the Foundry pf2e
+> data. Re-sync this section whenever the reference data is rebuilt
+> (`npm run build:ref`).
+
+### Reserved Material
+
+Reserved Material elements are excluded from this product. To avoid confusion,
+such items include all trademarks, registered trademarks, and proper nouns,
+artwork, dialogue, organizations, plots, and storylines. Where a rule's mechanics
+are included, any such Reserved Material has been omitted or genericized.
+
+### Crediting this work downstream
+
+pf2e-primer © 2026 Whyte Erminae.
+
+---
+
+## 3. Pathfinder rules content (OGL)
+
+Three of the bundled action descriptions originate in pre-Remaster books that
+were published under the **Open Game License v1.0a** rather than the ORC License
+(2 from *Pathfinder Secrets of Magic*, 1 from *Pathfinder Gamemastery Guide*).
+They are included here as Open Game Content under that license.
+
+### OGL Section 15
+
+```
+Open Game License v 1.0a © 2000, Wizards of the Coast, Inc.
+
+System Reference Document © 2000, Wizards of the Coast, Inc.; Authors Jonathan
+Tweet, Monte Cook, and Skip Williams, based on material by E. Gary Gygax and
+Dave Arneson.
+
+Pathfinder Secrets of Magic © 2021, Paizo Inc.; Authors: Amirali Attar Olyaee,
+Alexander Augunas, Kate Baker, James Case, Jeff Collins, Vanessa Hoskins,
+James Jacobs, Jason Keeley, Lyz Liddell, Ron Lundeen, Patchen Mortimer, Stephen
+Radney-MacFarland, David N. Ross, Michael Sayre, Owen K.C. Stephens, Mark
+Seifter, Ashton Sperry, Andrew White.
+
+Pathfinder Gamemastery Guide © 2020, Paizo Inc.; Authors: Alexander Augunas,
+Jesse Benner, John Bennett, Logan Bonner, Clinton J. Boomer, Jason Bulmahn,
+James Case, Paris Crenshaw, Jesse Decker, Robert N. Emerson, Eleanor Ferron,
+Jaym Gates, Matthew Goetz, T.H. Gulliver, Kev Hamilton, Sasha Laranoa Harving,
+BJ Hensley, Vanessa Hoskins, Brian R. James, Jason LeMaitre, Lyz Liddell, Luis
+Loza, Ron Lundeen, Colm Lundberg, Stephen Radney-MacFarland, Jessica Redekop,
+Patrick Renie, Mikhail Rekun, Alistair Rigg, David N. Ross, David Schwartz,
+Michael Sayre, Amber Stewart, Christina Stiles, Landon Winkler, Linda Zayas-Palmer.
+```
+
+> NOTE — Regenerate this list from `GENERATED_REF_META` whenever the reference
+> data is rebuilt (`npm run build:ref`); the licence recorded per entry decides
+> which section it belongs in.
+
+---
+
+## 4. Compatibility / trademark notice
+
+Pathfinder and all associated marks and logos are trademarks of Paizo Inc.
+This package is an independent work, is **not** published, endorsed, sponsored,
+or affiliated with Paizo Inc., and no such association is implied. Any reference
+to Pathfinder is made under nominative fair use solely to identify the game
+system with which this material is compatible.
+
+The explanatory prose, the two pregenerated characters, the teaching NPC and all
+the interactive demos are original work by the author of this package.

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "pf2e-primer",
+  "version": "0.1.0",
+  "description": "A hands-on introduction to Pathfinder 2e for players who already know tabletop RPGs — the three pillars of play, with live demos (single self-contained HTML).",
+  "keywords": [
+    "pathfinder",
+    "pf2e",
+    "beginner",
+    "primer",
+    "teaching",
+    "ttrpg"
+  ],
+  "homepage": "https://thewhytewolf.github.io/pf2eprimer/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TheWhyteWolf/pf2eprimer.git"
+  },
+  "bugs": {
+    "url": "https://github.com/TheWhyteWolf/pf2eprimer/issues"
+  },
+  "author": "Whyte",
+  "license": "SEE LICENSE IN LICENSE",
+  "type": "module",
+  "bin": {
+    "pf2e-primer": "bin/cli.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "tools/",
+    "data/",
+    "dist/",
+    "notice.md"
+  ],
+  "scripts": {
+    "build": "python3 tools/build.py",
+    "build:ref": "python3 tools/build_reference.py --src \"$PF2E_DATA/packs/pf2e\" --out data/reference.generated.js",
+    "test": "node tools/test.mjs",
+    "check": "npm run build && npm test"
+  },
+  "devDependencies": {
+    "jsdom": "^24.0.0"
+  }
+}