@lamppost/create-ink-player 1.0.0

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2026 John Resig
+
+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,7 @@
+# Create Lamp Post Ink Player
+
+This is a utility for helping to create Lamp Post Ink Player games.
+
+Please see [https://www.npmjs.com/package/@lamppost/ink-player](@lamppost/ink-player) for more details on how to use this package.
+
+This software is released under an MIT license.

package/index.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+import { execSync } from "node:child_process";
+import {
+    cpSync,
+    existsSync,
+    mkdirSync,
+    readFileSync,
+    rmSync,
+    writeFileSync,
+} from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { stdin as input, stdout as output } from "node:process";
+import readline from "node:readline/promises";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+async function main() {
+    // Ask for the directory name
+    const rl = readline.createInterface({ input, output });
+
+    let directoryName = "";
+    while (true) {
+        const answer = await rl.question(
+            "What directory name would you like to use? ",
+        );
+        const trimmed = answer.trim();
+
+        if (!trimmed || trimmed.length === 0) {
+            console.log("Directory name cannot be empty");
+            continue;
+        }
+
+        // Check for valid directory name characters
+        if (!/^[a-zA-Z0-9_-]+$/.test(trimmed)) {
+            console.log(
+                "Directory name can only contain letters, numbers, hyphens, and underscores",
+            );
+            continue;
+        }
+
+        directoryName = trimmed;
+        break;
+    }
+
+    const targetDir = resolve(process.cwd(), directoryName);
+
+    // Check if directory already exists
+    if (existsSync(targetDir)) {
+        console.error(`Error: Directory "${directoryName}" already exists.`);
+        process.exit(1);
+    }
+
+    // Ask for the game name
+    let gameName = "";
+    while (true) {
+        const answer = await rl.question("What is the name of your game? ");
+        const trimmed = answer.trim();
+
+        if (!trimmed || trimmed.length === 0) {
+            console.log("Game name cannot be empty");
+            continue;
+        }
+
+        gameName = trimmed;
+        break;
+    }
+
+    rl.close();
+
+    console.log(`Creating game "${gameName}"...`);
+
+    // Create the directory
+    mkdirSync(targetDir, { recursive: true });
+
+    // Copy template contents
+    const templateDir = join(__dirname, "template");
+    console.log("Copying template files...");
+    cpSync(templateDir, targetDir, { recursive: true });
+
+    // Delete the node_modules directory, if it exists
+    if (existsSync(join(targetDir, "node_modules"))) {
+        rmSync(join(targetDir, "node_modules"), { recursive: true });
+    }
+
+    // Update package.json
+    const packageJsonPath = join(targetDir, "package.json");
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+    packageJson.name = gameName;
+    writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`);
+
+    // Update the gameName in the src/index.ts file
+    const indexTsPath = join(targetDir, "src/index.ts");
+    const indexTs = readFileSync(indexTsPath, "utf-8").replace(
+        "Lamp Post Player",
+        gameName,
+    );
+    writeFileSync(indexTsPath, indexTs);
+
+    // Update the gameName in the README.md file
+    const readmeMdPath = join(targetDir, "README.md");
+    const readmeMd = readFileSync(readmeMdPath, "utf-8").replace(
+        "Lamp Post Player",
+        gameName,
+    );
+    writeFileSync(readmeMdPath, readmeMd);
+
+    console.log("Installing dependencies...");
+
+    // Run pnpm install
+    try {
+        execSync("pnpm install", {
+            cwd: targetDir,
+            stdio: "inherit",
+        });
+    } catch (error) {
+        console.error("Error installing dependencies:", error.message);
+        process.exit(1);
+    }
+
+    console.log(`\n${gameName} setup complete!`);
+    console.log(`\nTo get started:`);
+    console.log(`  cd ${directoryName}`);
+    console.log(`  pnpm dev`);
+    console.log(
+        `\nThis will start the development server and open the game in your browser.`,
+    );
+}
+
+main().catch((error) => {
+    console.error("Error:", error.message);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@lamppost/create-ink-player",
+  "version": "1.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "A utility for helping to create Lamp Post Ink Player games.",
+  "author": "John Resig <jeresig@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jeresig/lamppost-player.git"
+  },
+  "homepage": "https://github.com/jeresig/lamppost-player",
+  "keywords": [
+    "ink",
+    "inkjs",
+    "interactive fiction",
+    "game"
+  ],
+  "main": "./index.js",
+  "bin": {
+    "create-ink-player": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "template",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {}
+}

package/template/README.md

@@ -0,0 +1,16 @@
+# Lamp Post Player
+
+This is a web player for running [Ink](https://github.com/inkle/ink) stories created by [Lamp Post Projects](https://lamppostprojects.com/).
+
+## Getting Started
+
+* Run `pnpm dev` to see the result in your browser and confirm that things are running correctly.
+* Open up `story/game.ink` in the Inky editor and make modifications, go back to your game in the browser and see your changes live!
+* Update the settings in `src/index.tsx` to use your game name and update any other settings.
+* Update the About page in `src/About.tsx` to include some information about your game (or remove that screen entirely by updating `src/index.ts`).
+* Add any custom CSS styling inside the `src/styles.scss` file.
+* Run `pnpm build` to create the final HTML/JS/CSS/Image files needed to display the game. The files will be output to the `dist/` directory. You can then bundle them or upload them to the location of your choice.
+
+## Next Steps
+
+Please see [https://www.npmjs.com/package/@lamppost/ink-player](@lamppost/ink-player) for more details on how to configure the Lamp Post Ink Player

package/template/package.json

@@ -0,0 +1,30 @@
+{
+    "name": "lamppost-ink-player-template",
+    "version": "1.0.0",
+    "private": true,
+    "type": "module",
+    "scripts": {
+        "build": "rsbuild build",
+        "dev": "rsbuild dev --open",
+        "preview": "rsbuild preview"
+    },
+    "dependencies": {
+        "@lamppost/ink-player": "^1.0.3",
+        "preact": "^10.27.1",
+        "react-bootstrap": "^2.10.10"
+    },
+    "devDependencies": {
+        "@rsbuild/core": "^1.5.4",
+        "@rsbuild/plugin-image-compress": "^1.3.1",
+        "@rsbuild/plugin-preact": "^1.5.2",
+        "@rsbuild/plugin-sass": "^1.4.0",
+        "@rsbuild/plugin-svgr": "^1.2.2",
+        "typescript": "^5.9.2"
+    },
+    "packageManager": "pnpm@10.1.0+sha512.c89847b0667ddab50396bbbd008a2a43cf3b581efd59cf5d9aa8923ea1fb4b8106c041d540d08acb095037594d73ebc51e1ec89ee40c88b30b8a66c0fae0ac1b",
+    "pnpm": {
+        "patchedDependencies": {
+            "@restart/ui": "patches/@restart__ui.patch"
+        }
+    }
+}

package/template/patches/@restart__ui.patch

@@ -0,0 +1,26 @@
+diff --git a/esm/useClickOutside.js b/esm/useClickOutside.js
+index 7c8eeb387f4c5a10cfc7114078f81085951f520f..4526af4795862d5afdf6b945e0ba4887117fa656 100644
+--- a/esm/useClickOutside.js
++++ b/esm/useClickOutside.js
+@@ -66,7 +66,7 @@ function useClickOutside(ref, onClickOutside = noop, {
+     // For things rendered in an iframe, the event might originate on the parent window
+     // so we should fall back to that global event if the local one doesn't exist
+     // https://github.com/facebook/react/issues/20074
+-    let currentEvent = (_ownerWindow$event = ownerWindow.event) != null ? _ownerWindow$event : (_ownerWindow$parent = ownerWindow.parent) == null ? void 0 : _ownerWindow$parent.event;
++    let currentEvent = null; try { currentEvent = (_ownerWindow$event = ownerWindow.event) != null ? _ownerWindow$event : (_ownerWindow$parent = ownerWindow.parent) == null ? void 0 : _ownerWindow$parent.event; } catch {}
+     let removeInitialTriggerListener = null;
+     if (InitialTriggerEvents[clickTrigger]) {
+       removeInitialTriggerListener = listen(doc, InitialTriggerEvents[clickTrigger], handleInitialMouse, true);
+diff --git a/esm/useRootClose.js b/esm/useRootClose.js
+index b9e3cfabe1947262004ddf2a210f824458792f03..331843568da66142a77b9aab3b3af91f9809036a 100644
+--- a/esm/useRootClose.js
++++ b/esm/useRootClose.js
+@@ -37,7 +37,7 @@ function useRootClose(ref, onRootClose, {
+ 
+     // Store the current event to avoid triggering handlers immediately
+     // https://github.com/facebook/react/issues/20074
+-    let currentEvent = (doc.defaultView || window).event;
++    let currentEvent = null; try { currentEvent = (doc.defaultView || window).event; } catch {}
+     const removeKeyupListener = listen(doc, 'keyup', e => {
+       // skip if this event is the same as the one running when we added the handlers
+       if (e === currentEvent) {