nnw-theme 1.0.0 → 1.0.1

package/assets/stubs/AGENTS.md

@@ -6,6 +6,13 @@ its `fixtures/`, and `screenshots/`. The tooling is the `nnw-theme` npm package;
 run it as `npx nnw-theme@1 <command>`. Never install it globally and never add
 it to this repository. Read `npx nnw-theme@1 guide` before theme work.
 
+If this repository is `dave-atx/netnewswire-theme-template` itself (check
+`git remote -v`), it is the GitHub template, not a theme: do not initialize,
+fork, or design in it. Help the user create their own repository from it with
+**Use this template** or `gh repo create NAME --template
+dave-atx/netnewswire-theme-template --clone`, confirming before you create it,
+then work in that copy.
+
 If `.nnw-theme-uninitialized` exists, run `npx nnw-theme@1 init` first and let
 the user confirm the permanent theme identifier. Prefer CSS changes; change
 `template.html` only when the requested structure or behavior requires it.

package/dist/commands/init.js

@@ -61,6 +61,23 @@ function updateReadme(root, name, creator, homepage) {
         `A NetNewsWire theme by [${creator}](${homepage}).\n${IDENTITY_END}`;
     writeFileSync(path, text.slice(0, start) + replacement + text.slice(end + IDENTITY_END.length), "utf8");
 }
+const TEMPLATE = "dave-atx/netnewswire-theme-template";
+/** The theme root, or directions to create one: init starts from the template. */
+function templateRoot() {
+    try {
+        return findRoot();
+    }
+    catch (error) {
+        if (!(error instanceof ThemeError))
+            throw error;
+        throw new ThemeError("no theme repository here; init personalizes a copy of the theme template.\n" +
+            `Create one with "Use this template" at https://github.com/${TEMPLATE}, ` +
+            "clone it, and run init inside it. With the GitHub CLI:\n" +
+            `  gh repo create my-theme --template ${TEMPLATE} --public --clone\n` +
+            "  cd my-theme\n" +
+            "  npx nnw-theme@1 init");
+    }
+}
 async function ask(value, flag, label, fallback) {
     if (value)
         return value;
@@ -69,7 +86,7 @@ async function ask(value, flag, label, fallback) {
     return await promptText(label, fallback);
 }
 export default async function init({ values }) {
-    const root = findRoot();
+    const root = templateRoot();
     let theme = findTheme(root);
     if (!existsSync(join(root, PLACEHOLDER_MARKER))) {
         throw new ThemeError("this repository is already initialized; run `npx nnw-theme@1 setup` to install preview tools");

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "nnw-theme",
-	"version": "1.0.0",
+	"version": "1.0.1",
 	"description": "Create, preview, check, and publish a NetNewsWire theme.",
 	"license": "Apache-2.0",
 	"author": "Dave Marquard",