@nan0web/ui 1.1.0 → 1.5.2

package/src/Component/SortableList/SortableList.js

@@ -0,0 +1,100 @@
+/**
+ * Headless Sortable List — pure data model with callbacks.
+ * Platform-agnostic: works in Node.js, browser, CLI, anywhere.
+ *
+ * @example
+ * const list = SortableList.create({
+ *   items: ['a', 'b', 'c'],
+ *   onChange: (items) => console.log(items),
+ * })
+ * list.moveUp(1) // ['b', 'a', 'c']
+ */
+class SortableList {
+	/** @type {any[]} */
+	#items
+
+	/** @type {any[]} */
+	#initial
+
+	/** @type {function|undefined} */
+	#onChange
+
+	/**
+	 * @param {object} [opts]
+	 * @param {any[]} [opts.items]
+	 * @param {function} [opts.onChange]
+	 */
+	constructor({ items = [], onChange } = {}) {
+		this.#initial = [...items]
+		this.#items = [...items]
+		this.#onChange = onChange
+	}
+
+	/**
+	 * Factory method.
+	 * @param {object} opts
+	 * @returns {SortableList}
+	 */
+	static create(opts) {
+		return new SortableList(opts)
+	}
+
+	/**
+	 * Move item at index up (swap with previous).
+	 * No-op if already at top.
+	 * @param {number} index
+	 */
+	moveUp(index) {
+		if (index <= 0 || index >= this.#items.length) return
+		const temp = this.#items[index - 1]
+		this.#items[index - 1] = this.#items[index]
+		this.#items[index] = temp
+		this.#onChange?.(this.getItems())
+	}
+
+	/**
+	 * Move item at index down (swap with next).
+	 * No-op if already at bottom.
+	 * @param {number} index
+	 */
+	moveDown(index) {
+		if (index < 0 || index >= this.#items.length - 1) return
+		const temp = this.#items[index + 1]
+		this.#items[index + 1] = this.#items[index]
+		this.#items[index] = temp
+		this.#onChange?.(this.getItems())
+	}
+
+	/**
+	 * Returns a copy of the current item order.
+	 * @returns {any[]}
+	 */
+	getItems() {
+		return [...this.#items]
+	}
+
+	/**
+	 * Move item from one position to another (drag-n-drop).
+	 * No-op if indices are equal or out of bounds.
+	 * @param {number} from - source index
+	 * @param {number} to - target index
+	 */
+	moveTo(from, to) {
+		if (from === to) return
+		if (from < 0 || from >= this.#items.length) return
+		if (to < 0 || to >= this.#items.length) return
+		const [item] = this.#items.splice(from, 1)
+		this.#items.splice(to, 0, item)
+		this.#onChange?.(this.getItems())
+	}
+
+	/**
+	 * Restores the initial order.
+	 */
+	reset() {
+		this.#items = [...this.#initial]
+		this.#onChange?.(this.getItems())
+	}
+}
+
+export default SortableList

package/src/Component/SortableList/index.js

@@ -0,0 +1,3 @@
+import SortableList from './SortableList.js'
+
+export default SortableList

package/src/Component/Welcome/Input.js

@@ -1,4 +1,4 @@
-import { User } from "../../Model/index.js"
+import { User } from '../../Model/index.js'
 
 /**
  * Represents input data for the Welcome component.
@@ -14,9 +14,7 @@ class WelcomeInput {
 	 * @param {User|object} [props.user=new User()] - User data
 	 */
 	constructor(props = {}) {
-		const {
-			user = new User(),
-		} = props
+		const { user = new User() } = props
 		this.user = user
 	}
 

package/src/Component/Welcome/Welcome.js

@@ -1,5 +1,5 @@
-import { empty } from "@nan0web/types"
-import WelcomeInput from "./Input.js"
+import { empty } from '@nan0web/types'
+import WelcomeInput from './Input.js'
 
 /**
  * Renders a welcome message for a user.
@@ -10,17 +10,13 @@ import WelcomeInput from "./Input.js"
 function Welcome(props = {}) {
 	const input = WelcomeInput.from(props)
 	if (empty(input)) {
-		throw new Error("User is required")
+		throw new Error('User is required')
 	}
 
-	return [
-		["Welcome", " ", input.user.name, "!"],
-		["What can we do today great?"],
-		[""],
-	]
+	return [['Welcome', ' ', input.user.name, '!'], ['What can we do today great?'], ['']]
 }
 
 Welcome.Input = WelcomeInput
-Welcome.ask = async () => ""
+Welcome.ask = async () => ''
 
 export default Welcome

package/src/Component/Welcome/index.js

@@ -1,5 +1,5 @@
-import Welcome from "./Welcome.js"
-import WelcomeInput from "./Input.js"
+import Welcome from './Welcome.js'
+import WelcomeInput from './Input.js'
 
 export default Welcome
 export { WelcomeInput }

package/src/Component/index.js

@@ -1,9 +1,11 @@
-import Welcome from "./Welcome/index.js"
-import Process from "./Process/index.js"
+import Welcome from './Welcome/index.js'
+import Process from './Process/index.js'
+import SortableList from './SortableList/index.js'
 
-export { Welcome, Process }
+export { Welcome, Process, SortableList }
 
 export default {
 	Welcome,
 	Process,
+	SortableList,
 }