@limitlesspc/konbini 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 limitlesspc
+
+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,5 @@
+<h1 align="center">konbini</h1>
+<p align="center">Convenient stores</p>
+<p align="center"><sup>コンビニ</sup></p>
+
+Simple little observables that work well in Svelte

package/dist/index.cjs

@@ -0,0 +1,75 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// index.ts
+var index_exports = {};
+__export(index_exports, {
+  computed: () => computed,
+  konbini: () => konbini
+});
+module.exports = __toCommonJS(index_exports);
+var computationStack = [];
+function konbini(value) {
+  const subscribers = [];
+  const store = (...args) => {
+    if (!args.length) {
+      const outerCompute = computationStack.at(-1);
+      if (outerCompute) {
+        subscribers.push(outerCompute);
+      }
+      return value;
+    }
+    const newValue = args[0];
+    if (newValue !== value) {
+      value = args[0];
+      for (const subscriber of subscribers) {
+        subscriber(value);
+      }
+    }
+    return value;
+  };
+  store.set = (newValue) => store(newValue);
+  store.subscribe = (subscriber) => {
+    subscriber(value);
+    subscribers.push(subscriber);
+    return () => {
+      const index = subscribers.indexOf(subscriber);
+      if (index !== -1) {
+        subscribers.splice(index, 1);
+      }
+    };
+  };
+  return store;
+}
+function computed(fn) {
+  const store = konbini();
+  function compute() {
+    const result = fn();
+    store(result);
+  }
+  computationStack.push(compute);
+  compute();
+  computationStack.pop();
+  return store;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  computed,
+  konbini
+});

package/dist/index.d.cts

@@ -0,0 +1,64 @@
+/**
+ * @module konbini
+ * A simple single-like reactive store that can be used in Svelte
+ *
+ * @example
+ * ```ts
+ * import { konbini, computed } from "@limitlesspc/konbini";
+ *
+ * const count = konbini(0);
+ * const doubled = computed(() => count() * 2);
+ */
+/** Called when the store's value changes */
+type Subscriber<T> = (newValue: T, oldValue?: T) => any;
+/** Stop listening for changes to a store's value */
+type Unsubscriber = () => void;
+/**
+ * A store that can be subscribed to
+ *
+ * This follows the [Svelte store contract](https://svelte.dev/docs/svelte/stores#Store-contract) so it can be prefixed a `$` in Svelte components the same way Svelte stores can.
+ */
+interface Konbini<T> {
+    /** Get the value of the store */
+    (): T;
+    /** Set the value of the store */
+    (newValue: T): T;
+    /** Set the value of the store */
+    set(newValue: T): T;
+    /**
+     * Listen for changes to the store's value.
+     * @param subscriber called when the store's value changes
+     * @returns a function that can be called to stop listening for changes
+     */
+    subscribe(subscriber: Subscriber<T>): Unsubscriber;
+}
+/**
+ * Create a new store.
+ * @param value The initial value of the store
+ * @returns A store
+ *
+ * @example
+ * ```ts
+ * const count = konbini(0);
+ * count() // 0
+ * count(2);
+ * count() // 2
+ * ```
+ */
+declare function konbini<T>(value?: T): Konbini<T>;
+/**
+ * Creates a computed store, where its value is derived from other stores
+ * @param executor A function that returns the value of the store
+ * @returns A store
+ *
+ * @example
+ * ```ts
+ * const count = konbini(0);
+ * const doubled = computed(() => count() * 2);
+ * count(2);
+ * doubled() // 4
+ * ```
+ */
+declare function computed<T>(fn: () => T): Konbini<T>;
+
+export { type Konbini, type Subscriber, type Unsubscriber, computed, konbini };

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @module konbini
+ * A simple single-like reactive store that can be used in Svelte
+ *
+ * @example
+ * ```ts
+ * import { konbini, computed } from "@limitlesspc/konbini";
+ *
+ * const count = konbini(0);
+ * const doubled = computed(() => count() * 2);
+ */
+/** Called when the store's value changes */
+type Subscriber<T> = (newValue: T, oldValue?: T) => any;
+/** Stop listening for changes to a store's value */
+type Unsubscriber = () => void;
+/**
+ * A store that can be subscribed to
+ *
+ * This follows the [Svelte store contract](https://svelte.dev/docs/svelte/stores#Store-contract) so it can be prefixed a `$` in Svelte components the same way Svelte stores can.
+ */
+interface Konbini<T> {
+    /** Get the value of the store */
+    (): T;
+    /** Set the value of the store */
+    (newValue: T): T;
+    /** Set the value of the store */
+    set(newValue: T): T;
+    /**
+     * Listen for changes to the store's value.
+     * @param subscriber called when the store's value changes
+     * @returns a function that can be called to stop listening for changes
+     */
+    subscribe(subscriber: Subscriber<T>): Unsubscriber;
+}
+/**
+ * Create a new store.
+ * @param value The initial value of the store
+ * @returns A store
+ *
+ * @example
+ * ```ts
+ * const count = konbini(0);
+ * count() // 0
+ * count(2);
+ * count() // 2
+ * ```
+ */
+declare function konbini<T>(value?: T): Konbini<T>;
+/**
+ * Creates a computed store, where its value is derived from other stores
+ * @param executor A function that returns the value of the store
+ * @returns A store
+ *
+ * @example
+ * ```ts
+ * const count = konbini(0);
+ * const doubled = computed(() => count() * 2);
+ * count(2);
+ * doubled() // 4
+ * ```
+ */
+declare function computed<T>(fn: () => T): Konbini<T>;
+
+export { type Konbini, type Subscriber, type Unsubscriber, computed, konbini };

package/dist/index.js

@@ -0,0 +1,49 @@
+// index.ts
+var computationStack = [];
+function konbini(value) {
+  const subscribers = [];
+  const store = (...args) => {
+    if (!args.length) {
+      const outerCompute = computationStack.at(-1);
+      if (outerCompute) {
+        subscribers.push(outerCompute);
+      }
+      return value;
+    }
+    const newValue = args[0];
+    if (newValue !== value) {
+      value = args[0];
+      for (const subscriber of subscribers) {
+        subscriber(value);
+      }
+    }
+    return value;
+  };
+  store.set = (newValue) => store(newValue);
+  store.subscribe = (subscriber) => {
+    subscriber(value);
+    subscribers.push(subscriber);
+    return () => {
+      const index = subscribers.indexOf(subscriber);
+      if (index !== -1) {
+        subscribers.splice(index, 1);
+      }
+    };
+  };
+  return store;
+}
+function computed(fn) {
+  const store = konbini();
+  function compute() {
+    const result = fn();
+    store(result);
+  }
+  computationStack.push(compute);
+  compute();
+  computationStack.pop();
+  return store;
+}
+export {
+  computed,
+  konbini
+};

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@limitlesspc/konbini",
+  "type": "module",
+  "version": "1.0.0",
+  "description": "Convenient stores",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/limitlesspc/konbini.git"
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "import": "./dist/index.js",
+      "default": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "prettier": "@limitlesspc/prettier-config",
+  "devDependencies": {
+    "@limitlesspc/prettier-config": "^1.2.1",
+    "tsup": "^8.3.5",
+    "typescript": "^5.6.3",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "test": "vitest",
+    "build": "tsup",
+    "fmt": "prettier . --write"
+  }
+}