@inglorious/web 4.0.9 → 4.0.10

package/README.md

@@ -96,8 +96,15 @@ This framework is ideal for both small apps and large business UIs.
 ## When NOT to Use Inglorious Web
 
 - You're frequently mutating thousands of items without virtualization (though our `list` component handles this elegantly)
-- You're building a library that needs to be framework-agnostic
-- Your team is already deeply invested in React/Vue/Angular
+- You need framework-agnostic components for users who might not use Inglorious (use Web Components instead)
+- Your team is already deeply invested in React/Vue/Angular and migration costs outweigh benefits
+
+## When Inglorious Web EXCELS
+
+- Building **internal component libraries** - Types are more customizable than React components
+- Creating **design systems** - Spread, override, and compose behaviors freely
+- Building **pattern libraries** - Ship pre-configured entity types that users can adapt
+- Apps where **predictable state flow** matters more than ecosystem size
 
 ---
 
@@ -145,14 +152,16 @@ This makes it especially suitable for:
 
 ### TL;DR Quick Comparison
 
-| Framework      | Reactivity     | Compiler | Component State | Bundle Size | Learning Curve |
-| -------------- | -------------- | -------- | --------------- | ----------- | -------------- |
-| Inglorious Web | Event-based    | None     | No (store only) | Tiny        | Very Low       |
-| React          | VDOM diffing   | None     | Yes             | Large       | Medium/High    |
-| Vue            | Proxy-based    | Optional | Yes             | Medium      | Medium         |
-| Svelte         | Compiler magic | Required | Yes             | Small       | Medium         |
-| SolidJS        | Fine signals   | None     | No (runs once)  | Tiny        | Medium/High    |
-| Qwik           | Resumable      | Required | Yes             | Small       | Very High      |
+| Framework      | Reactivity     | Build Transform  | Runtime Compiler | Component State | Bundle Size | Learning Curve |
+| -------------- | -------------- | ---------------- | ---------------- | --------------- | ----------- | -------------- |
+| Inglorious Web | Event-based    | None required    | No               | No (store only) | Tiny        | Very Low       |
+| React          | VDOM diffing   | JSX + optional\* | No               | Yes             | Large       | Medium/High    |
+| Vue            | Proxy-based    | SFC (optional)   | Available        | Yes             | Medium      | Medium         |
+| Svelte         | Compiler magic | Required         | No               | Yes             | Small       | Medium         |
+| SolidJS        | Fine signals   | JSX only         | No               | No (runs once)  | Tiny        | Medium/High    |
+| Qwik           | Resumable      | Required         | No               | Yes             | Small       | Very High      |
+
+\*React Compiler (stable 2024+) provides automatic memoization
 
 <details>
 <summary><strong>Click to expand detailed framework comparisons</strong></summary>
@@ -1299,6 +1308,86 @@ See `src/list.js` in the package for the implementation details and the `example
 
 ---
 
+## Building Component Libraries with Inglorious Web
+
+**Inglorious types are uniquely suited for component libraries** because they're fully customizable through JavaScript's spread operator.
+
+### The Pattern
+
+**Library publishes types:**
+
+```javascript
+// @acme/design-system/table.js
+export const table = {
+  render(entity, api) {
+    const type = api.getType(entity.type)
+
+    return html`
+      <table>
+        ${entity.data.map((row) => type.renderRow(entity, row, api))}
+      </table>
+    `
+  },
+
+  renderRow(entity, row, api) {
+    return html`<tr>
+      ${row.name}
+    </tr>`
+  },
+
+  rowClick(entity, row) {
+    entity.selectedRow = row
+  },
+}
+```
+
+**Users customize freely:**
+
+```javascript
+import { table } from "@acme/design-system/table"
+
+// Use as-is
+const simpleTable = { ...table }
+
+// Override methods
+const customTable = {
+  ...table,
+  renderRow(entity, row, api) {
+    return html`<tr class="custom">
+      ${row.name} - ${row.email}
+    </tr>`
+  },
+}
+
+// Compose with behaviors
+import { sortable, exportable } from "@acme/design-system/behaviors"
+
+const advancedTable = [
+  table,
+  sortable,
+  exportable,
+  {
+    rowClick(entity, row) {
+      console.log("Custom click handler", row)
+    },
+  },
+]
+```
+
+### Why This Is Better Than React Components
+
+| Feature                    | React Components               | Inglorious Types                          |
+| -------------------------- | ------------------------------ | ----------------------------------------- |
+| Customize rendering        | Only if `render` prop exposed  | Override `render()` method directly       |
+| Customize behavior         | Only if callback props exposed | Override any method                       |
+| Compose multiple libraries | Wrapper hell / HOCs            | Array composition `[type1, type2, {...}]` |
+| Access internals           | Private - must fork            | Public - spread and override              |
+| Type safety                | Props interface                | Entity schema + method signatures         |
+
+**Users get complete control** without forking your library. They can override rendering, behavior, or both—down to individual methods.
+
+---
+
 ## Using Third-Party Web Components
 
 Inglorious Web works seamlessly with any Web Component library, such as Shoelace, Material Web Components, or Lion. Thanks to lit-html's efficient diffing algorithm, Web Components maintain their internal state even when the full tree re-renders - the component only updates when its properties change.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inglorious/web",
-  "version": "4.0.9",
+  "version": "4.0.10",
   "description": "A new web framework that leverages the power of the Inglorious Store combined with the performance and simplicity of lit-html.",
   "author": "IceOnFire <antony.mistretta@gmail.com> (https://ingloriouscoderz.it)",
   "license": "MIT",
@@ -68,8 +68,8 @@
   "dependencies": {
     "@lit-labs/ssr-client": "^1.1.8",
     "lit-html": "^3.3.1",
-    "@inglorious/utils": "3.7.2",
-    "@inglorious/store": "9.0.1"
+    "@inglorious/store": "9.0.1",
+    "@inglorious/utils": "3.7.2"
   },
   "devDependencies": {
     "prettier": "^3.6.2",