@furystack/shades 11.0.18 → 11.0.20

package/README.md

@@ -1,43 +1,42 @@
 # @furystack/shades
 
-Shades is a UI Library for FuryStack with that uses type-safe JSX component, unidirectional data binding and the same DI/IOC, logging and utility libraries as the FuryStack Backend Services.
+Shades is a UI library for FuryStack that uses type-safe JSX components, unidirectional data binding, and the same DI/IoC, logging, and utility libraries as FuryStack backend services.
 
 ## Usage
 
 You can check the [@furystack/boilerplate](https://github.com/furystack/boilerplate) repository for a working example.
 
-### A Shade (component)
+### A Shade (Component)
 
 A shade (component) can be constructed from the following properties:
 
-- `ts render:(options: RenderOptions)=>JSX.Element` - A required method that will be executed on each and every render.
-- `initialState` - A default state that can be updated during the component lifecycle
-- `shadowDomName` can be specified - that will be the custom element's name in the DOM
-- `ts constructed: (options: RenderOptions)=>void` is an optional callback that will be executed after component construction. It can return a cleanup method (e.g. free up resources, dispose value observers, etc...)
-- `ts onAttach: (options: RenderOptions)=>void` is executed when the component is attached to the DOM
-- `ts onDetach: (options: RenderOptions)=>void` is executed when the component is detached from the DOM
+- `render:(options: RenderOptions)=>JSX.Element` – A required method that will be executed on each render.
+- `initialState` – A default state that can be updated during the component lifecycle.
+- `shadowDomName` – Can be specified as the custom element's name in the DOM.
+- `constructed: (options: RenderOptions)=>void` – Optional callback executed after component construction. It can return a cleanup method (e.g., free up resources, dispose value observers, etc.).
+- `onAttach: (options: RenderOptions)=>void` – Executed when the component is attached to the DOM.
+- `onDetach: (options: RenderOptions)=>void` – Executed when the component is detached from the DOM.
 
-### Render options
+### Render Options
 
-The lifecycle methods will get the following options from a parameter:
+The lifecycle methods receive the following options as a parameter:
 
-- props - The current readonly **props** object for the element. As props are passed from the parent, it is read only
-- getState() - method that will return the current state. State object is also read only and immutable and can be updated with a corresponding method only.
-- updateState(newState: TState, skipRender?: boolean) - Updates (patches) the component state. An optional flag can indicate that this state change shouldn't trigger a re-render (e.g. form input fields change, etc...)
-- injector - An injector instance. It can be retrieved from the closest parent or can be specified on the _state_ or _props_
-- children - The children element(s) of the component
-- element - A reference to the current component's custom element (root)
-- logger - A specified _logger_ instance with a pre-defined _scope_
+- `props` – The current readonly props object for the element. As props are passed from the parent, it is read-only.
+- `getState()` – Returns the current state. The state object is also read-only and immutable and can be updated only with a corresponding method.
+- `updateState(newState: TState, skipRender?: boolean)` – Updates (patches) the component state. An optional flag can indicate that this state change shouldn't trigger a re-render (e.g., form input fields change, etc.).
+- `injector` – An injector instance. It can be retrieved from the closest parent or specified on the state or props.
+- `children` – The children element(s) of the component.
+- `element` – A reference to the current component's custom element (root).
+- `logger` – A specified logger instance with a pre-defined scope.
 
-### Bundled goodies
+### Bundled Goodies
 
-The **@furystack/shades** package contains a router component, a router-link component, a location-service and a lazy-load component.
+The **@furystack/shades** package contains a router component, a router-link component, a location service, and a lazy-load component.
 
-## Core concepts
+## Core Concepts
 
-- Shade is close to the DOM and the natives. You are encouraged to use native browser methods while you can
-- You can use small independent services for state tracking with the _injector_
-- ~~Use observable values. Subscribe in the `constructed()` method and dispose them on the callback that it returns.~~
-- You can use resources (valueobservers) that will be disposed automatically when your component will be removed from DOM.
-- Re-render **can** be skipped on state update. E.g. Why should you break a whole form with a re-render? Why should you update a complete _grid_ if only on item's one field has been changed?
-- Nothing is true, everything is permitted 🗡
+- Shade is close to the DOM and the natives. You are encouraged to use native browser methods when possible.
+- You can use small independent services for state tracking with the injector.
+- You can use resources (value observers) that will be disposed automatically when your component is removed from the DOM.
+- Re-rendering can be skipped on state update. For example, why re-render a whole form if only one field has changed?
+- Nothing is true, everything is permitted. 🗡️

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@furystack/shades",
-  "version": "11.0.18",
+  "version": "11.0.20",
   "description": "Google Authentication Provider for FuryStack",
   "type": "module",
   "scripts": {
@@ -38,15 +38,15 @@
   "homepage": "https://github.com/furystack/furystack",
   "devDependencies": {
     "@types/jsdom": "^21.1.7",
-    "@types/node": "^22.14.1",
+    "@types/node": "^22.15.30",
     "jsdom": "^26.1.0",
     "typescript": "^5.8.3",
-    "vitest": "^3.1.2"
+    "vitest": "^3.2.2"
   },
   "dependencies": {
-    "@furystack/inject": "^12.0.14",
-    "@furystack/rest": "^8.0.17",
-    "@furystack/utils": "^8.0.13",
+    "@furystack/inject": "^12.0.16",
+    "@furystack/rest": "^8.0.19",
+    "@furystack/utils": "^8.0.15",
     "path-to-regexp": "^8.2.0",
     "semaphore-async-await": "^1.5.1"
   },