@makinbakin/sdk 0.0.1-rc.20 → 0.0.1-rc.21

package/hooks/router.d.ts

@@ -1,10 +1,10 @@
 /**
- * `NavigateOptions` accepts `{ scroll?: boolean }` for call-site
- * readability; TanStack preserves scroll by default, so the flag is
- * accepted-and-ignored.
+ * `{ scroll?: boolean }` maps to TanStack's `resetScroll` (PR3 3.3):
+ * `push` scrolls to top unless `scroll: false`; `replace` is a state tweak
+ * (filters, drawers) and always keeps the scroll position.
  */
 interface Router {
-    push: (url: string, _opts?: {
+    push: (url: string, opts?: {
         scroll?: boolean;
     }) => void;
     replace: (url: string, _opts?: {
@@ -16,6 +16,22 @@ interface Router {
     /** No-op — TanStack prefetches on intent via `defaultPreload`. */
     prefetch: (_url: string) => void;
 }
+interface StringNavigationOptions {
+    to: string;
+    search: Record<string, string>;
+    hash: string;
+}
+/**
+ * Split a browser-style app URL into TanStack's pathname/search/hash fields.
+ * Passing the whole string as `to` makes typed dynamic routes discard their
+ * query string, so the shared string router must preserve those fields
+ * explicitly.
+ *
+ * Values pass through as RAW STRINGS — the host router uses plain-string
+ * serializers (packages/host/src/lib/search-params.ts), so nothing here
+ * needs to counteract JSON quoting, and "123"-shaped ids never coerce.
+ */
+export declare function toNavigationOptions(url: string): StringNavigationOptions;
 /**
  * `useRouter()` over TanStack Router. Accepts plain URL strings and
  * bypasses TanStack's typed-path safety on purpose — plugin authors

package/index.d.ts

@@ -7,6 +7,9 @@
  * hooks, and components stay on sub-paths (`/ui`, `/hooks`, `/components`,
  * `/slots`) to keep the top-level namespace from exploding.
  *
+ * This entry is AUTHOR API ONLY. The host shell's registry/lazy-loading
+ * plumbing lives on `@makinbakin/sdk/internal` and is not a public contract.
+ *
  * Sub-paths:
  *   - `@makinbakin/sdk/ui`         — shadcn UI primitives (Button, Card, Dialog, ...)
  *   - `@makinbakin/sdk/hooks`      — React hooks (useAgent, useSSE, useSearch, ...)
@@ -14,6 +17,7 @@
  *   - `@makinbakin/sdk/slots`      — Slot + registerSlot primitive
  *   - `@makinbakin/sdk/types`      — full type re-exports
  *   - `@makinbakin/sdk/metadata`   — docs-aware contract helpers
+ *   - `@makinbakin/sdk/testing`    — plugin test harness (createTestContext, ...)
  *
  * Plugin authors: at build time, mark `@makinbakin/sdk`, `@makinbakin/sdk/*`, and
  * `react`/`react-dom` as externals. At runtime the browser's import map
@@ -24,62 +28,13 @@
 export * from './types/index';
 /** Register a plugin (single-call entry from a plugin's `client.tsx`). */
 export { registerPlugin } from './register';
-/** Tear down all registrations owned by a plugin (used during hot-swap). */
-export { unregisterPlugin } from './register';
 /** Register a cleanup callback fired when the plugin is unregistered. */
 export { registerPluginCleanup } from './register';
-/** Current registry version — bumps on every mutation (for useSyncExternalStore). */
-export { getRegistryVersion } from './register';
-/** Subscribe to registry-version changes. */
-export { subscribeRegistry } from './register';
-/** Get every registered nav item across all plugins. */
-export { getAllNavItems } from './register';
-/** Get a snapshot of the current nav items (non-subscribing). */
-export { getNavItemsSnapshot } from './register';
-/** Get nav items contributed by a specific plugin. */
-export { getPluginNavItems } from './register';
 /** Set or clear a runtime badge on a plugin-owned nav item. */
 export { setNavBadge } from './register';
 /** Read the current badge for a nav item, or undefined if none. */
 export { getNavBadge } from './register';
-/** Stable snapshot of every active nav badge keyed by navItemId. */
-export { getNavBadgesSnapshot } from './register';
-/** Subscribe to nav-badge mutations (separate channel from `subscribeRegistry`). */
-export { subscribeNavBadges } from './register';
-/** Look up a specific client route by plugin id + path. */
-export { getPluginRoute } from './register';
-/** Get all registered client routes (across all plugins). */
-export { getPluginRoutes } from './register';
-/** Seed a plugin's declarative nav from its manifest (host-side; survives unregisterPlugin). */
-export { setManifestNav } from './register';
-/** Read the manifest nav currently seeded for a plugin (drift validation). */
-export { getManifestNav } from './register';
-export type { ClientRouteEntry, MatchedPluginRoute, NavItem, PluginRegistration } from './register';
-/** Install the manifest-derived slot/route ownership index for lazy loading (host-side). */
-export { configureLazyPlugins } from './lazy/index';
-/** Install the demand loader that imports a plugin's client bundle (host-side). */
-export { setLazyPluginLoader } from './lazy/index';
-/** Report a plugin client's load progress: idle → loading → loaded | error (host-side). */
-export { setPluginLoadState } from './lazy/index';
-/** Current load state for a plugin client. Unknown plugins report 'idle'. */
-export { getPluginLoadState } from './lazy/index';
-/** Last load error message for a plugin whose state is 'error', if any. */
-export { getPluginLoadError } from './lazy/index';
-/** Plugins whose manifests declare the given slot in `contributes.slots`. */
-export { getSlotOwners } from './lazy/index';
-/** Plugins whose manifest `contributes.routes` patterns match a pathname. */
-export { getRouteOwners } from './lazy/index';
-/** Ask the host to lazy-load every idle plugin that fills the named slot. */
-export { requestSlotPlugins } from './lazy/index';
-/** Ask the host to lazy-load every idle plugin whose route patterns match the pathname. */
-export { requestRoutePlugins } from './lazy/index';
-/** Reset a failed plugin to idle and re-request its client bundle. */
-export { retryPluginLoad } from './lazy/index';
-/** Monotonic lazy-store version for useSyncExternalStore consumers. */
-export { getLazyPluginsVersion } from './lazy/index';
-/** Subscribe to lazy-plugin store mutations. Returns an unsubscribe fn. */
-export { subscribeLazyPlugins } from './lazy/index';
-export type { LazyPluginIndex, PluginLoadState } from './lazy/index';
+export type { NavItem, PluginRegistration } from './register';
 /** Define a plugin HTTP route with typed input/output schemas. */
 export { defineRoute } from './routing/index';
 /** Define a core (non-plugin) HTTP route. */