@tschk/moonshine-astro 0.0.0-stage → 0.4.4

package/README.md

@@ -1,3 +1,36 @@
-# Temporary Holding Version
+# `@tschk/moonshine-astro`
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The root provides native Moonshine signal bridges and a lazy native renderer.
+At runtime, root imports need neither Astro, React, parser WASM nor the optional
+framework peer. Legacy host APIs remain explicit on their existing subpaths.
+
+Strict TypeScript checking of the root entry requires installing
+`@tschk/moonshine-framework`, even when importing only a bridge: the root also
+exports `crepusRenderer` with the framework's `Renderer` contract. The framework
+remains optional for runtime imports and bridge-only browser/Bun/Node bundles.
+This requirement does not apply to the signal-only `@tschk/moonshine` core entry.
+
+```ts
+import { fromMoonshineSignal, crepusRenderer } from "@tschk/moonshine-astro";
+```
+
+| Entry        | Provides                                       |
+| ------------ | ---------------------------------------------- |
+| `.`          | Native signal bridges and lazy native renderer |
+| `./compiler` | Legacy Astro compiler re-exports               |
+
+`crepusRenderer` preserves its compatibility name but renders native server
+factories, escaped metadata, API JSON and SPA shells. Install
+`@tschk/moonshine-framework` when invoking this source-file compatibility facade
+under Bun. Bundled deployments use `@tschk/moonshine-dom/framework-native`
+explicitly; the facade intentionally keeps source loading outside the static
+bundle graph. Legacy React/View IR page outputs reject; native island hydration
+is unsupported. The renderer loads only when
+called, so signal bridge consumers do not load server rendering.
+
+Legacy entries require their optional host peers: `astro`. They cannot be
+aliased over arbitrary host-compiled output to remove the host.
+
+The compiler entry still requires Astro. Native rendering expects compiled Moonshine server factories; it does not execute Astro frontmatter or implement the Astro compiler result shapes.
+Source parsing and compilation belong to Crepuscularity; these root runtime
+changes do not establish full Astro source support.

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@tschk/moonshine-astro",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.4.4",
+  "description": "Native signal bridges and rendering with optional legacy astro entries",
+  "license": "ISC",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./compiler": "./src/compiler.ts"
+  },
+  "dependencies": {
+    "@tschk/moonshine": "^0.4.4",
+    "@tschk/moonshine-dom": "^0.4.4"
+  },
+  "devDependencies": {
+    "typescript": "7.0.2"
+  },
+  "peerDependencies": {
+    "astro": ">=4",
+    "@tschk/moonshine-framework": "^0.4.4"
+  },
+  "peerDependenciesMeta": {
+    "astro": {
+      "optional": true
+    },
+    "@tschk/moonshine-framework": {
+      "optional": true
+    }
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "keywords": [
+    "moonshine",
+    "astro",
+    "adapter"
+  ],
+  "scripts": {
+    "format": "bunx prettier --check .",
+    "lint": "bunx oxlint .",
+    "typecheck": "bunx tsc --noEmit",
+    "test": "bun test"
+  }
+}

package/src/compiler.ts

@@ -0,0 +1 @@
+export { transform, parse, convertToTSX } from "astro/compiler";

package/src/index.ts

@@ -0,0 +1,36 @@
+/** Native signal bridges and a lazy native renderer; host APIs remain on legacy subpaths. */
+import {
+  createSignal as msCreateSignal,
+  type Signal as MsSignal,
+} from "@tschk/moonshine";
+
+export type Readable<T> = {
+  get: () => T;
+  subscribe: (fn: (value: T) => void) => () => void;
+};
+
+export function fromMoonshineSignal<T>(signal: MsSignal<T>): Readable<T> {
+  return {
+    get: () => signal(),
+    subscribe: (fn) => {
+      fn(signal());
+      return signal.subscribe(() => fn(signal()));
+    },
+  };
+}
+
+export function createBridgedReadable<T>(initial: T): Readable<T> {
+  return fromMoonshineSignal(msCreateSignal(initial));
+}
+
+export { msCreateSignal as createMoonshineSignal };
+export type { MsSignal as MoonshineSignal };
+export {
+  createResource,
+  createSignal as createMsSignal,
+  createMemo,
+  batch,
+  untrack,
+} from "@tschk/moonshine";
+export type { Resource, ResourceStatus } from "@tschk/moonshine";
+export { crepusRenderer } from "@tschk/moonshine-dom/framework-lazy";

package/src/shims.d.ts

@@ -0,0 +1,5 @@
+declare module "astro/compiler" {
+  export const transform: unknown;
+  export const parse: unknown;
+  export const convertToTSX: unknown;
+}