@cocoar/vue-fragment-parser 1.3.0 → 1.4.1

package/dist/composables/index.d.ts

@@ -0,0 +1,4 @@
+export { useFragmentNavigation } from './useFragmentNavigation';
+export { useRoutedFragments } from './useRoutedFragments';
+export { useRoutedModals, type DialogFragment, type ModalFragment, type RoutedOverlayFragment } from './useRoutedModals';
+//# sourceMappingURL=index.d.ts.map

package/dist/composables/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/composables/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/composables/useFragmentNavigation.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Composable for navigating via URL fragments.
+ * Provides helpers to open/close fragment-based modals by manipulating the URL hash.
+ *
+ * @example
+ * ```ts
+ * const { navigateToModal, closeModal } = useFragmentNavigation();
+ *
+ * navigateToModal('todo-42', { tab: 2 });
+ * // URL: /todos#todo-42?tab=2
+ *
+ * closeModal('todo-42');
+ * // URL: /todos
+ * ```
+ */
+export declare function useFragmentNavigation(): {
+    navigateToModal: (path: string, params?: Record<string, string | number | boolean | undefined>, options?: {
+        append?: boolean;
+    }) => void;
+    closeModal: (fragmentPath: string) => void;
+};
+//# sourceMappingURL=useFragmentNavigation.d.ts.map

package/dist/composables/useFragmentNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFragmentNavigation.d.ts","sourceRoot":"","sources":["../../src/composables/useFragmentNavigation.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB;4BAY3B,MAAM,WACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,YACpD;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE;+BA0BE,MAAM;EAuBzC"}

package/dist/composables/useRoutedFragments.d.ts

@@ -0,0 +1,24 @@
+import { ParsedRoute } from '../lib/fragment-parser';
+import { RoutedFragmentBase } from '../lib/routed-fragment';
+/**
+ * Composable that reactively parses URL fragments against registered routes.
+ * Re-evaluates whenever the URL hash changes.
+ *
+ * @param routes - Optional explicit routes. If not provided, reads from `route.meta.routedFragments`.
+ *
+ * @example
+ * ```ts
+ * const { fragments } = useRoutedFragments();
+ * // fragments is a computed<ParsedRoute[]> that updates on hash change
+ *
+ * watchEffect(() => {
+ *   for (const f of fragments.value) {
+ *     console.log(f.route.type, f.params);
+ *   }
+ * });
+ * ```
+ */
+export declare function useRoutedFragments<T extends RoutedFragmentBase = RoutedFragmentBase>(routes?: T[]): {
+    fragments: import('vue').ComputedRef<ParsedRoute<T>[]>;
+};
+//# sourceMappingURL=useRoutedFragments.d.ts.map

package/dist/composables/useRoutedFragments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRoutedFragments.d.ts","sourceRoot":"","sources":["../../src/composables/useRoutedFragments.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,kBAAkB,GAAG,kBAAkB,EAClF,MAAM,CAAC,EAAE,CAAC,EAAE;;EAeb"}

package/dist/composables/useRoutedModals.d.ts

@@ -0,0 +1,41 @@
+import { Component } from 'vue';
+import { DialogConfig, OverlaySpec } from '@cocoar/vue-ui';
+import { RoutedFragmentBase } from '../lib/routed-fragment';
+/** Fragment that opens a component inside a CoarDialog shell (header, title, close button). */
+export interface DialogFragment extends RoutedFragmentBase {
+    type: 'dialog';
+    component: () => Promise<{
+        default: Component;
+    }>;
+    /** Dialog shell options (title, size, close behavior) */
+    dialogOptions?: DialogConfig;
+}
+/** Fragment that opens a component as a raw overlay (no shell, full control). */
+export interface ModalFragment extends RoutedFragmentBase {
+    type: 'modal';
+    component: () => Promise<{
+        default: Component;
+    }>;
+    /** Overlay spec overrides (backdrop, positioning, sizing, etc.) */
+    overlayOptions?: Partial<OverlaySpec>;
+}
+/** Union type for all supported routed fragment types. */
+export type RoutedOverlayFragment = DialogFragment | ModalFragment;
+/**
+ * Composable that automatically opens and closes dialogs/modals based on URL fragments.
+ *
+ * Supports two fragment types:
+ * - `type: 'dialog'` — Opens inside CoarDialog shell (header, title, close button)
+ * - `type: 'modal'` — Opens as raw overlay (no shell, component is the entire content)
+ *
+ * @example
+ * ```ts
+ * // In your view component:
+ * useRoutedModals();
+ *
+ * // Modals open/close automatically based on URL fragments.
+ * // Define fragments in route.meta.routedFragments.
+ * ```
+ */
+export declare function useRoutedModals(): void;
+//# sourceMappingURL=useRoutedModals.d.ts.map

package/dist/composables/useRoutedModals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRoutedModals.d.ts","sourceRoot":"","sources":["../../src/composables/useRoutedModals.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAErC,OAAO,KAAK,EAAE,YAAY,EAAc,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,+FAA+F;AAC/F,MAAM,WAAW,cAAe,SAAQ,kBAAkB;IACxD,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IACjD,yDAAyD;IACzD,aAAa,CAAC,EAAE,YAAY,CAAC;CAC9B;AAED,iFAAiF;AACjF,MAAM,WAAW,aAAc,SAAQ,kBAAkB;IACvD,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IACjD,mEAAmE;IACnE,cAAc,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CACvC;AAED,0DAA0D;AAC1D,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAAG,aAAa,CAAC;AAOnE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,SAuE9B"}

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export { parseFragment, type ParsedRoute } from './lib/fragment-parser';
 export { type RoutedFragmentBase } from './lib/routed-fragment';
+export { useFragmentNavigation, useRoutedFragments, useRoutedModals } from './composables';
+export type { DialogFragment, ModalFragment, RoutedOverlayFragment } from './composables';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGhE,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAC3F,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}