@bind-ts/bind-core 0.0.1

package/dist/cjs/index.cjs

@@ -0,0 +1 @@
+"use strict";var u=Object.defineProperty;var l=(n,t,e)=>t in n?u(n,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):n[t]=e;var o=(n,t,e)=>l(n,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("@tanstack/store");class p{constructor(t){o(this,"options");o(this,"store");o(this,"setValue",t=>{var s,i;const e=this.store.state.value;this.store.setState(a=>({...a,value:t})),e!==t&&((i=(s=this.options.listeners)==null?void 0:s.onChange)==null||i.call(s,{value:t,bindApi:this}))});o(this,"update",t=>{this.options=t});o(this,"reset",t=>{var i,a;t!==void 0&&(this.options={...this.options,defaultValue:t});const e=this.store.state.value,s=this.options.defaultValue;this.store.setState(r=>({...r,value:s})),e!==s&&((a=(i=this.options.listeners)==null?void 0:i.onChange)==null||a.call(i,{value:s,bindApi:this}))});o(this,"mount",()=>()=>{});this.options=t,this.store=new h.Store({value:t.defaultValue,values:t.values})}get state(){return this.store.state}}exports.BindApi=p;

package/dist/esm/BindApi.d.ts

@@ -0,0 +1,72 @@
+import { Store } from "@tanstack/store";
+/**
+ * The state shape managed by BindApi
+ */
+export interface BindState<TValues extends readonly string[]> {
+    value: TValues[number];
+    values: TValues;
+}
+/**
+ * Listener callbacks for BindApi events
+ */
+export interface BindListeners<TValues extends readonly string[]> {
+    /**
+     * Called when the value changes via setValue or reset
+     */
+    onChange?: (props: {
+        value: TValues[number];
+        bindApi: BindApi<TValues>;
+    }) => void;
+}
+/**
+ * Options for creating a BindApi instance
+ */
+export interface BindOptions<TValues extends readonly string[]> {
+    defaultValue: TValues[number];
+    values: TValues;
+    listeners?: BindListeners<TValues>;
+}
+/**
+ * A class representing the Bind API. It handles the logic and interactions
+ * with exclusive selection state (like tabs, accordions, multi-step forms).
+ *
+ * This is framework-agnostic - use with a framework adapter like `@bind/react`.
+ */
+export declare class BindApi<TValues extends readonly string[]> {
+    /**
+     * The options for the bind component
+     */
+    options: BindOptions<TValues>;
+    /**
+     * The store managing the bind state
+     */
+    store: Store<BindState<TValues>>;
+    /**
+     * Constructs a new `BindApi` instance with the given options.
+     */
+    constructor(opts: BindOptions<TValues>);
+    /**
+     * Gets the current state
+     */
+    get state(): BindState<TValues>;
+    /**
+     * Sets the active value. Must be arrow function for React spread compatibility.
+     */
+    setValue: (value: TValues[number]) => void;
+    /**
+     * Updates the options. Useful for syncing options from framework hooks.
+     */
+    update: (opts: BindOptions<TValues>) => void;
+    /**
+     * Resets the active value to the default value.
+     * Optionally accepts a new default value to set before resetting.
+     * Useful for "restart wizard" or "reset to new state" use cases.
+     */
+    reset: (newDefault?: TValues[number]) => void;
+    /**
+     * Mounts the bind component. Returns a cleanup function.
+     * Used by framework adapters for lifecycle management.
+     */
+    mount: () => (() => void);
+}
+//# sourceMappingURL=BindApi.d.ts.map

package/dist/esm/BindApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BindApi.d.ts","sourceRoot":"","sources":["../../src/BindApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,OAAO,SAAS,SAAS,MAAM,EAAE;IAC3D,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,OAAO,SAAS,SAAS,MAAM,EAAE;IAC/D;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;CAClF;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,OAAO,SAAS,SAAS,MAAM,EAAE;IAC7D,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,qBAAa,OAAO,CAAC,OAAO,SAAS,SAAS,MAAM,EAAE;IACrD;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAE9B;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjC;;OAEG;gBACS,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC;IAStC;;OAEG;IACH,IAAI,KAAK,IAAI,SAAS,CAAC,OAAO,CAAC,CAE9B;IAED;;OAEG;IACH,QAAQ,GAAI,OAAO,OAAO,CAAC,MAAM,CAAC,KAAG,IAAI,CASvC;IAEF;;OAEG;IACH,MAAM,GAAI,MAAM,WAAW,CAAC,OAAO,CAAC,KAAG,IAAI,CAEzC;IAEF;;;;OAIG;IACH,KAAK,GAAI,aAAa,OAAO,CAAC,MAAM,CAAC,KAAG,IAAI,CAgB1C;IAEF;;;OAGG;IACH,KAAK,QAAO,CAAC,MAAM,IAAI,CAAC,CAKtB;CACF"}

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+export { BindApi } from "./BindApi";
+export type { BindOptions, BindState, BindListeners } from "./BindApi";
+export type { AnyBindApi } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,72 @@
+var u = Object.defineProperty;
+var h = (n, t, s) => t in n ? u(n, t, { enumerable: !0, configurable: !0, writable: !0, value: s }) : n[t] = s;
+var o = (n, t, s) => h(n, typeof t != "symbol" ? t + "" : t, s);
+import { Store as l } from "@tanstack/store";
+class v {
+  /**
+   * Constructs a new `BindApi` instance with the given options.
+   */
+  constructor(t) {
+    /**
+     * The options for the bind component
+     */
+    o(this, "options");
+    /**
+     * The store managing the bind state
+     */
+    o(this, "store");
+    /**
+     * Sets the active value. Must be arrow function for React spread compatibility.
+     */
+    o(this, "setValue", (t) => {
+      var e, i;
+      const s = this.store.state.value;
+      this.store.setState((a) => ({
+        ...a,
+        value: t
+      })), s !== t && ((i = (e = this.options.listeners) == null ? void 0 : e.onChange) == null || i.call(e, { value: t, bindApi: this }));
+    });
+    /**
+     * Updates the options. Useful for syncing options from framework hooks.
+     */
+    o(this, "update", (t) => {
+      this.options = t;
+    });
+    /**
+     * Resets the active value to the default value.
+     * Optionally accepts a new default value to set before resetting.
+     * Useful for "restart wizard" or "reset to new state" use cases.
+     */
+    o(this, "reset", (t) => {
+      var i, a;
+      t !== void 0 && (this.options = {
+        ...this.options,
+        defaultValue: t
+      });
+      const s = this.store.state.value, e = this.options.defaultValue;
+      this.store.setState((r) => ({
+        ...r,
+        value: e
+      })), s !== e && ((a = (i = this.options.listeners) == null ? void 0 : i.onChange) == null || a.call(i, { value: e, bindApi: this }));
+    });
+    /**
+     * Mounts the bind component. Returns a cleanup function.
+     * Used by framework adapters for lifecycle management.
+     */
+    o(this, "mount", () => () => {
+    });
+    this.options = t, this.store = new l({
+      value: t.defaultValue,
+      values: t.values
+    });
+  }
+  /**
+   * Gets the current state
+   */
+  get state() {
+    return this.store.state;
+  }
+}
+export {
+  v as BindApi
+};

package/dist/esm/types.d.ts

@@ -0,0 +1,5 @@
+/**
+ * A type representing the BindApi with all generics set to `any` for convenience.
+ */
+export type AnyBindApi = import("./BindApi").BindApi<readonly string[]>;
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,EAAE,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+	"name": "@bind-ts/bind-core",
+	"version": "0.0.1",
+	"description": "Type-safe, framework-agnostic state management for compound components",
+	"author": "",
+	"license": "MIT",
+	"type": "module",
+	"types": "dist/esm/index.d.ts",
+	"main": "dist/cjs/index.cjs",
+	"module": "dist/esm/index.js",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/esm/index.d.ts",
+				"default": "./dist/esm/index.js"
+			},
+			"require": {
+				"types": "./dist/cjs/index.d.cts",
+				"default": "./dist/cjs/index.cjs"
+			}
+		},
+		"./package.json": "./package.json"
+	},
+	"sideEffects": false,
+	"files": [
+		"dist",
+		"src",
+		"!**/__tests__"
+	],
+	"scripts": {
+		"build": "vite build && tsc --emitDeclarationOnly --outDir dist/esm",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"check-types": "tsc --noEmit"
+	},
+	"dependencies": {
+		"@tanstack/store": "^0.7.7"
+	},
+	"devDependencies": {
+		"typescript": "^5.9.2",
+		"vite": "^6.3.5",
+		"vitest": "^3.2.4"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}

