@geastack/core 0.1.26 → 0.1.28

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/include/image.h

@@ -124,11 +124,9 @@ private:
 	void materializeDeferred(int id) const;
 	int decodeGif(ImageSlot &image, const std::uint8_t *data, int length);
 	int decodeStatic(ImageSlot &image, const std::uint8_t *data, int length, bool opaqueHint);
-#if defined(GEA_EMBEDDED_ROM_TJPGD) && GEA_EMBEDDED_ROM_TJPGD
-	// Low-memory JPEG decode via the ESP32 ROM tinyjpeg decompressor (descales
-	// large covers so they fit the fragmented PSRAM). Fills `image`, returns 0/-1.
+	// Native JPEG backends, selected automatically when provided by the target.
+	int decodeJpegEsp(ImageSlot &image, const std::uint8_t *data, int length);
 	int decodeJpegTjpgd(ImageSlot &image, const std::uint8_t *data, int length);
-#endif
 	int decodeNextGifFrame(ImageSlot &image);
 	// dispose() body without taking slotMutex_ (callers hold it).
 	void disposeLocked(int id);

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.26",
+  "version": "0.1.28",
   "description": "GeaStack app API, reactivity headers, runtime sources, and type declarations.",
   "license": "Apache-2.0",
   "repository": {
@@ -60,10 +60,10 @@
     "@babel/parser": "^7.23.0",
     "@babel/traverse": "^7.23.0",
     "@babel/types": "^7.23.0",
-    "@geajs/core": "1.4.3",
-    "@geajs/vite-plugin": "1.4.3",
+    "@geajs/core": "1.5.1",
+    "@geajs/vite-plugin": "1.5.0",
     "@geastack/compiler": "^1.0.15",
-    "@geastack/geatsc-plugin-gea": "^0.1.7",
+    "@geastack/geatsc-plugin-gea": "^0.1.8",
     "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

package/scripts/build-gea-vite-geatsc.mjs

@@ -493,6 +493,7 @@ function writeCompatViteConfig({ configPath, compatSrcDir, appDir, entry, viteOu
     .join('\n')
   const config = `import { resolve } from 'node:path'
 import { geaPlugin } from ${q(geaPluginResolved)}
+import { geaNativeStylePlugin } from ${q(path.join(coreRoot, 'scripts/gea-native-style-plugin.mjs'))}
 import { geaAppleNativeModuleAliases, geaModuleGraphPlugins } from ${q(moduleGraphPluginPath)}
 
 const root = ${q(compatSrcDir)}
@@ -510,7 +511,7 @@ export default {
   define: {
 ${defineEntries}
   },
-  plugins: [geaPlugin({ ir: { enabled: true, outFile: ${q(geaIrPath)} } }), ...geaModuleGraph],
+  plugins: [geaNativeStylePlugin({ runtimeEntry: ${q(compilerRuntimeEntry)} }), geaPlugin({ ir: { enabled: true, outFile: ${q(geaIrPath)} } }), ...geaModuleGraph],
   resolve: {
     alias: [
 ${compilerRuntimeAlias}

package/scripts/gea-native-style-plugin.mjs

@@ -0,0 +1,31 @@
+import fs from 'node:fs'
+import path from 'node:path'
+
+/** Native lengths are raw numbers; only an authored CSS unit may introduce scaling. */
+export function geaNativeStylePlugin({ runtimeEntry }) {
+  if (!runtimeEntry) throw new Error('Native Gea styles require the typed @geajs/core source entry')
+  const sourceRoot = path.dirname(fs.realpathSync(runtimeEntry))
+  const serializer = path.join(sourceRoot, 'runtime/style-value.ts')
+  return {
+    name: 'geastack-native-style-units',
+    enforce: 'pre',
+    // Keep all compiler-generated runtime imports on the same typed source tree.
+    // Aliasing only the root left compiler-runtime on the browser dist path.
+    resolveId(id) {
+      const name = id === '@geajs/core' ? 'index' : id.startsWith('@geajs/core/') ? id.slice('@geajs/core/'.length) : null
+      if (name === null) return null
+      return [path.join(sourceRoot, `${name}.ts`), path.join(sourceRoot, name, 'index.ts')].find(entry => fs.existsSync(entry)) || null
+    },
+    load(id) {
+      if (id.split('?')[0] !== serializer) return null
+      // This module is the browser serialization boundary, not the JSX IR.
+      // Replacing it here preserves numeric values in the native IR and prevents
+      // browser px defaults from reaching native runtime-backed components/h().
+      return `export function styleProp(key: string): string {
+  return key.startsWith('--') ? key : key.replace(/[A-Z]/g, c => '-' + c.toLowerCase())
+}
+export function styleValue(_property: string, value: unknown): string { return String(value) }
+`
+    },
+  }
+}