@makinbakin/sdk 0.0.0-bootstrap.0

package/hooks/router.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `NavigateOptions` accepts `{ scroll?: boolean }` for call-site
+ * readability; TanStack preserves scroll by default, so the flag is
+ * accepted-and-ignored.
+ */
+interface Router {
+    push: (url: string, _opts?: {
+        scroll?: boolean;
+    }) => void;
+    replace: (url: string, _opts?: {
+        scroll?: boolean;
+    }) => void;
+    back: () => void;
+    forward: () => void;
+    refresh: () => void;
+    /** No-op — TanStack prefetches on intent via `defaultPreload`. */
+    prefetch: (_url: string) => void;
+}
+/**
+ * `useRouter()` over TanStack Router. Accepts plain URL strings and
+ * bypasses TanStack's typed-path safety on purpose — plugin authors
+ * pass paths as strings through slots.
+ */
+export declare function useRouter(): Router;
+/** Current pathname (`/tasks`, `/team/abc-123`, ...). */
+export declare function usePathname(): string;
+/**
+ * Parsed query-string as a plain `URLSearchParams` — use `.get()`,
+ * `.has()`, `.getAll()`, iteration, etc.
+ */
+export declare function useSearchParams(): URLSearchParams;
+/**
+ * Route params for the current leaf. Uses TanStack's `strict: false` mode
+ * so components rendered inside a slot (not directly via the route tree)
+ * still get usable params from the currently-matched route.
+ */
+export declare function useParams<T extends Record<string, string> = Record<string, string>>(): T;
+export {};

package/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `@bakin/sdk` — plugin author SDK.
+ *
+ * The main entry re-exports types + the single-call `registerPlugin` helper
+ * so plugin authors can write `import { registerPlugin } from '@makinbakin/sdk'`
+ * without having to remember which sub-path it lives at. UI primitives,
+ * hooks, and components stay on sub-paths (`/ui`, `/hooks`, `/components`,
+ * `/slots`) to keep the top-level namespace from exploding.
+ *
+ * Sub-paths:
+ *   - `@bakin/sdk/ui`         — shadcn UI primitives (Button, Card, Dialog, ...)
+ *   - `@bakin/sdk/hooks`      — React hooks (useAgent, useSSE, useSearch, ...)
+ *   - `@bakin/sdk/components` — shared components (PluginHeader, FacetFilter, ...)
+ *   - `@bakin/sdk/slots`      — Slot + registerSlot primitive
+ *   - `@bakin/sdk/types`      — full type re-exports
+ *   - `@bakin/sdk/metadata`   — docs-aware contract helpers
+ *
+ * Plugin authors: at build time, mark `@bakin/sdk`, `@bakin/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.
+ */
+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';
+export type { APIRoute, HttpStatus, RouteContext, PluginContextLite, CoreContext, BodySpec, ResponseSpec, ParsedInput, } from './routing/index';