@makolabs/ripple 3.1.1 → 3.2.0

package/dist/index.d.ts

@@ -143,7 +143,7 @@ export { CompactFilters, FilterPopover, FilterBar, syncFiltersToUrl } from './fi
 export * from './file-browser/index.js';
 export * from './adapters/storage/index.js';
 export * from './adapters/ai/index.js';
-export { getUserDisplayName, getUserInitials } from './user-management/user-management.js';
+export { getUserDisplayName, getUserInitials, adaptUserManagementRemote } from './user-management/user-management.js';
 export { default as UserManagement } from './user-management/UserManagement.svelte';
 export { default as UserTable } from './user-management/UserTable.svelte';
 export { default as UserModal } from './user-management/UserModal.svelte';

package/dist/index.js

@@ -145,7 +145,7 @@ export * from './adapters/ai/index.js';
 // ============================================================================
 // User Management Helper Functions
 // ============================================================================
-export { getUserDisplayName, getUserInitials } from './user-management/user-management.js';
+export { getUserDisplayName, getUserInitials, adaptUserManagementRemote } from './user-management/user-management.js';
 // ============================================================================
 // User Management Components
 // ============================================================================

package/dist/user-management/user-management.d.ts

@@ -2,6 +2,34 @@
  * User Management Utilities
  * Helper functions for user management
  */
-import type { User } from '../index.js';
+import type { User, UserManagementAdapter } from '../index.js';
+/**
+ * Wires a `*.remote.ts` module (typically `export * from
+ * '@makolabs/ripple/funcs/user-management.remote'`) to the strictly-typed
+ * `UserManagementAdapter` shape.
+ *
+ * Why this exists: SvelteKit ≥ 2.56 captures the inner async function's
+ * `Promise<X>` as `Output` in `RemoteCommand`'s call signature, so
+ * `command('unchecked', async (): Promise<X> => …)` types as
+ * `RemoteCommand<I, Promise<X>>` whose call returns `Promise<Promise<X>>`
+ * even though at runtime it resolves correctly to `Promise<X>`. That
+ * spurious extra wrap makes a direct `import * as adapter from
+ * './foo.remote'` reject the `UserManagementAdapter` assignment.
+ *
+ * The helper performs an `as unknown as` coercion in one place so
+ * consumers don't scatter casts in their pages, and so the workaround
+ * stays discoverable. Once SvelteKit fixes `RemoteCommand` to use
+ * `Awaited<Output>`, this helper becomes a transparent pass-through.
+ *
+ * @example
+ * ```ts
+ * // src/routes/+page.svelte
+ * import { adaptUserManagementRemote } from '@makolabs/ripple';
+ * import * as remote from './users.remote';
+ * const adapter = adaptUserManagementRemote(remote);
+ * <UserManagement {adapter} {roles} />
+ * ```
+ */
+export declare function adaptUserManagementRemote<T>(remote: T): UserManagementAdapter;
 export declare function getUserDisplayName(user: User | null): string;
 export declare function getUserInitials(user: User | null): string;

package/dist/user-management/user-management.js

@@ -2,6 +2,36 @@
  * User Management Utilities
  * Helper functions for user management
  */
+/**
+ * Wires a `*.remote.ts` module (typically `export * from
+ * '@makolabs/ripple/funcs/user-management.remote'`) to the strictly-typed
+ * `UserManagementAdapter` shape.
+ *
+ * Why this exists: SvelteKit ≥ 2.56 captures the inner async function's
+ * `Promise<X>` as `Output` in `RemoteCommand`'s call signature, so
+ * `command('unchecked', async (): Promise<X> => …)` types as
+ * `RemoteCommand<I, Promise<X>>` whose call returns `Promise<Promise<X>>`
+ * even though at runtime it resolves correctly to `Promise<X>`. That
+ * spurious extra wrap makes a direct `import * as adapter from
+ * './foo.remote'` reject the `UserManagementAdapter` assignment.
+ *
+ * The helper performs an `as unknown as` coercion in one place so
+ * consumers don't scatter casts in their pages, and so the workaround
+ * stays discoverable. Once SvelteKit fixes `RemoteCommand` to use
+ * `Awaited<Output>`, this helper becomes a transparent pass-through.
+ *
+ * @example
+ * ```ts
+ * // src/routes/+page.svelte
+ * import { adaptUserManagementRemote } from '@makolabs/ripple';
+ * import * as remote from './users.remote';
+ * const adapter = adaptUserManagementRemote(remote);
+ * <UserManagement {adapter} {roles} />
+ * ```
+ */
+export function adaptUserManagementRemote(remote) {
+    return remote;
+}
 // Export convenience function to format user display name
 export function getUserDisplayName(user) {
     if (!user)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@makolabs/ripple",
-	"version": "3.1.1",
+	"version": "3.2.0",
 	"description": "Simple Svelte 5 powered component library ✨",
 	"license": "SEE LICENSE IN LICENSE",
 	"repository": {
@@ -54,8 +54,8 @@
 		}
 	},
 	"peerDependencies": {
-		"svelte": "^5.0.0 || ^6.0.0",
-		"@sveltejs/kit": "^2.0.0"
+		"@sveltejs/kit": "^2.0.0",
+		"svelte": "^5.0.0 || ^6.0.0"
 	},
 	"devDependencies": {
 		"@eslint/compat": "^1.4.1",
@@ -66,7 +66,7 @@
 		"@storybook/addon-svelte-csf": "^5.0.10",
 		"@storybook/sveltekit": "^10.0.7",
 		"@sveltejs/adapter-static": "^3.0.10",
-		"@sveltejs/kit": "^2.48.4",
+		"@sveltejs/kit": "^2.58.0",
 		"@sveltejs/package": "^2.5.4",
 		"@sveltejs/vite-plugin-svelte": "^6.2.1",
 		"@tailwindcss/vite": "^4.1.17",