die-statement 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Gustavo Luiz Gregorio
+
+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,90 @@
+# die() - Because Sometimes Code Needs to Just... Stop
+
+[![npm](https://img.shields.io/npm/v/die-statement.svg)](https://www.npmjs.com/package/entropy-particles)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+
+A simple and easy way to kill any application whenever you want, be it on a new line or as an inline statement!
+
+## Installation
+
+```javascript
+npm i die-statement
+```
+
+Or just drop the function in your codebase. No npm bloat, no build step, no regrets. Here it is, i'll make it easy for ya!
+
+```javascript
+function die(message = "Fatal Error") {
+    return (() => {
+        const error = new Error();
+        const match = error.stack?.match(/^(?!die).*@(.*:\d+:\d+)$/m);
+
+        if (match) {
+            console.log(message, "\n\nDied at:", match[1]);
+        } else {
+            console.log(message, "Died at (location unknown)");
+        }
+
+        throw error;
+    })();
+}
+```
+
+## Usage
+
+```javascript
+die(message?)
+```
+
+### Parameters
+
+- `message` (string, optional): Your last words before everything crashes. Defaults to `"Fatal Error"` if you're feeling uncreative.
+
+### Returns
+
+Nothing. It throws an Error. Your code stops here. Game over.
+
+## Examples
+
+**As a fallback (the fancy way):**
+
+```javascript
+const necessaryElement = document.getElementById("#important") || die();
+```
+
+**When you've had enough (the direct way):**
+
+```javascript
+if (userDidSomethingDumb) {
+    die("User did something unforgivable");
+}
+```
+
+**The dramatic exit:**
+
+```javascript
+const config = loadConfig() || die("No config, no service. I quit.");
+```
+
+## What It Does
+
+When called, `die()` will:
+
+1. Log your message (or the default one) to the console
+2. Show you exactly where your code gave up on life (`Died at: file.js:42:10`)
+3. Throw an Error to stop execution immediately
+
+## Why Use This?
+
+Sometimes `throw new Error()` is too many characters. Sometimes you want your failures to feel more... deliberate. Sometimes you just want to watch the world burn, but in a traceable way.
+
+Also, if you've ever missed PHP's `die()` function and tried to use `throw new Error()` in a statement only to have JavaScript laugh at you—well, now you don't have to miss it anymore.
+
+## Notes
+
+- The stack trace parsing works in modern browsers. If it fails, you'll get `"(location unknown)"` instead. Even `die()` has its limits.
+- This is blocking and synchronous. If you call it, everything stops. That's the point.
+
+---
+
+_"To die, to sleep—no more—and by a sleep to say we end the heartache..."_ - Shakespeare, probably talking about JavaScript

package/index.d.ts

@@ -0,0 +1 @@
+export declare function die(message?: string): never;

package/index.js

@@ -0,0 +1,13 @@
+export function die(message = "Fatal Error") {
+    return (() => {
+        const error = new Error();
+        const match = error.stack?.match(/^(?!die).*@(.*:\d+:\d+)$/m);
+        if (match) {
+            console.error(message, "\n\nDied at:", match[1]);
+        }
+        else {
+            console.error(message, "Died at (location unknown)");
+        }
+        throw error;
+    })();
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+    "name": "die-statement",
+    "version": "1.0.0",
+    "description": "A simple and easy way to kill any application whenever you want, be it on a new line or as an inline statement!",
+    "keywords": [
+        "die",
+        "error",
+        "throw",
+        "fatal",
+        "exit",
+        "assert",
+        "inline",
+        "statement",
+        "fail",
+        "crash",
+        "stop",
+        "php-die",
+        "error-handling",
+        "guard",
+        "fallback",
+        "one-liner",
+        "utility",
+        "debugging",
+        "stack-trace",
+        "fatal-guard"
+    ],
+    "author": "Gustavo Luiz Gregorio",
+    "homepage": "https://github.com/GustavoLGregorio/die-statement#readme",
+    "bugs": {
+        "url": "https://github.com/GustavoLGregorio/die-statement/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/GustavoLGregorio/die-statement.git"
+    },
+    "license": "MIT",
+    "type": "commonjs",
+    "main": "index.js",
+    "files": [
+        "index.js",
+        "index.d.ts",
+        "LICENSE",
+        "README.md",
+        "package.json"
+    ]
+}