@geastack/core 0.1.27 → 0.1.29

package/README.md

@@ -24,6 +24,39 @@ and include roots to compile, and run its build driver, which bundles the app
 with Vite, compiles it with `geatsc` and the Gea plugin, and hands the emitted
 C++ to the target.
 
+## Component startup
+
+Use `@geastack/core` for applications targeting the native GeaStack hosts.
+`Component` is the component base; `ReactiveComponent` makes its own fields
+reactive, and `Store` holds shared reactive state. The web target supplies the
+matching browser runtime. Direct use of `@geajs/core` belongs to the Gea web
+framework and is not the native application contract.
+
+Start loading data or drawing in `onAfterRender()`. The component's `el` is set
+before this hook runs. Field initializers and constructors initialize state;
+code that needs a rendered canvas belongs in the hook.
+
+```tsx
+import { ReactiveComponent } from '@geastack/core'
+
+class Counter extends ReactiveComponent {
+  count = 0
+  onAfterRender(): void {
+    this.count = 1
+  }
+  template(): JSX.Element {
+    return <div>{this.count}</div>
+  }
+}
+```
+
+Compiler/runtime regressions should use generic language or framework cases.
+Report compiler issues in `geastack/compiler`, host API and application-runtime
+issues in `geastack/core`, Apple rendering/bindings in `geastack/apple`, and web
+target integration in `geastack/simulator`. Contributions should include a
+reproduction and target-specific validation. Lifecycle and representation
+changes need to preserve the shared component and native-type contracts.
+
 ## Related packages
 
 - `@geastack/engine` renders the element tree, `@geastack/host` supplies the

package/index.d.ts

@@ -746,6 +746,8 @@ export class Component<RootElement extends GeaElement = GeaElement, Props = void
   // same thing as the mounted host node `el` points at. `null` is the base's
   // own stub answer in `runtime/compiler.ts`.
   template(props?: Props): GeaJsxElement | null
+  /** Called after the rendered root is available in el; start loading or drawing here. */
+  onAfterRender(): void
 }
 
 // Opt-in base for a component that holds its OWN reactive state — its instance

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geastack/core",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "description": "GeaStack app API, reactivity headers, runtime sources, and type declarations.",
   "license": "Apache-2.0",
   "repository": {
@@ -62,8 +62,8 @@
     "@babel/types": "^7.23.0",
     "@geajs/core": "1.5.1",
     "@geajs/vite-plugin": "1.5.0",
-    "@geastack/compiler": "^1.0.15",
-    "@geastack/geatsc-plugin-gea": "^0.1.8",
+    "@geastack/compiler": "^1.0.19",
+    "@geastack/geatsc-plugin-gea": "^0.1.9",
     "opentype.js": "^2.0.0",
     "vite": "^8.0.0"
   }

package/runtime/compiler.ts

@@ -22,6 +22,7 @@ export class Component<RootElement extends GeaElement = GeaElement, Props = void
   template(_props?: Props): GeaJsxElement | null {
     return null
   }
+  onAfterRender(): void {}
   // NB: deliberately NO `render` here. `render` is synthesised onto compiled
   // components by the embedded compiler. Declaring it on the base looks tidier
   // (it would let mount() drop its cast) but it BREAKS embedded codegen: once