package/src/BindApi.ts

@@ -0,0 +1,120 @@
+import { Store } from "@tanstack/store";
+
+/**
+ * The state shape managed by BindApi
+ */
+export interface BindState<TValues extends readonly string[]> {
+	value: TValues[number];
+	values: TValues;
+}
+
+/**
+ * Listener callbacks for BindApi events
+ */
+export interface BindListeners<TValues extends readonly string[]> {
+	/**
+	 * Called when the value changes via setValue or reset
+	 */
+	onChange?: (props: { value: TValues[number]; bindApi: BindApi<TValues> }) => void;
+}
+
+/**
+ * Options for creating a BindApi instance
+ */
+export interface BindOptions<TValues extends readonly string[]> {
+	defaultValue: TValues[number];
+	values: TValues;
+	listeners?: BindListeners<TValues>;
+}
+
+/**
+ * A class representing the Bind API. It handles the logic and interactions
+ * with exclusive selection state (like tabs, accordions, multi-step forms).
+ *
+ * This is framework-agnostic - use with a framework adapter like `@bind/react`.
+ */
+export class BindApi<TValues extends readonly string[]> {
+	/**
+	 * The options for the bind component
+	 */
+	options: BindOptions<TValues>;
+
+	/**
+	 * The store managing the bind state
+	 */
+	store: Store<BindState<TValues>>;
+
+	/**
+	 * Constructs a new `BindApi` instance with the given options.
+	 */
+	constructor(opts: BindOptions<TValues>) {
+		this.options = opts;
+
+		this.store = new Store<BindState<TValues>>({
+			value: opts.defaultValue,
+			values: opts.values,
+		});
+	}
+
+	/**
+	 * Gets the current state
+	 */
+	get state(): BindState<TValues> {
+		return this.store.state;
+	}
+
+	/**
+	 * Sets the active value. Must be arrow function for React spread compatibility.
+	 */
+	setValue = (value: TValues[number]): void => {
+		const prevValue = this.store.state.value;
+		this.store.setState((prev) => ({
+			...prev,
+			value: value,
+		}));
+		if (prevValue !== value) {
+			this.options.listeners?.onChange?.({ value, bindApi: this });
+		}
+	};
+
+	/**
+	 * Updates the options. Useful for syncing options from framework hooks.
+	 */
+	update = (opts: BindOptions<TValues>): void => {
+		this.options = opts;
+	};
+
+	/**
+	 * Resets the active value to the default value.
+	 * Optionally accepts a new default value to set before resetting.
+	 * Useful for "restart wizard" or "reset to new state" use cases.
+	 */
+	reset = (newDefault?: TValues[number]): void => {
+		if (newDefault !== undefined) {
+			this.options = {
+				...this.options,
+				defaultValue: newDefault,
+			};
+		}
+		const prevValue = this.store.state.value;
+		const nextValue = this.options.defaultValue;
+		this.store.setState((prev) => ({
+			...prev,
+			value: nextValue,
+		}));
+		if (prevValue !== nextValue) {
+			this.options.listeners?.onChange?.({ value: nextValue, bindApi: this });
+		}
+	};
+
+	/**
+	 * Mounts the bind component. Returns a cleanup function.
+	 * Used by framework adapters for lifecycle management.
+	 */
+	mount = (): (() => void) => {
+		// Currently no setup needed, but provides hook for future functionality
+		return () => {
+			// Cleanup
+		};
+	};
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export { BindApi } from "./BindApi";
+export type { BindOptions, BindState, BindListeners } from "./BindApi";
+export type { AnyBindApi } from "./types";

package/src/types.ts

@@ -0,0 +1,4 @@
+/**
+ * A type representing the BindApi with all generics set to `any` for convenience.
+ */
+export type AnyBindApi = import("./BindApi").BindApi<readonly string[]>;