@makinbakin/sdk 0.0.1-rc.2 → 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,14 +17,28 @@
  *   - `@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
  * (emitted by Bakin) resolves those to the host's bundled copies so there
  * is a single React instance and a single SDK.
  */
+/** Re-exports every plugin contract type. See `@makinbakin/sdk/types` for the full list. */
 export * from './types/index';
-export { registerPlugin, unregisterPlugin, registerPluginCleanup, getRegistryVersion, subscribeRegistry, getAllNavItems, getNavItemsSnapshot, getPluginNavItems, getPluginRoute, getPluginRoutes, } from './register';
-export type { ClientRouteEntry, MatchedPluginRoute, NavItem, PluginRegistration } from './register';
-export { defineRoute, defineCoreRoute, definePlugin } from './routing/index';
+/** Register a plugin (single-call entry from a plugin's `client.tsx`). */
+export { registerPlugin } from './register';
+/** Register a cleanup callback fired when the plugin is unregistered. */
+export { registerPluginCleanup } 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';
+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. */
+export { defineCoreRoute } from './routing/index';
+/** Compose a plugin's routes into a single definition for the server. */
+export { definePlugin } from './routing/index';
 export type { APIRoute, HttpStatus, RouteContext, PluginContextLite, CoreContext, BodySpec, ResponseSpec, ParsedInput, } from './routing/index';