mobx-mantle 0.1.5

package/dist/index.cjs

@@ -0,0 +1,285 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Behavior: () => Behavior,
+  View: () => View,
+  ViewModel: () => View,
+  configure: () => configure,
+  createBehavior: () => createBehavior,
+  createView: () => createView
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/mantle.tsx
+var import_react = require("react");
+var import_mobx2 = require("mobx");
+var import_mobx_react_lite = require("mobx-react-lite");
+
+// src/behavior.ts
+var import_mobx = require("mobx");
+var BEHAVIOR_MARKER = /* @__PURE__ */ Symbol("behavior");
+var BEHAVIOR_EXCLUDES = /* @__PURE__ */ new Set([
+  "onCreate",
+  "onLayoutMount",
+  "onMount",
+  "onUnmount",
+  "constructor"
+]);
+var Behavior = class {
+};
+function makeBehaviorObservable(instance) {
+  const annotations = {};
+  const ownKeys = /* @__PURE__ */ new Set([
+    ...Object.keys(instance),
+    ...Object.keys(Object.getPrototypeOf(instance))
+  ]);
+  for (const key of ownKeys) {
+    if (BEHAVIOR_EXCLUDES.has(key)) continue;
+    if (key in annotations) continue;
+    const value = instance[key];
+    if (typeof value === "function") continue;
+    annotations[key] = import_mobx.observable;
+  }
+  let proto = Object.getPrototypeOf(instance);
+  while (proto && proto !== Behavior.prototype) {
+    const descriptors = Object.getOwnPropertyDescriptors(proto);
+    for (const [key, descriptor] of Object.entries(descriptors)) {
+      if (BEHAVIOR_EXCLUDES.has(key)) continue;
+      if (key in annotations) continue;
+      if (descriptor.get) {
+        annotations[key] = import_mobx.computed;
+      } else if (typeof descriptor.value === "function") {
+        annotations[key] = import_mobx.action.bound;
+      }
+    }
+    proto = Object.getPrototypeOf(proto);
+  }
+  (0, import_mobx.makeObservable)(instance, annotations);
+}
+function createBehavior(Def) {
+  var _a, _b, _c;
+  const BehaviorClass = (_c = class extends (_b = Def, _a = BEHAVIOR_MARKER, _b) {
+    constructor(...args) {
+      super(...args);
+      if (typeof this.onCreate === "function") {
+        this.onCreate(...args);
+      }
+      makeBehaviorObservable(this);
+    }
+  }, _c[_a] = true, _c);
+  Object.defineProperty(BehaviorClass, "name", { value: Def.name });
+  return BehaviorClass;
+}
+function isBehavior(value) {
+  if (value === null || typeof value !== "object") return false;
+  return value.constructor?.[BEHAVIOR_MARKER] === true;
+}
+function layoutMountBehavior(behavior) {
+  const inst = behavior.instance;
+  if ("onLayoutMount" in inst && typeof inst.onLayoutMount === "function") {
+    behavior.layoutCleanup = inst.onLayoutMount() ?? void 0;
+  }
+}
+function mountBehavior(behavior) {
+  const inst = behavior.instance;
+  if ("onMount" in inst && typeof inst.onMount === "function") {
+    behavior.cleanup = inst.onMount() ?? void 0;
+  }
+}
+function unmountBehavior(behavior) {
+  behavior.layoutCleanup?.();
+  behavior.cleanup?.();
+  const inst = behavior.instance;
+  if ("onUnmount" in inst && typeof inst.onUnmount === "function") {
+    inst.onUnmount();
+  }
+}
+
+// src/mantle.tsx
+var globalConfig = {
+  autoObservable: true
+};
+function configure(config) {
+  Object.assign(globalConfig, config);
+}
+var View = class {
+  constructor() {
+    /** @internal */
+    this._behaviors = [];
+  }
+  get props() {
+    return this._propsBox.get();
+  }
+  set props(value) {
+    (0, import_mobx2.runInAction)(() => this._propsBox.set(value));
+  }
+  ref() {
+    return { current: null };
+  }
+  /** @internal - Scan own properties for behavior instances and register them */
+  _collectBehaviors() {
+    for (const key of Object.keys(this)) {
+      if (key.startsWith("_")) continue;
+      const value = this[key];
+      if (isBehavior(value)) {
+        this._behaviors.push({ instance: value });
+      }
+    }
+  }
+  /** @internal */
+  _layoutMountBehaviors() {
+    for (const behavior of this._behaviors) {
+      layoutMountBehavior(behavior);
+    }
+  }
+  /** @internal */
+  _mountBehaviors() {
+    for (const behavior of this._behaviors) {
+      mountBehavior(behavior);
+    }
+  }
+  /** @internal */
+  _unmountBehaviors() {
+    for (const behavior of this._behaviors) {
+      unmountBehavior(behavior);
+    }
+  }
+};
+var BASE_EXCLUDES = /* @__PURE__ */ new Set([
+  "props",
+  "_propsBox",
+  "forwardRef",
+  "onCreate",
+  "onLayoutMount",
+  "onMount",
+  "onUnmount",
+  "render",
+  "ref",
+  "constructor",
+  "_behaviors",
+  "_collectBehaviors",
+  "_layoutMountBehaviors",
+  "_mountBehaviors",
+  "_unmountBehaviors"
+]);
+function isRefLike(value) {
+  return value !== null && typeof value === "object" && "current" in value && Object.keys(value).length === 1;
+}
+function makeViewObservable(instance, autoBind) {
+  const annotations = {};
+  const ownKeys = /* @__PURE__ */ new Set([
+    ...Object.keys(instance),
+    ...Object.keys(Object.getPrototypeOf(instance))
+  ]);
+  for (const key of ownKeys) {
+    if (BASE_EXCLUDES.has(key)) continue;
+    if (key in annotations) continue;
+    const value = instance[key];
+    if (typeof value === "function") continue;
+    if (isBehavior(value)) {
+      annotations[key] = import_mobx2.observable.ref;
+      continue;
+    }
+    if (isRefLike(value)) {
+      annotations[key] = import_mobx2.observable.ref;
+    } else {
+      annotations[key] = import_mobx2.observable;
+    }
+  }
+  let proto = Object.getPrototypeOf(instance);
+  while (proto && proto !== View.prototype) {
+    const descriptors = Object.getOwnPropertyDescriptors(proto);
+    for (const [key, descriptor] of Object.entries(descriptors)) {
+      if (BASE_EXCLUDES.has(key)) continue;
+      if (key in annotations) continue;
+      if (descriptor.get) {
+        annotations[key] = import_mobx2.computed;
+      } else if (typeof descriptor.value === "function") {
+        annotations[key] = autoBind ? import_mobx2.action.bound : import_mobx2.action;
+      }
+    }
+    proto = Object.getPrototypeOf(proto);
+  }
+  (0, import_mobx2.makeObservable)(instance, annotations);
+}
+function createView(ViewClass, templateOrOptions) {
+  const template = typeof templateOrOptions === "function" ? templateOrOptions : void 0;
+  const options = typeof templateOrOptions === "object" ? templateOrOptions : {};
+  const { autoObservable = globalConfig.autoObservable } = options;
+  const Component = (0, import_react.forwardRef)((props, ref) => {
+    const vmRef = (0, import_react.useRef)(null);
+    const classRef = (0, import_react.useRef)(ViewClass);
+    if (vmRef.current && classRef.current !== ViewClass) {
+      classRef.current = ViewClass;
+      vmRef.current = null;
+    }
+    if (!vmRef.current) {
+      const instance = new ViewClass();
+      instance._propsBox = import_mobx2.observable.box(props, { deep: false });
+      instance.forwardRef = ref;
+      instance._collectBehaviors();
+      if (autoObservable) {
+        makeViewObservable(instance, true);
+      } else {
+        (0, import_mobx2.makeObservable)(instance);
+      }
+      instance.onCreate?.();
+      vmRef.current = instance;
+    }
+    const vm = vmRef.current;
+    vm.props = props;
+    vm.forwardRef = ref;
+    (0, import_react.useLayoutEffect)(() => {
+      vm._layoutMountBehaviors();
+      const cleanup = vm.onLayoutMount?.();
+      return () => {
+        cleanup?.();
+      };
+    }, [vm]);
+    (0, import_react.useEffect)(() => {
+      vm._mountBehaviors();
+      const cleanup = vm.onMount?.();
+      return () => {
+        cleanup?.();
+        vm.onUnmount?.();
+        vm._unmountBehaviors();
+      };
+    }, [vm]);
+    if (!template && !vm.render) {
+      throw new Error(
+        `${ViewClass.name}: Missing render() method. Either define render() in your View class or pass a template function to createView().`
+      );
+    }
+    return template ? template(vm) : vm.render();
+  });
+  return (0, import_mobx_react_lite.observer)(Component);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Behavior,
+  View,
+  ViewModel,
+  configure,
+  createBehavior,
+  createView
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/mantle.tsx","../src/behavior.ts"],"sourcesContent":["export { View, ViewModel, Behavior, createBehavior, createView, configure } from './mantle';\r\nexport type { MantleConfig } from './mantle';\r\n","import { useRef, useEffect, useLayoutEffect, forwardRef as reactForwardRef, type Ref, type JSX } from 'react';\nimport { makeObservable, observable, computed, action, runInAction, AnnotationsMap, type IObservableValue } from 'mobx';\nimport { observer } from 'mobx-react-lite';\nimport {\n  type BehaviorEntry,\n  isBehavior,\n  layoutMountBehavior,\n  mountBehavior,\n  unmountBehavior,\n} from './behavior';\n\n/**\n * Global configuration options for mobx-mantle\n */\nexport interface MantleConfig {\n  /** Whether to automatically make View instances observable (default: true) */\n  autoObservable?: boolean;\n}\n\nconst globalConfig: MantleConfig = {\n  autoObservable: true,\n};\n\n/**\n * Configure global defaults for mobx-mantle.\n * Settings can still be overridden per-view in createView options.\n */\nexport function configure(config: MantleConfig): void {\n  Object.assign(globalConfig, config);\n}\n\nexport class View<P = {}> {\n  /** @internal */\n  _propsBox!: IObservableValue<P>;\n  \n  get props(): P {\n    return this._propsBox.get();\n  }\n  \n  set props(value: P) {\n    runInAction(() => this._propsBox.set(value));\n  }\n\n  forwardRef?: Ref<any>;\n\n  /** @internal */\n  _behaviors: BehaviorEntry[] = [];\n\n  onCreate?(): void;\n  onLayoutMount?(): void | (() => void);\n  onMount?(): void | (() => void);\n  onUnmount?(): void;\n\n  ref<T extends HTMLElement = HTMLElement>(): { current: T | null } {\n    return { current: null };\n  }\n\n  /** @internal - Scan own properties for behavior instances and register them */\n  _collectBehaviors(): void {\n    for (const key of Object.keys(this)) {\n      if (key.startsWith('_')) continue;\n      const value = (this as any)[key];\n      if (isBehavior(value)) {\n        this._behaviors.push({ instance: value });\n      }\n    }\n  }\n\n  /** @internal */\n  _layoutMountBehaviors(): void {\n    for (const behavior of this._behaviors) {\n      layoutMountBehavior(behavior);\n    }\n  }\n\n  /** @internal */\n  _mountBehaviors(): void {\n    for (const behavior of this._behaviors) {\n      mountBehavior(behavior);\n    }\n  }\n\n  /** @internal */\n  _unmountBehaviors(): void {\n    for (const behavior of this._behaviors) {\n      unmountBehavior(behavior);\n    }\n  }\n\n  render?(): JSX.Element;\n}\n\n/** Alias for View - use when separating ViewModel from template */\nexport { View as ViewModel };\n\n// Re-export from behavior module\nexport { createBehavior, Behavior } from './behavior';\n\n// Base class members that should not be made observable\nconst BASE_EXCLUDES = new Set([\n  'props',\n  '_propsBox',\n  'forwardRef', \n  'onCreate',\n  'onLayoutMount',\n  'onMount', \n  'onUnmount',\n  'render', \n  'ref', \n  'constructor',\n  '_behaviors',\n  '_collectBehaviors',\n  '_layoutMountBehaviors',\n  '_mountBehaviors',\n  '_unmountBehaviors',\n]);\n\n/**\n * Detects if a value is a ref-like object ({ current: ... })\n * These should use observable.ref to preserve object identity for React\n */\nfunction isRefLike(value: unknown): boolean {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    'current' in value &&\n    Object.keys(value).length === 1\n  );\n}\n\n/**\n * Creates observable annotations for a View subclass instance.\n * This is needed because makeAutoObservable doesn't work with inheritance.\n */\nfunction makeViewObservable<T extends View>(instance: T, autoBind: boolean) {\n  const annotations: AnnotationsMap<T, never> = {} as AnnotationsMap<T, never>;\n\n  // Collect own properties (instance state) → observable\n  // Also check prototype for class field declarations (handles uninitialized fields)\n  const ownKeys = new Set([\n    ...Object.keys(instance),\n    ...Object.keys(Object.getPrototypeOf(instance)),\n  ]);\n\n  for (const key of ownKeys) {\n    if (BASE_EXCLUDES.has(key)) continue;\n    if (key in annotations) continue;\n\n    const value = (instance as any)[key];\n\n    // Skip functions (these are handled in the prototype walk)\n    if (typeof value === 'function') continue;\n\n    // Skip behavior instances (they're already observable)\n    if (isBehavior(value)) {\n      (annotations as any)[key] = observable.ref;\n      continue;\n    }\n\n    // Use observable.ref for ref-like objects to preserve identity\n    if (isRefLike(value)) {\n      (annotations as any)[key] = observable.ref;\n    } else {\n      (annotations as any)[key] = observable;\n    }\n  }\n\n  // Walk prototype chain up to (but not including) View\n  let proto = Object.getPrototypeOf(instance);\n  while (proto && proto !== View.prototype) {\n    const descriptors = Object.getOwnPropertyDescriptors(proto);\n\n    for (const [key, descriptor] of Object.entries(descriptors)) {\n      if (BASE_EXCLUDES.has(key)) continue;\n      if (key in annotations) continue;\n\n      if (descriptor.get) {\n        // Getter → computed\n        (annotations as any)[key] = computed;\n      } else if (typeof descriptor.value === 'function') {\n        // Method → action (optionally bound)\n        (annotations as any)[key] = autoBind ? action.bound : action;\n      }\n    }\n\n    proto = Object.getPrototypeOf(proto);\n  }\n\n  makeObservable(instance, annotations);\n}\n\ntype PropsOf<V> = V extends View<infer P> ? P : object;\n\nexport function createView<V extends View<any>>(\n  ViewClass: new () => V,\n  templateOrOptions?: ((vm: V) => JSX.Element) | { autoObservable?: boolean }\n) {\n  type P = PropsOf<V>;\n\n  const template = typeof templateOrOptions === 'function' ? templateOrOptions : undefined;\n  const options = typeof templateOrOptions === 'object' ? templateOrOptions : {};\n  const { autoObservable = globalConfig.autoObservable } = options;\n\n  const Component = reactForwardRef<unknown, P>((props, ref) => {\n    const vmRef = useRef<V | null>(null);\n    const classRef = useRef(ViewClass);\n\n    // HMR: class identity changes when the module re-executes, but useRef\n    // values survive (React Fast Refresh preserves hooks). On detection,\n    // we simply discard the old instance and create fresh — clean slate.\n    // In production this check is always false (class identity is stable).\n    if (vmRef.current && classRef.current !== ViewClass) {\n      classRef.current = ViewClass;\n      vmRef.current = null;\n    }\n\n    if (!vmRef.current) {\n      const instance = new ViewClass();\n\n      // Props is always reactive via observable.box (works with all decorator modes)\n      instance._propsBox = observable.box(props, { deep: false });\n      instance.forwardRef = ref;\n\n      // Collect behavior instances from properties (must happen before makeObservable)\n      instance._collectBehaviors();\n\n      if (autoObservable) {\n        makeViewObservable(instance, true);\n      } else {\n        // For decorator users: applies legacy decorator metadata\n        // For TC39 decorators: no-op (they're self-registering)\n        makeObservable(instance);\n      }\n\n      instance.onCreate?.();\n      vmRef.current = instance;\n    }\n\n    const vm = vmRef.current;\n\n    // Props setter handles reactivity via observable.box\n    vm.props = props;\n    vm.forwardRef = ref;\n\n    // [vm] dep ensures effects re-run when instance changes (HMR).\n    // On normal renders vm is stable, so effects run once — same as [].\n    useLayoutEffect(() => {\n      vm._layoutMountBehaviors();\n      const cleanup = vm.onLayoutMount?.();\n      return () => {\n        cleanup?.();\n      };\n    }, [vm]);\n\n    useEffect(() => {\n      vm._mountBehaviors();\n      const cleanup = vm.onMount?.();\n      return () => {\n        cleanup?.();\n        vm.onUnmount?.();\n        vm._unmountBehaviors();\n      };\n    }, [vm]);\n\n    if (!template && !vm.render) {\n      throw new Error(\n        `${ViewClass.name}: Missing render() method. Either define render() in your View class or pass a template function to createView().`\n      );\n    }\n\n    return template ? template(vm) : vm.render!();\n  });\n\n  return observer(Component);\n}\n","import { makeObservable, observable, computed, action, type AnnotationsMap } from 'mobx';\r\n\r\n/** Symbol marker to identify behavior instances */\r\nexport const BEHAVIOR_MARKER = Symbol('behavior');\r\n\r\n// Behavior base class members that should not be made observable\r\nconst BEHAVIOR_EXCLUDES = new Set([\r\n  'onCreate',\r\n  'onLayoutMount',\r\n  'onMount',\r\n  'onUnmount',\r\n  'constructor',\r\n]);\r\n\r\n/**\r\n * Base class for behaviors. Provides lifecycle method signatures and IDE autocomplete.\r\n * Extend this class and wrap with createBehavior().\r\n * \r\n * You can pass arguments either via constructor or onCreate:\r\n * \r\n * @example Constructor args\r\n * ```tsx\r\n * class FetchBehavior extends Behavior {\r\n *   constructor(public url: string, public interval = 5000) {\r\n *     super();\r\n *   }\r\n * }\r\n * ```\r\n * \r\n * @example onCreate args (no constructor boilerplate)\r\n * ```tsx\r\n * class FetchBehavior extends Behavior {\r\n *   url!: string;\r\n *   interval = 5000;\r\n * \r\n *   onCreate(url: string, interval = 5000) {\r\n *     this.url = url;\r\n *     this.interval = interval;\r\n *   }\r\n * }\r\n * ```\r\n */\r\nexport class Behavior {\r\n  onCreate?(...args: any[]): void;\r\n  onLayoutMount?(): void | (() => void);\r\n  onMount?(): void | (() => void);\r\n  onUnmount?(): void;\r\n}\r\n\r\n/**\r\n * Makes a behavior instance observable, handling inheritance properly.\r\n * Similar to makeViewObservable but for behaviors.\r\n */\r\nfunction makeBehaviorObservable<T extends Behavior>(instance: T): void {\r\n  const annotations: AnnotationsMap<T, never> = {} as AnnotationsMap<T, never>;\r\n\r\n  // Collect own properties → observable\r\n  const ownKeys = new Set([\r\n    ...Object.keys(instance),\r\n    ...Object.keys(Object.getPrototypeOf(instance)),\r\n  ]);\r\n\r\n  for (const key of ownKeys) {\r\n    if (BEHAVIOR_EXCLUDES.has(key)) continue;\r\n    if (key in annotations) continue;\r\n\r\n    const value = (instance as any)[key];\r\n    if (typeof value === 'function') continue;\r\n\r\n    (annotations as any)[key] = observable;\r\n  }\r\n\r\n  // Walk prototype chain up to (but not including) Behavior\r\n  let proto = Object.getPrototypeOf(instance);\r\n  while (proto && proto !== Behavior.prototype) {\r\n    const descriptors = Object.getOwnPropertyDescriptors(proto);\r\n\r\n    for (const [key, descriptor] of Object.entries(descriptors)) {\r\n      if (BEHAVIOR_EXCLUDES.has(key)) continue;\r\n      if (key in annotations) continue;\r\n\r\n      if (descriptor.get) {\r\n        (annotations as any)[key] = computed;\r\n      } else if (typeof descriptor.value === 'function') {\r\n        (annotations as any)[key] = action.bound;\r\n      }\r\n    }\r\n\r\n    proto = Object.getPrototypeOf(proto);\r\n  }\r\n\r\n  makeObservable(instance, annotations);\r\n}\r\n\r\n/** @internal */\r\nexport interface BehaviorEntry {\r\n  instance: any;\r\n  cleanup?: () => void;\r\n  layoutCleanup?: () => void;\r\n}\r\n\r\n/**\r\n * Extracts parameter types from onCreate method\r\n */\r\ntype OnCreateParams<T> = T extends { onCreate(...args: infer A): any } ? A : [];\r\n\r\n/**\r\n * Extracts constructor parameter types\r\n */\r\ntype ConstructorParams<T> = T extends new (...args: infer A) => any ? A : [];\r\n\r\n/**\r\n * Determines the args for createBehavior:\r\n * - If constructor has args, use those\r\n * - Otherwise, if onCreate has args, use those\r\n */\r\ntype BehaviorArgs<T extends new (...args: any[]) => any> = \r\n  ConstructorParams<T> extends [] \r\n    ? OnCreateParams<InstanceType<T>> \r\n    : ConstructorParams<T>;\r\n\r\n/**\r\n * Creates a behavior class with automatic observable wrapping and lifecycle management.\r\n * \r\n * Arguments can be passed via constructor OR onCreate - your choice:\r\n * \r\n * @example Constructor args\r\n * ```tsx\r\n * class FetchBehavior extends Behavior {\r\n *   constructor(public url: string, public interval = 5000) {\r\n *     super();\r\n *   }\r\n *   onMount() { ... }\r\n * }\r\n * export default createBehavior(FetchBehavior);\r\n * ```\r\n * \r\n * @example onCreate args (no constructor needed)\r\n * ```tsx\r\n * class FetchBehavior extends Behavior {\r\n *   url!: string;\r\n *   onCreate(url: string, interval = 5000) {\r\n *     this.url = url;\r\n *   }\r\n *   onMount() { ... }\r\n * }\r\n * export default createBehavior(FetchBehavior);\r\n * ```\r\n * \r\n * Usage in a View - just instantiate:\r\n * ```tsx\r\n * class MyView extends View<Props> {\r\n *   fetcher = new FetchBehavior('/api/items', 3000);\r\n * }\r\n * ```\r\n */\r\nexport function createBehavior<T extends new (...args: any[]) => any>(\r\n  Def: T\r\n): new (...args: BehaviorArgs<T>) => InstanceType<T> {\r\n  const BehaviorClass = class extends (Def as any) {\r\n    static [BEHAVIOR_MARKER] = true;\r\n\r\n    constructor(...args: any[]) {\r\n      super(...args);\r\n      \r\n      // Call onCreate with args (if it exists)\r\n      if (typeof this.onCreate === 'function') {\r\n        this.onCreate(...args);\r\n      }\r\n      \r\n      // Make the instance observable (after onCreate so all properties exist)\r\n      makeBehaviorObservable(this);\r\n    }\r\n  };\r\n\r\n  // Preserve the original class name for debugging\r\n  Object.defineProperty(BehaviorClass, 'name', { value: Def.name });\r\n\r\n  return BehaviorClass as any;\r\n}\r\n\r\n/**\r\n * Checks if a value is a behavior instance created by createBehavior()\r\n */\r\nexport function isBehavior(value: unknown): boolean {\r\n  if (value === null || typeof value !== 'object') return false;\r\n  return (value.constructor as any)?.[BEHAVIOR_MARKER] === true;\r\n}\r\n\r\n/** @internal */\r\nexport function layoutMountBehavior(behavior: BehaviorEntry): void {\r\n  const inst = behavior.instance;\r\n\r\n  if ('onLayoutMount' in inst && typeof inst.onLayoutMount === 'function') {\r\n    behavior.layoutCleanup = inst.onLayoutMount() ?? undefined;\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport function mountBehavior(behavior: BehaviorEntry): void {\r\n  const inst = behavior.instance;\r\n\r\n  if ('onMount' in inst && typeof inst.onMount === 'function') {\r\n    behavior.cleanup = inst.onMount() ?? undefined;\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport function unmountBehavior(behavior: BehaviorEntry): void {\r\n  // Call layout cleanup if exists\r\n  behavior.layoutCleanup?.();\r\n\r\n  // Call cleanup if exists\r\n  behavior.cleanup?.();\r\n\r\n  // Call onUnmount if exists\r\n  const inst = behavior.instance;\r\n  if ('onUnmount' in inst && typeof inst.onUnmount === 'function') {\r\n    inst.onUnmount();\r\n  }\r\n}\r\n"],"mappings":"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","names":["import_mobx","reactForwardRef"]}

package/dist/index.d.cts

@@ -0,0 +1,143 @@
+import * as react from 'react';
+import { Ref, JSX } from 'react';
+import { IObservableValue } from 'mobx';
+
+/**
+ * Base class for behaviors. Provides lifecycle method signatures and IDE autocomplete.
+ * Extend this class and wrap with createBehavior().
+ *
+ * You can pass arguments either via constructor or onCreate:
+ *
+ * @example Constructor args
+ * ```tsx
+ * class FetchBehavior extends Behavior {
+ *   constructor(public url: string, public interval = 5000) {
+ *     super();
+ *   }
+ * }
+ * ```
+ *
+ * @example onCreate args (no constructor boilerplate)
+ * ```tsx
+ * class FetchBehavior extends Behavior {
+ *   url!: string;
+ *   interval = 5000;
+ *
+ *   onCreate(url: string, interval = 5000) {
+ *     this.url = url;
+ *     this.interval = interval;
+ *   }
+ * }
+ * ```
+ */
+declare class Behavior {
+    onCreate?(...args: any[]): void;
+    onLayoutMount?(): void | (() => void);
+    onMount?(): void | (() => void);
+    onUnmount?(): void;
+}
+/** @internal */
+interface BehaviorEntry {
+    instance: any;
+    cleanup?: () => void;
+    layoutCleanup?: () => void;
+}
+/**
+ * Extracts parameter types from onCreate method
+ */
+type OnCreateParams<T> = T extends {
+    onCreate(...args: infer A): any;
+} ? A : [];
+/**
+ * Extracts constructor parameter types
+ */
+type ConstructorParams<T> = T extends new (...args: infer A) => any ? A : [];
+/**
+ * Determines the args for createBehavior:
+ * - If constructor has args, use those
+ * - Otherwise, if onCreate has args, use those
+ */
+type BehaviorArgs<T extends new (...args: any[]) => any> = ConstructorParams<T> extends [] ? OnCreateParams<InstanceType<T>> : ConstructorParams<T>;
+/**
+ * Creates a behavior class with automatic observable wrapping and lifecycle management.
+ *
+ * Arguments can be passed via constructor OR onCreate - your choice:
+ *
+ * @example Constructor args
+ * ```tsx
+ * class FetchBehavior extends Behavior {
+ *   constructor(public url: string, public interval = 5000) {
+ *     super();
+ *   }
+ *   onMount() { ... }
+ * }
+ * export default createBehavior(FetchBehavior);
+ * ```
+ *
+ * @example onCreate args (no constructor needed)
+ * ```tsx
+ * class FetchBehavior extends Behavior {
+ *   url!: string;
+ *   onCreate(url: string, interval = 5000) {
+ *     this.url = url;
+ *   }
+ *   onMount() { ... }
+ * }
+ * export default createBehavior(FetchBehavior);
+ * ```
+ *
+ * Usage in a View - just instantiate:
+ * ```tsx
+ * class MyView extends View<Props> {
+ *   fetcher = new FetchBehavior('/api/items', 3000);
+ * }
+ * ```
+ */
+declare function createBehavior<T extends new (...args: any[]) => any>(Def: T): new (...args: BehaviorArgs<T>) => InstanceType<T>;
+
+/**
+ * Global configuration options for mobx-mantle
+ */
+interface MantleConfig {
+    /** Whether to automatically make View instances observable (default: true) */
+    autoObservable?: boolean;
+}
+/**
+ * Configure global defaults for mobx-mantle.
+ * Settings can still be overridden per-view in createView options.
+ */
+declare function configure(config: MantleConfig): void;
+declare class View<P = {}> {
+    /** @internal */
+    _propsBox: IObservableValue<P>;
+    get props(): P;
+    set props(value: P);
+    forwardRef?: Ref<any>;
+    /** @internal */
+    _behaviors: BehaviorEntry[];
+    onCreate?(): void;
+    onLayoutMount?(): void | (() => void);
+    onMount?(): void | (() => void);
+    onUnmount?(): void;
+    ref<T extends HTMLElement = HTMLElement>(): {
+        current: T | null;
+    };
+    /** @internal - Scan own properties for behavior instances and register them */
+    _collectBehaviors(): void;
+    /** @internal */
+    _layoutMountBehaviors(): void;
+    /** @internal */
+    _mountBehaviors(): void;
+    /** @internal */
+    _unmountBehaviors(): void;
+    render?(): JSX.Element;
+}
+
+type PropsOf<V> = V extends View<infer P> ? P : object;
+declare function createView<V extends View<any>>(ViewClass: new () => V, templateOrOptions?: ((vm: V) => JSX.Element) | {
+    autoObservable?: boolean;
+}): react.ForwardRefExoticComponent<react.PropsWithoutRef<PropsOf<V>> & react.RefAttributes<unknown>> & {
+    displayName: string;
+};
+
+export { Behavior, type MantleConfig, View, View as ViewModel, configure, createBehavior, createView };

package/dist/index.d.ts

@@ -0,0 +1,143 @@
+import * as react from 'react';
+import { Ref, JSX } from 'react';
+import { IObservableValue } from 'mobx';
+
+/**
+ * Base class for behaviors. Provides lifecycle method signatures and IDE autocomplete.
+ * Extend this class and wrap with createBehavior().
+ *
+ * You can pass arguments either via constructor or onCreate:
+ *
+ * @example Constructor args
+ * ```tsx
+ * class FetchBehavior extends Behavior {
+ *   constructor(public url: string, public interval = 5000) {
+ *     super();
+ *   }
+ * }
+ * ```
+ *
+ * @example onCreate args (no constructor boilerplate)
+ * ```tsx
+ * class FetchBehavior extends Behavior {
+ *   url!: string;
+ *   interval = 5000;
+ *
+ *   onCreate(url: string, interval = 5000) {
+ *     this.url = url;
+ *     this.interval = interval;
+ *   }
+ * }
+ * ```
+ */
+declare class Behavior {
+    onCreate?(...args: any[]): void;
+    onLayoutMount?(): void | (() => void);
+    onMount?(): void | (() => void);
+    onUnmount?(): void;
+}
+/** @internal */
+interface BehaviorEntry {
+    instance: any;
+    cleanup?: () => void;
+    layoutCleanup?: () => void;
+}
+/**
+ * Extracts parameter types from onCreate method
+ */
+type OnCreateParams<T> = T extends {
+    onCreate(...args: infer A): any;
+} ? A : [];
+/**
+ * Extracts constructor parameter types
+ */
+type ConstructorParams<T> = T extends new (...args: infer A) => any ? A : [];
+/**
+ * Determines the args for createBehavior:
+ * - If constructor has args, use those
+ * - Otherwise, if onCreate has args, use those
+ */
+type BehaviorArgs<T extends new (...args: any[]) => any> = ConstructorParams<T> extends [] ? OnCreateParams<InstanceType<T>> : ConstructorParams<T>;
+/**
+ * Creates a behavior class with automatic observable wrapping and lifecycle management.
+ *
+ * Arguments can be passed via constructor OR onCreate - your choice:
+ *
+ * @example Constructor args
+ * ```tsx
+ * class FetchBehavior extends Behavior {
+ *   constructor(public url: string, public interval = 5000) {
+ *     super();
+ *   }
+ *   onMount() { ... }
+ * }
+ * export default createBehavior(FetchBehavior);
+ * ```
+ *
+ * @example onCreate args (no constructor needed)
+ * ```tsx
+ * class FetchBehavior extends Behavior {
+ *   url!: string;
+ *   onCreate(url: string, interval = 5000) {
+ *     this.url = url;
+ *   }
+ *   onMount() { ... }
+ * }
+ * export default createBehavior(FetchBehavior);
+ * ```
+ *
+ * Usage in a View - just instantiate:
+ * ```tsx
+ * class MyView extends View<Props> {
+ *   fetcher = new FetchBehavior('/api/items', 3000);
+ * }
+ * ```
+ */
+declare function createBehavior<T extends new (...args: any[]) => any>(Def: T): new (...args: BehaviorArgs<T>) => InstanceType<T>;
+
+/**
+ * Global configuration options for mobx-mantle
+ */
+interface MantleConfig {
+    /** Whether to automatically make View instances observable (default: true) */
+    autoObservable?: boolean;
+}
+/**
+ * Configure global defaults for mobx-mantle.
+ * Settings can still be overridden per-view in createView options.
+ */
+declare function configure(config: MantleConfig): void;
+declare class View<P = {}> {
+    /** @internal */
+    _propsBox: IObservableValue<P>;
+    get props(): P;
+    set props(value: P);
+    forwardRef?: Ref<any>;
+    /** @internal */
+    _behaviors: BehaviorEntry[];
+    onCreate?(): void;
+    onLayoutMount?(): void | (() => void);
+    onMount?(): void | (() => void);
+    onUnmount?(): void;
+    ref<T extends HTMLElement = HTMLElement>(): {
+        current: T | null;
+    };
+    /** @internal - Scan own properties for behavior instances and register them */
+    _collectBehaviors(): void;
+    /** @internal */
+    _layoutMountBehaviors(): void;
+    /** @internal */
+    _mountBehaviors(): void;
+    /** @internal */
+    _unmountBehaviors(): void;
+    render?(): JSX.Element;
+}
+
+type PropsOf<V> = V extends View<infer P> ? P : object;
+declare function createView<V extends View<any>>(ViewClass: new () => V, templateOrOptions?: ((vm: V) => JSX.Element) | {
+    autoObservable?: boolean;
+}): react.ForwardRefExoticComponent<react.PropsWithoutRef<PropsOf<V>> & react.RefAttributes<unknown>> & {
+    displayName: string;
+};
+
+export { Behavior, type MantleConfig, View, View as ViewModel, configure, createBehavior, createView };