@idealyst/mcp-server 1.2.16 → 1.2.18

package/dist/data/components/Button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/data/components/Button.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;CA2GlB,CAAC"}
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../src/data/components/Button.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;CAoHlB,CAAC"}

package/dist/data/components/Button.js

@@ -6,6 +6,7 @@ export const Button = {
 - \`title\`: string - The text title to display inside the button (for web)
 - \`onPress\`: function - Called when the button is pressed
 - \`disabled\`: boolean - Whether the button is disabled
+- \`loading\`: boolean - Whether the button is in a loading state. Shows a spinner and disables interaction.
 - \`type\`: ButtonType - The visual style type of the button ('contained' | 'outlined' | 'text')
 - \`intent\`: ButtonIntentVariant - The intent/color scheme of the button
 - \`size\`: ButtonSizeVariant - The size of the button
@@ -17,6 +18,7 @@ export const Button = {
         "Three type variants: contained, outlined, text",
         "Five intent colors: primary, neutral, success, error, warning",
         "Five sizes: xs, sm, md, lg, xl",
+        "Loading state with spinner (matches text color)",
         "Gradient overlay effects (darken/lighten) for contained buttons",
         "Left and right icon support with MDI icons or custom React elements",
         "Disabled states with visual feedback",
@@ -35,7 +37,7 @@ import { Button } from '@idealyst/components';
 <Button
   type="contained"
   intent="primary"
-  icon="check"
+  leftIcon="check"
   onPress={() => console.log('Pressed')}
 >
   Save Changes
@@ -56,13 +58,20 @@ import { Button } from '@idealyst/components';
 <Button type="text" intent="primary">Text</Button>`,
         "with-icons": `import { Button } from '@idealyst/components';
 
-// Button with icon
-<Button icon="check" iconPosition="left">
+// Button with left icon
+<Button leftIcon="check">
   Confirm
 </Button>
 
-// Icon-only button
-<Button icon="close" />`,
+// Button with right icon
+<Button rightIcon="arrow-right">
+  Next
+</Button>
+
+// Button with both icons
+<Button leftIcon="check" rightIcon="arrow-right">
+  Continue
+</Button>`,
         interactive: `import { Button } from '@idealyst/components';
 import { useState } from 'react';
 

package/dist/data/components/Button.js.map

@@ -1 +1 @@
-{"version":3,"file":"Button.js","sourceRoot":"","sources":["../../../src/data/components/Button.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACtB,QAAQ,EAAE,MAAM;IACZ,WAAW,EAAE,8EAA8E;IACvF,KAAK,EAAE;;;;;;;;;;;CAWd;IACG,QAAQ,EAAE;QACR,gDAAgD;QAChD,+DAA+D;QAC/D,gCAAgC;QAChC,iEAAiE;QACjE,qEAAqE;QACrE,sCAAsC;QACtC,uCAAuC;KACxC;IACD,aAAa,EAAE;QACb,uCAAuC;QACvC,+CAA+C;QAC/C,6DAA6D;QAC7D,gDAAgD;QAChD,qEAAqE;KACtE;IACD,KAAK,EAAE;;;;;;;;;;;CAWV;IACG,QAAQ,EAAE;QACR,KAAK,EAAE;;;;;UAKH;QACJ,QAAQ,EAAE;;;;;mDAKmC;QAC7C,YAAY,EAAE;;;;;;;;wBAQI;QAClB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;EAoBjB;QACI,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;UAmBN;KACL;CACJ,CAAC"}
+{"version":3,"file":"Button.js","sourceRoot":"","sources":["../../../src/data/components/Button.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACtB,QAAQ,EAAE,MAAM;IACZ,WAAW,EAAE,8EAA8E;IACvF,KAAK,EAAE;;;;;;;;;;;;CAYd;IACG,QAAQ,EAAE;QACR,gDAAgD;QAChD,+DAA+D;QAC/D,gCAAgC;QAChC,iDAAiD;QACjD,iEAAiE;QACjE,qEAAqE;QACrE,sCAAsC;QACtC,uCAAuC;KACxC;IACD,aAAa,EAAE;QACb,uCAAuC;QACvC,+CAA+C;QAC/C,6DAA6D;QAC7D,gDAAgD;QAChD,qEAAqE;KACtE;IACD,KAAK,EAAE;;;;;;;;;;;CAWV;IACG,QAAQ,EAAE;QACR,KAAK,EAAE;;;;;UAKH;QACJ,QAAQ,EAAE;;;;;mDAKmC;QAC7C,YAAY,EAAE;;;;;;;;;;;;;;;UAeV;QACJ,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;EAoBjB;QACI,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;UAmBN;KACL;CACJ,CAAC"}

package/dist/data/components/Dialog.js

@@ -7,7 +7,7 @@ export const Dialog = {
 - \`title\`: string - Optional title for the dialog
 - \`children\`: React.ReactNode - The content to display inside the dialog
 - \`size\`: DialogSizeVariant - The size of the dialog
-- \`showCloseButton\`: boolean - The visual style variant of the dialog Whether to show the close button in the header
+- \`showCloseButton\`: boolean - Whether to show the close button in the header
 - \`closeOnBackdropClick\`: boolean - Whether clicking the backdrop should close the dialog
 - \`closeOnEscapeKey\`: boolean - Whether pressing escape key should close the dialog (web only)
 - \`animationType\`: DialogAnimationType - Animation type for the dialog (native only)

package/dist/data/components/Progress.js

@@ -33,7 +33,7 @@ import { Progress } from '@idealyst/components';
 
 <Progress
   value={65}
-  type="linear"
+  variant="linear"
   intent="primary"
   showLabel
 />
@@ -45,9 +45,9 @@ import { Progress } from '@idealyst/components';
         variants: `import { Progress, View } from '@idealyst/components';
 
 <View spacing="md">
-  <Progress value={30} type="linear" intent="primary" />
-  <Progress value={60} type="linear" intent="success" />
-  <Progress value={value} type="circular" size="lg" showLabel />
+  <Progress value={30} variant="linear" intent="primary" />
+  <Progress value={60} variant="linear" intent="success" />
+  <Progress value={value} variant="circular" size="lg" showLabel />
 </View>`,
         "with-icons": `import { Progress, View, Text } from '@idealyst/components';
 

package/dist/data/components/RadioButton.js

@@ -107,7 +107,7 @@ function Example() {
         {options.map((option) => (
           <Card
             key={option.value}
-            variant={shipping === option.value ? 'outlined' : 'default'}
+            type={shipping === option.value ? 'outlined' : 'elevated'}
             padding="sm"
             clickable
             onPress={() => setShipping(option.value)}

package/dist/data/components/Select.js

@@ -10,7 +10,7 @@ export const Select = {
 - \`error\`: boolean - Whether the select shows an error state
 - \`helperText\`: string - Helper text to display below the select
 - \`label\`: string - Label text to display above the select
-- \`intent\`: SelectIntentVariant - The visual type of the select The intent/color scheme of the select
+- \`intent\`: SelectIntentVariant - The intent/color scheme of the select
 - \`size\`: SelectSizeVariant - The size of the select
 - \`margin\`: Size - Margin on all sides ('xs' | 'sm' | 'md' | 'lg' | 'xl')
 - \`marginVertical\`: Size - Top and bottom margin

package/dist/data/framework-guides.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"framework-guides.d.ts","sourceRoot":"","sources":["../../src/data/framework-guides.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA8rDlD,CAAC"}
+{"version":3,"file":"framework-guides.d.ts","sourceRoot":"","sources":["../../src/data/framework-guides.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA0sDlD,CAAC"}

package/dist/data/framework-guides.js

@@ -120,24 +120,36 @@ Idealyst provides a comprehensive library of cross-platform React components org
 - **Icon**: MDI icon with theming
 - **Skeleton**: Loading placeholder
 - **Alert**: Notification message
+- **Accordion**: Collapsible content sections
+- **Image**: Cross-platform image component
+- **SVGImage**: SVG image renderer
+- **Video**: Video player component
 
 ### Navigation Components
 - **Tabs**: Tab navigation
 - **TabBar**: Bottom tab bar
 - **Breadcrumb**: Breadcrumb navigation
 - **Menu**: Dropdown menu
+- **MenuItem**: Individual menu item
 - **List**: Vertical list with sections
+- **ListItem**: Individual list item
+- **Link**: Navigation link component
 
 ### Overlay Components
 - **Dialog**: Modal dialog
 - **Popover**: Contextual overlay
 - **Tooltip**: Hover tooltip
 
+### Feedback Components
+- **Progress**: Progress indicator (linear/circular)
+- **ActivityIndicator**: Loading spinner
+
 ### Data Components
 - **Table**: Data table with sorting and filtering
 - **DataGrid**: Advanced data grid
 - **DatePicker**: Date selection component
-- **Progress**: Progress indicator
+- **TimePicker**: Time selection component
+- **DateTimePicker**: Combined date and time picker
 
 ## Common Props
 
@@ -154,11 +166,12 @@ Components support intent-based colors:
 - \`error\`: Destructive actions
 - \`warning\`: Caution actions
 
-### Variants
-Many components offer visual variants:
-- Buttons: \`contained\`, \`outlined\`, \`text\`
-- Cards: \`default\`, \`outlined\`, \`elevated\`, \`filled\`
-- Chips: \`filled\`, \`outlined\`, \`soft\`
+### Type/Variant Props
+Many components offer visual type or variant options:
+- Button \`type\`: \`contained\`, \`outlined\`, \`text\`
+- Card \`type\`: \`default\`, \`outlined\`, \`elevated\`, \`filled\`
+- Chip \`type\`: \`filled\`, \`outlined\`, \`soft\`
+- Progress \`variant\`: \`linear\`, \`circular\`
 
 ### Sizes
 Most components support size variants:
@@ -173,8 +186,9 @@ Components with icon support accept:
 
 Example:
 \`\`\`tsx
-<Button icon="check">Save</Button>
-<Button icon={<CustomIcon />}>Save</Button>
+<Button leftIcon="check">Save</Button>
+<Button leftIcon={<CustomIcon />}>Save</Button>
+<Button rightIcon="arrow-right">Next</Button>
 \`\`\`
 
 ## Theming
@@ -438,32 +452,30 @@ idealyst create <name> --type <type> [options]
 **Options:**
 - \`--type <type>\`: Package type (required)
   - \`web\`: React web app with Vite
-  - \`native\`: React Native app
+  - \`mobile\`: React Native mobile app
   - \`api\`: tRPC API server
-  - \`database\`: Prisma database layer
   - \`shared\`: Shared utilities library
-- \`--app-name <name>\`: Display name for native apps (required for native)
-- \`--with-trpc\`: Include tRPC setup (web/native)
-- \`--no-trpc\`: Exclude tRPC setup (web/native)
+- \`--app-name <name>\`: Display name for mobile apps (required for mobile)
+- \`--with-trpc\`: Include tRPC setup (web/mobile)
+- \`--no-trpc\`: Exclude tRPC setup (web/mobile)
 
 **Examples:**
 \`\`\`bash
 # Web app
 idealyst create web --type web --with-trpc
 
-# Native app
-idealyst create mobile --type native --app-name "My App" --with-trpc
+# Mobile app
+idealyst create mobile --type mobile --app-name "My App" --with-trpc
 
 # API server
 idealyst create api --type api
 
-# Database
-idealyst create database --type database
-
 # Shared library
 idealyst create shared --type shared
 \`\`\`
 
+**Note:** The database package is automatically created during workspace initialization. Use the \`init\` command to create a new workspace with all packages including database.
+
 ## Package Types
 
 ### Web Package
@@ -474,7 +486,7 @@ idealyst create shared --type shared
 - @idealyst/components
 - @idealyst/theme
 
-### Native Package
+### Mobile Package
 - React Native 0.80
 - TypeScript
 - React Navigation

package/dist/data/framework-guides.js.map

@@ -1 +1 @@
-{"version":3,"file":"framework-guides.js","sourceRoot":"","sources":["../../src/data/framework-guides.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,sCAAsC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0FzC;IAEC,0CAA0C,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoG7C;IAEC,8BAA8B,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2LjC;IAEC,0BAA0B,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiN7B;IAEC,qCAAqC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6JxC;IAEC,mCAAmC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoFtC;IAEC,oCAAoC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuNvC;IAEC,mCAAmC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuJtC;IAEC,mCAAmC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyItC;IAEC,kCAAkC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiPrC;IAEC,uCAAuC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqI1C;CACA,CAAC"}
+{"version":3,"file":"framework-guides.js","sourceRoot":"","sources":["../../src/data/framework-guides.ts"],"names":[],"mappings":"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"}

package/dist/data/navigation-guides.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navigation-guides.d.ts","sourceRoot":"","sources":["../../src/data/navigation-guides.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmmDnD,CAAC"}
+{"version":3,"file":"navigation-guides.d.ts","sourceRoot":"","sources":["../../src/data/navigation-guides.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsqDnD,CAAC"}

package/dist/data/navigation-guides.js

@@ -56,18 +56,18 @@ function App() {
 
 ### Quick Start with Examples
 
-Use pre-built example routers for instant working navigation:
+Use the pre-built example router for instant working navigation:
 
 \`\`\`tsx
-import { ExampleStackRouter } from '@idealyst/navigation/examples';
+import { ExampleNavigationRouter } from '@idealyst/navigation/examples';
 
-<NavigatorProvider route={ExampleStackRouter} />
+<NavigatorProvider route={ExampleNavigationRouter} />
 \`\`\`
 
-Available example routers:
-- **ExampleStackRouter**: Desktop/web with header and sidebar
-- **ExampleTabRouter**: Mobile with tab navigation
-- **ExampleDrawerRouter**: Desktop with drawer menu
+The example router demonstrates:
+- Stack-based navigation structure
+- Custom web layouts with header and sidebar
+- Tab navigation for nested sections
 
 ## Platform Differences
 
@@ -161,8 +161,10 @@ navigator.navigate({
 });
 
 // Access in component:
-const navigator = useNavigator();
-const userId = navigator.vars.id;
+import { useParams } from '@idealyst/navigation';
+
+const params = useParams();
+const userId = params.id;
 \`\`\`
 
 ### Optional Parameters
@@ -922,25 +924,68 @@ navigator.navigate({ path: '/new-location', replace: true });
 - URL canonicalization/normalization
 - Redirect from deprecated routes
 
-### navigator.vars
+## useParams Hook
 
-Access current route variables:
+Access current route path parameters:
 
 \`\`\`tsx
-const navigator = useNavigator();
-const userId = navigator.vars.id;        // Path param
-const searchQuery = navigator.vars.q;    // Query param
+import { useParams } from '@idealyst/navigation';
+
+function UserScreen() {
+  const params = useParams();
+  const userId = params.id;        // Path param from /user/:id
+
+  return <Text>User ID: {userId}</Text>;
+}
 \`\`\`
 
-### navigator.currentPath
+## useNavigationState Hook
 
-Get the current route path:
+Access navigation state passed via the \`state\` property:
 
 \`\`\`tsx
-const navigator = useNavigator();
-const path = navigator.currentPath;
+import { useNavigationState } from '@idealyst/navigation';
 
-console.log(path); // "/user/123"
+// When navigating:
+navigator.navigate({
+  path: '/recording',
+  state: { autostart: true, source: 'home' }
+});
+
+// In destination screen:
+function RecordingScreen() {
+  const { autostart, source } = useNavigationState<{
+    autostart?: boolean;
+    source?: string;
+  }>();
+
+  // autostart = true, source = 'home'
+}
+\`\`\`
+
+### Consuming State (Web)
+
+Remove state from URL after reading:
+
+\`\`\`tsx
+// URL: /recording?autostart=true
+const { autostart } = useNavigationState<{ autostart?: boolean }>({
+  consume: ['autostart']
+});
+// autostart = true, URL becomes: /recording (param removed)
+\`\`\`
+
+## useLocation (React Router)
+
+Get the current route path on web:
+
+\`\`\`tsx
+import { useLocation } from '@idealyst/navigation';
+
+function MyComponent() {
+  const location = useLocation();
+  console.log(location.pathname); // "/user/123"
+}
 \`\`\`
 
 ### navigator.canGoBack()
@@ -992,9 +1037,11 @@ In route configuration:
 
 In the screen component:
 \`\`\`tsx
+import { useParams } from '@idealyst/navigation';
+
 function UserScreen() {
-  const navigator = useNavigator();
-  const userId = navigator.vars.id;
+  const params = useParams();
+  const userId = params.id;
 
   return <Text>User ID: {userId}</Text>;
 }
@@ -1003,6 +1050,8 @@ function UserScreen() {
 ### Multiple Parameters
 
 \`\`\`tsx
+import { useParams } from '@idealyst/navigation';
+
 // Route: "post/:postId/comment/:commentId"
 
 // Navigate:
@@ -1012,8 +1061,9 @@ navigator.navigate({
 });
 
 // Access:
-const postId = navigator.vars.postId;
-const commentId = navigator.vars.commentId;
+const params = useParams();
+const postId = params.postId;
+const commentId = params.commentId;
 \`\`\`
 
 ## Query Parameters
@@ -1036,12 +1086,15 @@ navigator.navigate({
 ### Reading Query Params
 
 \`\`\`tsx
-function SearchScreen() {
-  const navigator = useNavigator();
+import { useNavigationState } from '@idealyst/navigation';
 
-  const query = navigator.vars.q;
-  const category = navigator.vars.category;
-  const sort = navigator.vars.sort;
+function SearchScreen() {
+  // Query params are accessed via useNavigationState on web
+  const { q, category, sort } = useNavigationState<{
+    q?: string;
+    category?: string;
+    sort?: string;
+  }>();
 
   // Use params...
 }
@@ -1086,8 +1139,8 @@ Pass data through navigation:
 
 // Detail screen
 function ProductScreen() {
-  const navigator = useNavigator();
-  const productId = navigator.vars.id;
+  const params = useParams();
+  const productId = params.id;
 
   const product = useProduct(productId);
   // Render product...
@@ -1118,15 +1171,18 @@ function ProtectedScreen() {
 ### Navigation Guards
 
 \`\`\`tsx
+import { useNavigator, useLocation } from '@idealyst/navigation';
+
 function useAuthGuard() {
-  const navigator = useNavigator();
+  const { navigate } = useNavigator();
+  const location = useLocation();
   const { isAuthenticated } = useAuth();
 
   useEffect(() => {
-    if (!isAuthenticated && navigator.currentPath !== '/login') {
-      navigator.navigate({ path: '/login', vars: {} });
+    if (!isAuthenticated && location.pathname !== '/login') {
+      navigate({ path: '/login' });
     }
-  }, [isAuthenticated, navigator.currentPath]);
+  }, [isAuthenticated, location.pathname]);
 }
 
 function App() {
@@ -1161,13 +1217,15 @@ useEffect(() => {
 Track navigation history:
 
 \`\`\`tsx
+import { useLocation } from '@idealyst/navigation';
+
 function useNavigationHistory() {
-  const navigator = useNavigator();
+  const location = useLocation();
   const [history, setHistory] = useState<string[]>([]);
 
   useEffect(() => {
-    setHistory(prev => [...prev, navigator.currentPath]);
-  }, [navigator.currentPath]);
+    setHistory(prev => [...prev, location.pathname]);
+  }, [location.pathname]);
 
   return history;
 }
@@ -1243,19 +1301,28 @@ const { canGoBack, goBack } = useNavigator();
 ### Tab Navigation
 
 \`\`\`tsx
+import { useNavigator, useLocation } from '@idealyst/navigation';
+
 const tabs = ['feed', 'search', 'profile'];
 
-<View>
-  {tabs.map(tab => (
-    <Button
-      key={tab}
-      onPress={() => navigator.navigate({ path: \`/\${tab}\`, vars: {} })}
-      variant={navigator.currentPath === \`/\${tab}\` ? 'contained' : 'outlined'}
-    >
-      {tab}
-    </Button>
-  ))}
-</View>
+function TabBar() {
+  const { navigate } = useNavigator();
+  const location = useLocation();
+
+  return (
+    <View>
+      {tabs.map(tab => (
+        <Button
+          key={tab}
+          onPress={() => navigate({ path: \`/\${tab}\` })}
+          type={location.pathname === \`/\${tab}\` ? 'contained' : 'outlined'}
+        >
+          {tab}
+        </Button>
+      ))}
+    </View>
+  );
+}
 \`\`\`
 
 ### Modal Navigation

package/dist/data/navigation-guides.js.map

@@ -1 +1 @@
-{"version":3,"file":"navigation-guides.js","sourceRoot":"","sources":["../../src/data/navigation-guides.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,gCAAgC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4FnC;IAEC,2CAA2C,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsO9C;IAEC,uCAAuC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuN1C;IAEC,sCAAsC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkTzC;IAEC,qCAAqC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6axC;IAEC,8CAA8C,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+VjD;CACA,CAAC"}
+{"version":3,"file":"navigation-guides.js","sourceRoot":"","sources":["../../src/data/navigation-guides.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,gCAAgC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4FnC;IAEC,2CAA2C,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwO9C;IAEC,uCAAuC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuN1C;IAEC,sCAAsC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkTzC;IAEC,qCAAqC,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8exC;IAEC,8CAA8C,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+VjD;CACA,CAAC"}

package/dist/data/packages.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Idealyst Framework Package Registry
+ * Central metadata for all @idealyst packages
+ */
+export interface PackageInfo {
+    name: string;
+    npmName: string;
+    description: string;
+    category: "core" | "ui" | "media" | "data" | "auth" | "utility" | "tooling";
+    platforms: ("web" | "native" | "node")[];
+    documentationStatus: "full" | "partial" | "minimal";
+    installation: string;
+    peerDependencies?: string[];
+    features: string[];
+    quickStart: string;
+    apiHighlights?: string[];
+    relatedPackages?: string[];
+}
+export declare const packages: Record<string, PackageInfo>;
+/**
+ * Get all packages grouped by category
+ */
+export declare function getPackagesByCategory(): Record<string, PackageInfo[]>;
+/**
+ * Get a summary list of all packages
+ */
+export declare function getPackageSummary(): Array<{
+    name: string;
+    npmName: string;
+    category: string;
+    description: string;
+    platforms: string[];
+    documentationStatus: string;
+}>;
+/**
+ * Search packages by query
+ */
+export declare function searchPackages(query: string): PackageInfo[];
+//# sourceMappingURL=packages.d.ts.map

package/dist/data/packages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packages.d.ts","sourceRoot":"","sources":["../../src/data/packages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5E,SAAS,EAAE,CAAC,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC;IACzC,mBAAmB,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAshBhD,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAWrE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,KAAK,CAAC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC,CASD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAW3D"}