@mintjamsinc/ichigojs 0.1.78 → 0.1.79

package/dist/types/ichigo/components/IchigoElement.d.ts

@@ -40,11 +40,32 @@ export declare class IchigoElement extends HTMLElement {
      * belong to this component's VApplication and scope).
      */
     _ichigoExpanded: boolean;
+    /**
+     * True when this element came from an enclosing component's template clone
+     * (marked by that component while it expands). Such an element connects
+     * while the enclosing component is attaching its template — before that
+     * component's VApplication exists — so it must wait to be compiled by the
+     * owning application before expanding itself (see connectedCallback guard
+     * 0a2 and {@link _ichigoTryExpand}).
+     *
+     * Declared with `declare` for the same reason as {@link _ichigoHost}: the
+     * mark is set before the element is upgraded, and a real class field would
+     * be re-defined as undefined by the upgrade.
+     */
+    _ichigoTemplateOwned?: boolean;
     /**
      * Host context installed by the parent application's VNode when it
      * compiles this element. Gives component-boundary features (e.g. scoped
      * slot outlets) access to the parent scope. Undefined when the element is
      * placed outside any ichigo application.
+     *
+     * Declared with `declare` on purpose: the application installs it BEFORE
+     * the element is upgraded whenever the element comes from a `<template>`
+     * (v-if / v-for on a `<template>` clones `content`, whose owner document
+     * has no browsing context, so custom elements there stay uncustomized
+     * until the clone is inserted). A real class field would be re-defined as
+     * undefined by the upgrade — erasing the host context and leaving scoped
+     * slot outlets without a parent scope.
      */
     _ichigoHost?: {
         vNode: VNode;
@@ -57,6 +78,16 @@ export declare class IchigoElement extends HTMLElement {
     get _ichigoScopedSlots(): Map<string, ScopedSlotEntry> | undefined;
     connectedCallback(): void;
     disconnectedCallback(): void;
+    /**
+     * Expands this element's template on behalf of the application that owns
+     * it. Called by VNode right after it compiled this element — the host
+     * context is installed and the prop bindings have delivered their values,
+     * so a component that deferred its expansion (guard 0a2, or a template
+     * that was not loaded when it connected) can now expand in the right
+     * order. A no-op when the element is already expanded or not connected
+     * (a template-source clone expands when it is inserted).
+     */
+    _ichigoTryExpand(): void;
     /**
      * Called by the property setters generated by defineComponent().
      * Before mount: stores the value and schedules a mount microtask.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintjamsinc/ichigojs",
-  "version": "0.1.78",
+  "version": "0.1.79",
   "description": "ichigo.js - Simple and intuitive reactive framework. Lightweight, fast, and user-friendly virtual DOM library",
   "main": "./dist/ichigo.cjs",
   "module": "./dist/ichigo.esm.js",