decantr 0.9.0

package/src/registry/core.json

@@ -0,0 +1,216 @@
+{
+  "$schema": "https://decantr.ai/schemas/module.v1.json",
+  "module": "decantr/core",
+  "description": "DOM engine — hyperscript rendering, conditional, list, mount, lifecycle",
+  "functions": {
+    "h": {
+      "params": [
+        {
+          "name": "tag",
+          "type": "string"
+        },
+        {
+          "name": "props",
+          "type": "Object|null"
+        },
+        {
+          "name": "children",
+          "type": "...(string|number|Node|Function)"
+        }
+      ],
+      "returns": "HTMLElement"
+    },
+    "text": {
+      "params": [
+        {
+          "name": "getter",
+          "type": "Function"
+        }
+      ],
+      "returns": "Text"
+    },
+    "cond": {
+      "params": [
+        {
+          "name": "condition",
+          "type": "Function"
+        },
+        {
+          "name": "thenFn",
+          "type": "Function"
+        },
+        {
+          "name": "elseFn",
+          "type": "Function",
+          "optional": true
+        }
+      ],
+      "returns": "HTMLElement"
+    },
+    "list": {
+      "params": [
+        {
+          "name": "itemsGetter",
+          "type": "Function"
+        },
+        {
+          "name": "keyFn",
+          "type": "Function"
+        },
+        {
+          "name": "renderFn",
+          "type": "Function"
+        }
+      ],
+      "returns": "HTMLElement"
+    },
+    "mount": {
+      "params": [
+        {
+          "name": "root",
+          "type": "HTMLElement"
+        },
+        {
+          "name": "component",
+          "type": "Function"
+        }
+      ]
+    },
+    "unmount": {
+      "params": [
+        {
+          "name": "root",
+          "type": "HTMLElement"
+        }
+      ],
+      "description": "Unmount a previously mounted component tree."
+    },
+    "setErrorHandler": {
+      "params": [
+        {
+          "name": "fn",
+          "type": "(info: { error: Error, component: string|null, stack: string|null, context: Object }) => void"
+        }
+      ],
+      "description": "Set a global error telemetry handler. Called whenever an ErrorBoundary catches an error."
+    },
+    "_getErrorHandler": {
+      "returns": "Function|null",
+      "description": "Get the current error telemetry handler (for testing/internal use)."
+    },
+    "_getBoundaryHandler": {
+      "returns": "Function|null",
+      "description": "Get the current boundary error handler (used by effect patching)."
+    },
+    "ErrorBoundary": {
+      "params": [
+        {
+          "name": "props",
+          "type": "Object"
+        },
+        {
+          "name": "props.fallback",
+          "type": "Function"
+        },
+        {
+          "name": "children",
+          "type": "...Node"
+        }
+      ],
+      "returns": "HTMLElement",
+      "description": "Error catching component. Wraps children in try/catch during render. Also catches errors thrown inside createEffect within its subtree."
+    },
+    "Portal": {
+      "params": [
+        {
+          "name": "props",
+          "type": "Object"
+        },
+        {
+          "name": "props.target",
+          "type": "HTMLElement|string",
+          "optional": true
+        },
+        {
+          "name": "children",
+          "type": "...Node"
+        }
+      ],
+      "returns": "Comment",
+      "description": "Render children outside the component tree into a target element."
+    },
+    "Suspense": {
+      "params": [
+        {
+          "name": "props",
+          "type": "Object"
+        },
+        {
+          "name": "props.fallback",
+          "type": "Function"
+        },
+        {
+          "name": "children",
+          "type": "...Node"
+        }
+      ],
+      "returns": "HTMLElement",
+      "description": "Async boundary. Shows fallback while any createQuery() in children is loading."
+    },
+    "Transition": {
+      "params": [
+        {
+          "name": "props",
+          "type": "Object"
+        },
+        {
+          "name": "props.enter",
+          "type": "string",
+          "optional": true
+        },
+        {
+          "name": "props.exit",
+          "type": "string",
+          "optional": true
+        },
+        {
+          "name": "props.duration=200",
+          "type": "number",
+          "optional": true
+        },
+        {
+          "name": "child",
+          "type": "Function"
+        }
+      ],
+      "returns": "HTMLElement",
+      "description": "Enter/exit animation wrapper for conditional content."
+    },
+    "forwardRef": {
+      "params": [
+        {
+          "name": "component",
+          "type": "Function"
+        }
+      ],
+      "returns": "Function",
+      "description": "Extract ref from props and pass it as second argument to a component."
+    },
+    "onMount": {
+      "params": [
+        {
+          "name": "fn",
+          "type": "Function"
+        }
+      ]
+    },
+    "onDestroy": {
+      "params": [
+        {
+          "name": "fn",
+          "type": "Function"
+        }
+      ]
+    }
+  }
+}

