nnw-theme 1.0.0 → 1.0.2

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/browser.js

@@ -128,6 +128,8 @@ export function failures(state) {
         found.push("horizontal document overflow");
     if (state.brokenImages.length)
         found.push(`broken images: ${pyReprList(state.brokenImages)}`);
+    if (state.collapsedImages.length)
+        found.push(`images drawn at zero size: ${pyReprList(state.collapsedImages)}`);
     found.push(...(state.footnotes ?? []));
     if (state.blocked.length)
         found.push(`external requests: ${pyReprList(state.blocked)}`);
@@ -149,6 +151,25 @@ function pageState() {
         brokenImages: [...document.images]
             .filter((image) => image.complete && image.naturalWidth === 0)
             .map((image) => image.currentSrc || image.src),
+        // A loaded image the theme lays out at no size, such as a percentage width
+        // inside a shrink-to-fit float, which WebKit resolves to zero. Images that are
+        // not laid out at all (display: none, a closed <details>) are deliberate, and
+        // so is one the article itself sizes to zero, like a tracking pixel.
+        collapsedImages: [...document.images]
+            .filter((image) => {
+            if (!image.complete || image.naturalWidth < 2 || image.naturalHeight < 2)
+                return false;
+            if (!image.getClientRects().length)
+                return false;
+            const zero = (value) => value !== null && /^\s*0(px)?\s*$/i.test(value);
+            if ([image.getAttribute("width"), image.getAttribute("height")].some(zero))
+                return false;
+            if ([image.style.width, image.style.height].some(zero))
+                return false;
+            const box = image.getBoundingClientRect();
+            return box.width < 1 || box.height < 1;
+        })
+            .map((image) => image.currentSrc || image.src),
     };
 }
 /**

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.2",
 	"description": "Create, preview, check, and publish a NetNewsWire theme.",
 	"license": "Apache-2.0",
 	"author": "Dave Marquard",