@iris-ui-kit/vue 0.2.21 → 0.2.23

package/dist/machine.cjs

@@ -3,14 +3,21 @@
 var vue = require('vue');
 
 // src/machine/useMachine.ts
-function useMachine(machine) {
+function useMachine(machine, options = {}) {
   const state = vue.ref(machine.store.getState());
   const unsubscribe = machine.store.subscribe((next) => {
     state.value = next;
   });
-  vue.onBeforeUnmount(() => {
-    unsubscribe();
-  });
+  vue.onScopeDispose(
+    () => {
+      unsubscribe();
+      if (options.stopOnUnmount !== false) machine.stop();
+    },
+    // failSilently: outside any effect scope there is nothing to dispose —
+    // registering is a no-op and must not emit the "no active effect scope"
+    // dev warning. Within a component/effectScope this arg changes nothing.
+    true
+  );
   return { state, send: machine.send };
 }
 

package/dist/machine.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/machine/useMachine.ts"],"names":["ref","onBeforeUnmount"],"mappings":";;;;;AAYO,SAAS,WACd,OAAA,EAIA;AACA,EAAA,MAAM,KAAA,GAAQA,OAAA,CAAI,OAAA,CAAQ,KAAA,CAAM,UAAU,CAAA;AAC1C,EAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,KAAA,CAAM,SAAA,CAAU,CAAC,IAAA,KAAS;AACpD,IAAA,KAAA,CAAM,KAAA,GAAQ,IAAA;AAAA,EAChB,CAAC,CAAA;AACD,EAAAC,mBAAA,CAAgB,MAAM;AACpB,IAAA,WAAA,EAAY;AAAA,EACd,CAAC,CAAA;AACD,EAAA,OAAO,EAAE,KAAA,EAAO,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAK;AACrC","file":"machine.cjs","sourcesContent":["import { onBeforeUnmount, ref, type Ref } from 'vue'\nimport type { Machine, MachineEvent, MachineState } from '@iris-ui-kit/core'\n\n/**\n * Bridge a framework-agnostic `Machine` into Vue reactivity.\n *\n * Returns a reactive ref of the current `{ value, context }` state and a\n * stable `send` function. Subscription is created eagerly and cleaned up on\n * unmount, so this hook is safe to call from any component's `setup()`.\n *\n * No primitive consumes this yet (Phase 0 ships the bridge for Phase 1).\n */\nexport function useMachine<TState extends string, TContext, TEvent extends MachineEvent>(\n  machine: Machine<TState, TContext, TEvent>,\n): {\n  state: Ref<MachineState<TState, TContext>>\n  send: (event: TEvent) => void\n} {\n  const state = ref(machine.store.getState()) as Ref<MachineState<TState, TContext>>\n  const unsubscribe = machine.store.subscribe((next) => {\n    state.value = next\n  })\n  onBeforeUnmount(() => {\n    unsubscribe()\n  })\n  return { state, send: machine.send }\n}\n"]}
+{"version":3,"sources":["../src/machine/useMachine.ts"],"names":["ref","onScopeDispose"],"mappings":";;;;;AAmBO,SAAS,UAAA,CACd,OAAA,EACA,OAAA,GAAuC,EAAC,EAIxC;AACA,EAAA,MAAM,KAAA,GAAQA,OAAA,CAAI,OAAA,CAAQ,KAAA,CAAM,UAAU,CAAA;AAC1C,EAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,KAAA,CAAM,SAAA,CAAU,CAAC,IAAA,KAAS;AACpD,IAAA,KAAA,CAAM,KAAA,GAAQ,IAAA;AAAA,EAChB,CAAC,CAAA;AACD,EAAAC,kBAAA;AAAA,IACE,MAAM;AAEJ,MAAA,WAAA,EAAY;AACZ,MAAA,IAAI,OAAA,CAAQ,aAAA,KAAkB,KAAA,EAAO,OAAA,CAAQ,IAAA,EAAK;AAAA,IACpD,CAAA;AAAA;AAAA;AAAA;AAAA,IAIA;AAAA,GACF;AACA,EAAA,OAAO,EAAE,KAAA,EAAO,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAK;AACrC","file":"machine.cjs","sourcesContent":["import { onScopeDispose, ref, type Ref } from 'vue'\nimport type { Machine, MachineEvent, MachineState } from '@iris-ui-kit/core'\n\n/**\n * Bridge a framework-agnostic `Machine` into Vue reactivity.\n *\n * Returns a reactive ref of the current `{ value, context }` state and a\n * stable `send` function. Subscription is created eagerly and cleaned up on\n * scope dispose, so this hook is safe to call from any component's `setup()`.\n *\n * Teardown semantics: when the owning scope is disposed (component unmount,\n * `effectScope().stop()`, end of SSR render), the store subscription is\n * detached AND — by default — `machine.stop()` is called: pending `after`\n * timers are cancelled and further `send` calls become no-ops, so a delayed\n * transition can never fire into a disposed consumer (see the core `Machine`\n * contract). Pass `{ stopOnUnmount: false }` only when the machine is shared\n * with other consumers that outlive this scope — the subscription is still\n * detached, the machine keeps running.\n */\nexport function useMachine<TState extends string, TContext, TEvent extends MachineEvent>(\n  machine: Machine<TState, TContext, TEvent>,\n  options: { stopOnUnmount?: boolean } = {},\n): {\n  state: Ref<MachineState<TState, TContext>>\n  send: (event: TEvent) => void\n} {\n  const state = ref(machine.store.getState()) as Ref<MachineState<TState, TContext>>\n  const unsubscribe = machine.store.subscribe((next) => {\n    state.value = next\n  })\n  onScopeDispose(\n    () => {\n      // Detach the bridge first (conservative order), then stop the machine.\n      unsubscribe()\n      if (options.stopOnUnmount !== false) machine.stop()\n    },\n    // failSilently: outside any effect scope there is nothing to dispose —\n    // registering is a no-op and must not emit the \"no active effect scope\"\n    // dev warning. Within a component/effectScope this arg changes nothing.\n    true,\n  )\n  return { state, send: machine.send }\n}\n"]}

package/dist/machine.d.cts

@@ -6,11 +6,20 @@ import { MachineEvent, Machine, MachineState } from '@iris-ui-kit/core';
  *
  * Returns a reactive ref of the current `{ value, context }` state and a
  * stable `send` function. Subscription is created eagerly and cleaned up on
- * unmount, so this hook is safe to call from any component's `setup()`.
+ * scope dispose, so this hook is safe to call from any component's `setup()`.
  *
- * No primitive consumes this yet (Phase 0 ships the bridge for Phase 1).
+ * Teardown semantics: when the owning scope is disposed (component unmount,
+ * `effectScope().stop()`, end of SSR render), the store subscription is
+ * detached AND — by default — `machine.stop()` is called: pending `after`
+ * timers are cancelled and further `send` calls become no-ops, so a delayed
+ * transition can never fire into a disposed consumer (see the core `Machine`
+ * contract). Pass `{ stopOnUnmount: false }` only when the machine is shared
+ * with other consumers that outlive this scope — the subscription is still
+ * detached, the machine keeps running.
  */
-declare function useMachine<TState extends string, TContext, TEvent extends MachineEvent>(machine: Machine<TState, TContext, TEvent>): {
+declare function useMachine<TState extends string, TContext, TEvent extends MachineEvent>(machine: Machine<TState, TContext, TEvent>, options?: {
+    stopOnUnmount?: boolean;
+}): {
     state: Ref<MachineState<TState, TContext>>;
     send: (event: TEvent) => void;
 };

package/dist/machine.d.ts

@@ -6,11 +6,20 @@ import { MachineEvent, Machine, MachineState } from '@iris-ui-kit/core';
  *
  * Returns a reactive ref of the current `{ value, context }` state and a
  * stable `send` function. Subscription is created eagerly and cleaned up on
- * unmount, so this hook is safe to call from any component's `setup()`.
+ * scope dispose, so this hook is safe to call from any component's `setup()`.
  *
- * No primitive consumes this yet (Phase 0 ships the bridge for Phase 1).
+ * Teardown semantics: when the owning scope is disposed (component unmount,
+ * `effectScope().stop()`, end of SSR render), the store subscription is
+ * detached AND — by default — `machine.stop()` is called: pending `after`
+ * timers are cancelled and further `send` calls become no-ops, so a delayed
+ * transition can never fire into a disposed consumer (see the core `Machine`
+ * contract). Pass `{ stopOnUnmount: false }` only when the machine is shared
+ * with other consumers that outlive this scope — the subscription is still
+ * detached, the machine keeps running.
  */
-declare function useMachine<TState extends string, TContext, TEvent extends MachineEvent>(machine: Machine<TState, TContext, TEvent>): {
+declare function useMachine<TState extends string, TContext, TEvent extends MachineEvent>(machine: Machine<TState, TContext, TEvent>, options?: {
+    stopOnUnmount?: boolean;
+}): {
     state: Ref<MachineState<TState, TContext>>;
     send: (event: TEvent) => void;
 };

package/dist/machine.js

@@ -1,4 +1,4 @@
 import './chunk-4FQ7XF52.js';
-export { useMachine } from './chunk-TQB5LVOH.js';
+export { useMachine } from './chunk-NNOF7KUH.js';
 //# sourceMappingURL=machine.js.map
 //# sourceMappingURL=machine.js.map

package/dist/resource.cjs

@@ -5,10 +5,14 @@ var core = require('@iris-ui-kit/core');
 
 // src/resource/useResourceController.ts
 function useResourceController(config) {
-  const controller = core.createResourceController(config);
+  const controller = core.createResourceController({ ...config, immediate: false });
+  const immediate = config.immediate !== false;
+  if (immediate) {
+    vue.onMounted(() => void controller.load());
+  }
+  vue.onScopeDispose(() => controller.destroy());
   const state = vue.shallowRef(controller.getState());
-  vue.onBeforeUnmount(controller.subscribe((next) => state.value = next));
-  vue.onBeforeUnmount(() => controller.destroy());
+  vue.onScopeDispose(controller.subscribe((next) => state.value = next));
   return { ...controller, state };
 }
 

package/dist/resource.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/resource/useResourceController.ts"],"names":["createResourceController","shallowRef","onBeforeUnmount"],"mappings":";;;;;;AAmBO,SAAS,sBACd,MAAA,EAC0B;AAC1B,EAAA,MAAM,UAAA,GAAaA,8BAAyB,MAAM,CAAA;AAClD,EAAA,MAAM,KAAA,GAAQC,cAAA,CAAW,UAAA,CAAW,QAAA,EAAU,CAAA;AAC9C,EAAAC,mBAAA,CAAgB,WAAW,SAAA,CAAU,CAAC,SAAU,KAAA,CAAM,KAAA,GAAQ,IAAK,CAAC,CAAA;AAGpE,EAAAA,mBAAA,CAAgB,MAAM,UAAA,CAAW,OAAA,EAAS,CAAA;AAC1C,EAAA,OAAO,EAAE,GAAG,UAAA,EAAY,KAAA,EAAM;AAChC","file":"resource.cjs","sourcesContent":["import { onBeforeUnmount, shallowRef, type ShallowRef } from 'vue'\nimport {\n  createResourceController,\n  type ResourceController,\n  type ResourceControllerConfig,\n  type ResourceState,\n} from '@iris-ui-kit/core'\n\nexport interface UseResourceController<T> extends ResourceController<T> {\n  /** The live resource state as a reactive ref (rows, total, page, loading, selectedKeys). */\n  state: ShallowRef<ResourceState<T>>\n}\n\n/**\n * Vue bridge over the framework-agnostic {@link createResourceController} (L4\n * CRUD list composite). Creates the controller once in `setup()`, mirrors its\n * store into a `shallowRef`, and returns the controller plus that live `state`.\n * A ~15-line thin bridge — all logic lives in `@iris-ui-kit/core`.\n */\nexport function useResourceController<T>(\n  config: ResourceControllerConfig<T>,\n): UseResourceController<T> {\n  const controller = createResourceController(config)\n  const state = shallowRef(controller.getState())\n  onBeforeUnmount(controller.subscribe((next) => (state.value = next)))\n  // Abort any in-flight fetch + detach the controller's internal subscriptions\n  // on unmount (a late response must not write back to a torn-down instance).\n  onBeforeUnmount(() => controller.destroy())\n  return { ...controller, state }\n}\n"]}
+{"version":3,"sources":["../src/resource/useResourceController.ts"],"names":["createResourceController","onMounted","onScopeDispose","shallowRef"],"mappings":";;;;;;AA4BO,SAAS,sBACd,MAAA,EAC0B;AAC1B,EAAA,MAAM,aAAaA,6BAAA,CAAyB,EAAE,GAAG,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAA;AAC3E,EAAA,MAAM,SAAA,GAAY,OAAO,SAAA,KAAc,KAAA;AAEvC,EAAA,IAAI,SAAA,EAAW;AACb,IAAAC,aAAA,CAAU,MAAM,KAAK,UAAA,CAAW,IAAA,EAAM,CAAA;AAAA,EACxC;AAKA,EAAAC,kBAAA,CAAe,MAAM,UAAA,CAAW,OAAA,EAAS,CAAA;AAEzC,EAAA,MAAM,KAAA,GAAQC,cAAA,CAAW,UAAA,CAAW,QAAA,EAAU,CAAA;AAC9C,EAAAD,kBAAA,CAAe,WAAW,SAAA,CAAU,CAAC,SAAU,KAAA,CAAM,KAAA,GAAQ,IAAK,CAAC,CAAA;AACnE,EAAA,OAAO,EAAE,GAAG,UAAA,EAAY,KAAA,EAAM;AAChC","file":"resource.cjs","sourcesContent":["import { onMounted, onScopeDispose, shallowRef, type ShallowRef } from 'vue'\nimport {\n  createResourceController,\n  type ResourceController,\n  type ResourceControllerConfig,\n  type ResourceState,\n} from '@iris-ui-kit/core'\n\nexport interface UseResourceController<T> extends ResourceController<T> {\n  /** The live resource state as a reactive ref (rows, total, page, loading, selectedKeys). */\n  state: ShallowRef<ResourceState<T>>\n}\n\n/**\n * Vue bridge over the framework-agnostic {@link createResourceController} (L4\n * CRUD list composite). Creates the controller once in `setup()`, mirrors its\n * store into a `shallowRef`, and returns the controller plus that live `state`.\n * A thin bridge — all logic lives in `@iris-ui-kit/core`.\n *\n * Constructed with `immediate: false` so no fetch fires during `setup()`\n * (SSR-safe: server rendering never runs `onMounted`); the initial load is\n * kicked from `onMounted` when the caller's config says `immediate !== false`.\n * The `onMounted` registration is conditional on that flag — inside a bare\n * `effectScope` there is no component instance and Vue would warn on an\n * unconditional registration. The controller is torn down on scope dispose\n * (aborting any in-flight request and detaching the state mirror), so a late\n * response never writes back to a torn-down instance.\n */\nexport function useResourceController<T>(\n  config: ResourceControllerConfig<T>,\n): UseResourceController<T> {\n  const controller = createResourceController({ ...config, immediate: false })\n  const immediate = config.immediate !== false\n\n  if (immediate) {\n    onMounted(() => void controller.load())\n  }\n  // Abort any in-flight fetch + detach the controller's internal subscriptions\n  // on scope dispose (a late response must not write back to a torn-down\n  // instance). Fires on unmount inside a component scope and on `scope.stop()`\n  // inside a bare effectScope.\n  onScopeDispose(() => controller.destroy())\n\n  const state = shallowRef(controller.getState())\n  onScopeDispose(controller.subscribe((next) => (state.value = next)))\n  return { ...controller, state }\n}\n"]}

package/dist/resource.d.cts

@@ -10,7 +10,16 @@ interface UseResourceController<T> extends ResourceController<T> {
  * Vue bridge over the framework-agnostic {@link createResourceController} (L4
  * CRUD list composite). Creates the controller once in `setup()`, mirrors its
  * store into a `shallowRef`, and returns the controller plus that live `state`.
- * A ~15-line thin bridge — all logic lives in `@iris-ui-kit/core`.
+ * A thin bridge — all logic lives in `@iris-ui-kit/core`.
+ *
+ * Constructed with `immediate: false` so no fetch fires during `setup()`
+ * (SSR-safe: server rendering never runs `onMounted`); the initial load is
+ * kicked from `onMounted` when the caller's config says `immediate !== false`.
+ * The `onMounted` registration is conditional on that flag — inside a bare
+ * `effectScope` there is no component instance and Vue would warn on an
+ * unconditional registration. The controller is torn down on scope dispose
+ * (aborting any in-flight request and detaching the state mirror), so a late
+ * response never writes back to a torn-down instance.
  */
 declare function useResourceController<T>(config: ResourceControllerConfig<T>): UseResourceController<T>;
 

package/dist/resource.d.ts

@@ -10,7 +10,16 @@ interface UseResourceController<T> extends ResourceController<T> {
  * Vue bridge over the framework-agnostic {@link createResourceController} (L4
  * CRUD list composite). Creates the controller once in `setup()`, mirrors its
  * store into a `shallowRef`, and returns the controller plus that live `state`.
- * A ~15-line thin bridge — all logic lives in `@iris-ui-kit/core`.
+ * A thin bridge — all logic lives in `@iris-ui-kit/core`.
+ *
+ * Constructed with `immediate: false` so no fetch fires during `setup()`
+ * (SSR-safe: server rendering never runs `onMounted`); the initial load is
+ * kicked from `onMounted` when the caller's config says `immediate !== false`.
+ * The `onMounted` registration is conditional on that flag — inside a bare
+ * `effectScope` there is no component instance and Vue would warn on an
+ * unconditional registration. The controller is torn down on scope dispose
+ * (aborting any in-flight request and detaching the state mirror), so a late
+ * response never writes back to a torn-down instance.
  */
 declare function useResourceController<T>(config: ResourceControllerConfig<T>): UseResourceController<T>;
 

package/dist/resource.js

@@ -1,3 +1,3 @@
-export { createClientFetcher, createResourceController, useResourceController } from './chunk-XSLBANUV.js';
+export { createClientFetcher, createResourceController, useResourceController } from './chunk-25NYWSXP.js';
 //# sourceMappingURL=resource.js.map
 //# sourceMappingURL=resource.js.map

package/dist/skeletons.cjs

@@ -1483,14 +1483,32 @@ var IrisDashboardTemplate = vue.defineComponent({
     activeId: { type: String, default: "" },
     /** Cards to render in the main grid. Skip to use the `default` slot only. */
     cards: { type: Array, default: () => [] },
-    defaultCollapsed: { type: Boolean, default: false }
+    defaultCollapsed: { type: Boolean, default: false },
+    /**
+     * Controlled collapsed state. When unset (`undefined`), the component
+     * manages its own state seeded from `defaultCollapsed`; when set, this
+     * value takes precedence and changes are re-emitted via
+     * `update:collapsed` (`v-model:collapsed`).
+     */
+    collapsed: { type: Boolean, default: void 0 }
   },
   emits: {
     "update:activeId": (_id) => true,
     "update:collapsed": (_value) => true
   },
   setup(props, { attrs, slots, emit }) {
-    const collapsed = vue.ref(props.defaultCollapsed);
+    const isControlled = vue.computed(() => props.collapsed !== void 0);
+    const internalCollapsed = vue.ref(props.defaultCollapsed);
+    const collapsed = vue.computed(
+      () => isControlled.value ? Boolean(props.collapsed) : internalCollapsed.value
+    );
+    vue.watch(
+      () => props.collapsed,
+      (value) => {
+        if (value !== void 0) internalCollapsed.value = value;
+      },
+      { immediate: true }
+    );
     const onSelectNav = (id) => {
       emit("update:activeId", id);
     };
@@ -1512,7 +1530,7 @@ var IrisDashboardTemplate = vue.defineComponent({
         {
           collapsed: collapsed.value,
           "onUpdate:collapsed": (v) => {
-            collapsed.value = v;
+            if (!isControlled.value) internalCollapsed.value = v;
             emit("update:collapsed", v);
           },
           width: 240,