package/src/registry/css.json

@@ -0,0 +1,319 @@
+{
+  "$schema": "https://decantr.ai/schemas/module.v1.json",
+  "module": "decantr/css",
+  "description": "Atomic CSS engine + theme management",
+  "functions": {
+    "css": {
+      "params": [
+        {
+          "name": "classes",
+          "type": "...string"
+        }
+      ],
+      "returns": "string"
+    },
+    "define": {
+      "params": [
+        {
+          "name": "name",
+          "type": "string"
+        },
+        {
+          "name": "declaration",
+          "type": "string"
+        }
+      ]
+    },
+    "sanitize": {
+      "params": [
+        {
+          "name": "str",
+          "type": "string"
+        }
+      ],
+      "returns": "string",
+      "description": "Sanitizes a string for safe use in HTML attributes. Escapes <, >, \", ', & characters."
+    },
+    "setStyle": {
+      "params": [
+        {
+          "name": "id",
+          "type": "string",
+          "description": "Style ID ('clean', 'retro', or custom registered style)"
+        }
+      ],
+      "description": "Set the visual style (personality)."
+    },
+    "getStyle": {
+      "returns": "() => string"
+    },
+    "getStyleList": {
+      "returns": "{ id: string, name: string }[]"
+    },
+    "registerStyle": {
+      "params": [
+        {
+          "name": "style",
+          "type": "Object",
+          "description": "Style definition { id, name, seed, personality, typography?, overrides?, components? }"
+        }
+      ],
+      "description": "Register a custom style."
+    },
+    "mergePluginStyles": {
+      "params": [
+        {
+          "name": "pluginStyles",
+          "type": "Map<string, Object>",
+          "description": "Map of style id -> style definition"
+        }
+      ],
+      "description": "Merge a Map of plugin-provided styles into the registry. Used by the plugin system to wire addon styles without individual registerStyle calls."
+    },
+    "setMode": {
+      "params": [
+        {
+          "name": "mode",
+          "type": "'light'|'dark'|'auto'"
+        }
+      ],
+      "description": "Set color mode."
+    },
+    "getMode": {
+      "returns": "() => string"
+    },
+    "getResolvedMode": {
+      "returns": "'light'|'dark'"
+    },
+    "onModeChange": {
+      "params": [
+        {
+          "name": "fn",
+          "type": "Function",
+          "description": "Callback receiving the new resolved mode ('light'|'dark')"
+        }
+      ],
+      "returns": "Function",
+      "description": "Register a callback for mode changes (fires when resolved mode changes)."
+    },
+    "setTheme": {
+      "params": [
+        {
+          "name": "id",
+          "type": "string",
+          "description": "Style ID or legacy theme ID"
+        },
+        {
+          "name": "mode='auto'",
+          "type": "'light'|'dark'|'auto'",
+          "optional": true,
+          "description": "Color mode"
+        }
+      ],
+      "description": "Set theme — convenience API combining setStyle + setMode."
+    },
+    "getTheme": {
+      "returns": "() => string"
+    },
+    "getThemeMeta": {
+      "returns": "{ isDark: boolean, style: string, mode: string, resolvedMode: string }",
+      "description": "Get metadata about current style + mode."
+    },
+    "getThemeList": {
+      "returns": "{ id: string, name: string }[]"
+    },
+    "registerTheme": {
+      "params": [
+        {
+          "name": "theme",
+          "type": "Object",
+          "description": "Old theme object or new style object"
+        }
+      ],
+      "description": "Legacy registerTheme — wraps registerStyle."
+    },
+    "setShape": {
+      "params": [
+        {
+          "name": "shape",
+          "type": "string|null",
+          "description": "'sharp', 'rounded', 'pill', or null for style default"
+        }
+      ],
+      "description": "Set the shape (border-radius preset), independent of style."
+    },
+    "getShape": {
+      "returns": "() => string|null"
+    },
+    "getShapeList": {
+      "returns": "{ id: string, label: string }[]"
+    },
+    "setColorblindMode": {
+      "params": [
+        {
+          "name": "type",
+          "type": "'off'|'protanopia'|'deuteranopia'|'tritanopia'"
+        }
+      ],
+      "description": "Set colorblind mode. Transforms seed colors and chart palettes for CVD safety. Orthogonal to style × mode × shape — all four axes are independent."
+    },
+    "getColorblindMode": {
+      "returns": "() => string"
+    },
+    "getActiveCSS": {
+      "returns": "string"
+    }
+  },
+  "fieldTokens": {
+    "description": "Unified visual system for all form field containers (.d-field base class)",
+    "tokens": [
+      "--d-field-bg",
+      "--d-field-bg-hover",
+      "--d-field-bg-disabled",
+      "--d-field-bg-readonly",
+      "--d-field-border",
+      "--d-field-border-hover",
+      "--d-field-border-focus",
+      "--d-field-border-error",
+      "--d-field-border-success",
+      "--d-field-border-disabled",
+      "--d-field-border-width",
+      "--d-field-ring",
+      "--d-field-ring-error",
+      "--d-field-ring-success",
+      "--d-field-radius",
+      "--d-field-placeholder"
+    ],
+    "variants": [
+      "d-field-outlined",
+      "d-field-filled",
+      "d-field-ghost"
+    ],
+    "states": [
+      "hover",
+      "focus-within",
+      "data-error",
+      "data-success",
+      "aria-disabled",
+      "readonly"
+    ]
+  },
+  "interactiveStateTokens": {
+    "description": "Semantic tokens for item hover, selection, and disabled states",
+    "tokens": [
+      "--d-item-hover-bg",
+      "--d-item-active-bg",
+      "--d-selected-bg",
+      "--d-selected-fg",
+      "--d-selected-border",
+      "--d-disabled-opacity",
+      "--d-disabled-opacity-soft",
+      "--d-icon-muted",
+      "--d-icon-subtle"
+    ]
+  },
+  "chromeTokens": {
+    "description": "Inverted chrome tokens for header/sidebar navigation. Dark in light mode, blended in dark mode.",
+    "tokens": [
+      "--d-chrome-bg",
+      "--d-chrome-fg",
+      "--d-chrome-border",
+      "--d-chrome-muted",
+      "--d-chrome-hover",
+      "--d-chrome-active"
+    ]
+  },
+  "overlayTokens": {
+    "description": "Three overlay intensity levels for modal backdrops and scrims",
+    "tokens": [
+      "--d-overlay",
+      "--d-overlay-light",
+      "--d-overlay-heavy"
+    ]
+  },
+  "tableTokens": {
+    "description": "Semantic tokens for table styling",
+    "tokens": [
+      "--d-table-stripe-bg",
+      "--d-table-header-bg",
+      "--d-table-hover-bg",
+      "--d-table-selected-bg"
+    ]
+  },
+  "scrollbarTokens": {
+    "description": "Custom scrollbar styling tokens",
+    "tokens": [
+      "--d-scrollbar-w",
+      "--d-scrollbar-track",
+      "--d-scrollbar-thumb",
+      "--d-scrollbar-thumb-hover"
+    ]
+  },
+  "skeletonTokens": {
+    "description": "Skeleton loading state tokens",
+    "tokens": [
+      "--d-skeleton-bg",
+      "--d-skeleton-shine"
+    ]
+  },
+  "layoutTokens": {
+    "description": "Layout dimension tokens for content areas, sidebars, and drawers",
+    "tokens": [
+      "--d-prose-width",
+      "--d-content-width-prose",
+      "--d-content-width-standard",
+      "--d-sidebar-width-sm",
+      "--d-sidebar-width",
+      "--d-sidebar-width-lg",
+      "--d-drawer-width",
+      "--d-drawer-bottom-max-h"
+    ]
+  },
+  "pseudoClassPrefixes": {
+    "description": "Pseudo-class prefixes that compose with any atom",
+    "prefixes": {
+      "_h:": "hover",
+      "_f:": "focus",
+      "_fv:": "focus-visible",
+      "_a:": "active",
+      "_fw:": "focus-within"
+    },
+    "examples": [
+      "_h:bgprimary",
+      "_f:bcprimary",
+      "_fv:ring2",
+      "_a:bgmuted",
+      "_fw:bcprimary",
+      "_sm:h:bgmuted"
+    ]
+  },
+  "ringAtoms": {
+    "description": "Focus indicator ring utilities using --d-ring token",
+    "atoms": [
+      "_ring0",
+      "_ring1",
+      "_ring2",
+      "_ring4",
+      "_ringPrimary",
+      "_ringAccent",
+      "_ringBorder"
+    ]
+  },
+  "transitionAtoms": {
+    "description": "Transition-property shortcut atoms",
+    "atoms": [
+      "_transColors",
+      "_transOpacity",
+      "_transTransform",
+      "_transShadow"
+    ]
+  },
+  "componentClassAtoms": {
+    "description": "Atoms that map to component CSS classes",
+    "atoms": {
+      "_prose": "d-prose",
+      "_divideY": "d-divide-y",
+      "_divideX": "d-divide-x"
+    }
+  }
+}

package/src/registry/data.json

@@ -0,0 +1,135 @@
+{
+  "$schema": "https://decantr.ai/schemas/module.v1.json",
+  "module": "decantr/data",
+  "description": "Data layer — query cache, entity management, URL state, realtime, persistence, workers",
+  "categories": {
+    "query": {
+      "description": "Server state management with caching, deduplication, and stale-while-revalidate",
+      "exports": ["createQuery", "createInfiniteQuery", "createMutation", "queryClient"]
+    },
+    "entity": {
+      "description": "Normalized entity collections with per-entity reactivity",
+      "exports": ["createEntityStore"]
+    },
+    "url": {
+      "description": "URL-as-state with type-safe parsers and routing-mode awareness",
+      "exports": ["createURLSignal", "createURLStore", "parsers"]
+    },
+    "realtime": {
+      "description": "WebSocket and EventSource with auto-reconnect",
+      "exports": ["createWebSocket", "createEventSource"]
+    },
+    "persistence": {
+      "description": "Offline-first primitives — storage, IndexedDB, cross-tab sync, offline queue",
+      "exports": ["createPersisted", "createIndexedDB", "createCrossTab", "createOfflineQueue"]
+    },
+    "worker": {
+      "description": "Web Worker integration for off-main-thread computation",
+      "exports": ["createWorkerSignal", "createWorkerQuery"]
+    }
+  },
+  "functions": {
+    "createQuery": {
+      "params": [
+        { "name": "key", "type": "string | (() => string)" },
+        { "name": "fetcher", "type": "(ctx: { key, signal }) => Promise<T>" },
+        { "name": "options", "type": "QueryOptions<T>", "optional": true }
+      ],
+      "returns": "{ data, status, error, isLoading, isStale, isFetching, refetch, setData }"
+    },
+    "createInfiniteQuery": {
+      "params": [
+        { "name": "key", "type": "string | (() => string)" },
+        { "name": "fetcher", "type": "(ctx: { key, pageParam, signal }) => Promise<T>" },
+        { "name": "options", "type": "InfiniteQueryOptions<T>", "optional": true }
+      ],
+      "returns": "{ pages, allItems, hasNextPage, fetchNextPage, isFetchingNextPage, refetch }"
+    },
+    "createMutation": {
+      "params": [
+        { "name": "mutationFn", "type": "(vars: V) => Promise<T>" },
+        { "name": "options", "type": "MutationOptions", "optional": true }
+      ],
+      "returns": "{ mutate, mutateAsync, isLoading, error, data, reset }"
+    },
+    "queryClient": {
+      "type": "singleton",
+      "methods": ["invalidate", "prefetch", "setCache", "getCache", "clear"]
+    },
+    "createEntityStore": {
+      "params": [
+        { "name": "options", "type": "{ getId: (entity: T) => any }" }
+      ],
+      "returns": "EntityStore<T>"
+    },
+    "createURLSignal": {
+      "params": [
+        { "name": "key", "type": "string" },
+        { "name": "parser", "type": "Parser<T>" },
+        { "name": "options", "type": "{ defaultValue?, push? }", "optional": true }
+      ],
+      "returns": "[() => T, (v: T) => void]"
+    },
+    "createURLStore": {
+      "params": [
+        { "name": "schema", "type": "Record<string, { parser, defaultValue }>" }
+      ],
+      "returns": "{ ...getters, ...setters, values(), reset() }"
+    },
+    "createWebSocket": {
+      "params": [
+        { "name": "url", "type": "string" },
+        { "name": "options", "type": "WebSocketOptions", "optional": true }
+      ],
+      "returns": "{ lastMessage, messages, status, send, close, reconnect, on }"
+    },
+    "createEventSource": {
+      "params": [
+        { "name": "url", "type": "string" },
+        { "name": "options", "type": "{ events?, withCredentials? }", "optional": true }
+      ],
+      "returns": "{ lastEvent, status, close, on }"
+    },
+    "createPersisted": {
+      "params": [
+        { "name": "key", "type": "string" },
+        { "name": "init", "type": "T" },
+        { "name": "options", "type": "{ storage?, serialize?, deserialize? }", "optional": true }
+      ],
+      "returns": "[() => T, (v: T) => void]"
+    },
+    "createIndexedDB": {
+      "params": [
+        { "name": "dbName", "type": "string" },
+        { "name": "storeName", "type": "string" }
+      ],
+      "returns": "{ get, set, delete, getAll, clear }"
+    },
+    "createCrossTab": {
+      "params": [
+        { "name": "channel", "type": "string" },
+        { "name": "signal", "type": "[getter, setter]" }
+      ],
+      "returns": "() => void"
+    },
+    "createOfflineQueue": {
+      "params": [
+        { "name": "options", "type": "{ process, persist?, key?, retryDelay? }" }
+      ],
+      "returns": "{ add, pending, isOnline, flush }"
+    },
+    "createWorkerSignal": {
+      "params": [
+        { "name": "worker", "type": "Worker" }
+      ],
+      "returns": "{ result, busy, error, send, terminate }"
+    },
+    "createWorkerQuery": {
+      "params": [
+        { "name": "worker", "type": "Worker" },
+        { "name": "input", "type": "(() => any) | any" }
+      ],
+      "returns": "{ data, loading, error, refetch }"
+    }
+  }
+}

package/src/registry/foundations.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://decantr.ai/schemas/foundations.v1.json",
+  "description": "Foundation modules — core framework capabilities",
+  "subsections": {
+    "core": { "label": "Core", "module": "decantr/core", "registry": "core.json" },
+    "state": { "label": "State", "module": "decantr/state", "registry": "state.json" },
+    "data": { "label": "Data", "module": "decantr/data", "registry": "data.json" },
+    "router": { "label": "Router", "module": "decantr/router", "registry": "router.json" },
+    "forms": { "label": "Forms", "module": "decantr/form" }
+  }
+}