@typed/astro 1.0.0-beta.7

package/README.md

@@ -0,0 +1,70 @@
+# @typed/astro
+
+Render Typed templates on the server and hydrate them as Astro islands. Astro owns pages, routing, asset delivery, and hydration scheduling. Typed owns each island's rendering, reactive state, and Scope.
+
+```ts
+// astro.config.ts
+import { defineConfig } from "astro/config";
+import typed from "@typed/astro";
+
+export default defineConfig({ integrations: [typed()] });
+```
+
+Export a component from an ordinary TypeScript module:
+
+```ts
+// Counter.ts
+import { component } from "@typed/astro/Component";
+import * as RefSubject from "@typed/fx/RefSubject";
+import { html } from "@typed/template";
+
+export default component(function* (props: { initial: number }) {
+  const count = yield* RefSubject.make(props.initial);
+  return html`<button @click=${RefSubject.update(count, (n) => n + 1)}>Count: ${count}</button>`;
+});
+```
+
+```astro
+---
+import Counter from "./Counter";
+---
+<Counter initial={1} client:load />
+```
+
+`component` uses the same generator and argument-forwarding conventions as `@typed/ui/Component`. A generator with no parameters produces a lazy Fx value; a generator with parameters produces a function. Return any Renderable, including strings, arrays, Effects, and templates. Optional pipeline functions receive the Fx and the original arguments, preserving errors and required services. Astro normalizes the generator return inside a template boundary, so its Fx emits `RenderEvent` values and requires `Scope | RenderTemplate` in addition to the generator and returned value’s services. This installs hydration context before nested templates run. Pipeline callbacks receive this normalized Fx; keep the final result renderable. A zero-argument pipeline that returns a primitive instead of an object throws because it cannot carry an island brand. The explicit Astro brand identifies candidates without running them; it does not validate that a final pipeline result is renderable.
+
+The integration supplies `RenderTemplate` and `Scope`. Provide additional application services with an Fx pipeline before exporting an island. State acquired inside the generator is recreated separately for each request and browser island, including zero-argument component values.
+
+Without a client directive, Astro emits server-rendered HTML and sends no Typed island JavaScript. `client:load`, `client:idle`, `client:visible`, and `client:media` hydrate Typed's server markers and retain matching DOM nodes. `client:only="@typed/astro"` skips SSR and replaces the fallback when mounting. Pass serializable props as required by Astro; initialize server and browser state consistently. Explicit `RefSubject.hydrate` remains available for adopting live DOM property state such as pre-hydration input edits; the integration does not serialize arbitrary Effect state.
+
+Each SSR call closes its Scope after collecting HTML. Each browser island retains its Scope until Astro dispatches `astro:unmount`. A repeated Astro render with new props closes the previous Scope and runs the component again, resetting generator-local state. Failed initial renders reject Astro's hydration promise. Subsequent rendering failures dispatch `typed:error` on the island with the Effect Cause in `event.detail`.
+
+## Slots
+
+The second argument contains default and named Astro slots as optional Typed renderables:
+
+```ts
+import { component, type Slots } from "@typed/astro/Component";
+import { html } from "@typed/template";
+
+export default component(function* (_props: {}, slots: Slots) {
+  return html`<article>
+    ${slots.heading}
+    <main>${slots.default}</main>
+  </article>`;
+});
+```
+
+Astro supplies pre-rendered slot HTML. The integration uses `astro-slot` elements for hydrated components and `astro-static-slot` markers for static components, which Astro strips before passing their content to an ancestor. It adopts the existing live slot elements on hydration, preserving child DOM identity and listeners. Ordinary component props still pass through Typed's contextual escaping. Slot renderables are opaque, borrowed content: insert each once; Astro and nested islands retain responsibility for their contents. Do not pass unsanitized external HTML as an Astro raw-HTML slot.
+
+## Validation
+
+```sh
+pnpm --filter @typed/astro build
+pnpm --filter @typed/astro test
+pnpm --filter @typed/astro test:integration
+```
+
+The browser suite checks matching-node hydration, reactive updates, isolated state, repeated renders, slot ownership, and unmount cleanup. The production Astro fixture checks SSR and all five built-in hydration directives in Chromium.
+
+The integration follows Astro's [Renderer API](https://docs.astro.build/en/reference/renderer-reference/) and [Integration API](https://docs.astro.build/en/reference/integrations-reference/).

package/dist/Component.d.ts

@@ -0,0 +1,179 @@
+import type * as Effect from "effect/Effect";
+import * as Fx from "@typed/fx/Fx";
+import { type Renderable } from "@typed/template";
+import type { RenderEvent } from "@typed/template/RenderEvent";
+import type { Scope } from "effect/Scope";
+import type { RenderTemplate } from "@typed/template/RenderTemplate";
+declare const TypeId: unique symbol;
+/**
+ * Named Astro slots available to a component generator's second argument.
+ *
+ * Astro owns the serialized or existing slot content. Insert each present slot
+ * once as opaque output; a missing named slot is undefined. Re-rendering its
+ * descendants with Typed would give two renderers ownership of the same range.
+ *
+ * @since 1.0.0
+ * @category Astro slots
+ */
+export type Slots = Readonly<Record<string, Fx.Fx<RenderEvent> | undefined>>;
+/**
+ * Rendering services supplied by Astro for each server request or browser island.
+ * Application services remain visible in the component's requirements and must
+ * be provided by the component's pipeline or application boundary.
+ *
+ * @since 1.0.0
+ * @category Island services
+ */
+export type Services = Scope | RenderTemplate;
+type ComponentFx<Yield extends Effect.Effect<any, any, any>, Result extends Renderable.Any> = Fx.Fx<RenderEvent, Effect.Error<Yield> | Renderable.Error<Result>, Effect.Services<Yield> | Renderable.Services<Result> | Services>;
+type AstroValue<Result> = Result extends Fx.Fx<any, any, any> ? Result & {
+    (_props?: {}, _slots?: Slots): Result;
+    readonly [TypeId]: true;
+} : Result;
+type ComponentResult<Args extends ReadonlyArray<any>, Result> = Args extends readonly [] ? AstroValue<Result> : (...args: Args) => Result;
+/**
+ * Generator and argument-aware pipeline contracts for Astro components.
+ *
+ * @since 1.0.0
+ * @category Generator contracts
+ */
+export declare namespace component {
+    /**
+     * Overloads preserving generator arguments, yielded errors and services, and
+     * the returned renderable's errors and services before optional pipelines.
+     *
+     * @since 1.0.0
+     * @category Generator contracts
+     */
+    type Gen = {
+        /**
+         * Creates a component directly for a zero-argument body.
+         *
+         * @since 1.0.0
+         * @category Zero-argument components
+         */
+        <Yield extends Effect.Effect<any, any, any>, const Result extends Renderable.Any>(body: () => Generator<Yield, Result, any>): AstroValue<ComponentFx<Yield, Result>>;
+        /**
+         * Creates a component function while preserving the generator's parameters.
+         *
+         * @since 1.0.0
+         * @category Parameterized components
+         */
+        <Args extends readonly [any, ...ReadonlyArray<any>], Yield extends Effect.Effect<any, any, any>, const Result extends Renderable.Any>(body: (...args: Args) => Generator<Yield, Result, any>): (...args: Args) => ComponentFx<Yield, Result>;
+        /**
+         * Applies one argument-aware transformation to the generated Fx.
+         *
+         * @since 1.0.0
+         * @category Argument-aware pipelines
+         */
+        <Args extends ReadonlyArray<any>, Yield extends Effect.Effect<any, any, any>, const Result extends Renderable.Any, A>(body: (...args: Args) => Generator<Yield, Result, any>, a: (_: ComponentFx<Yield, Result>, ...args: Args) => A): ComponentResult<Args, A>;
+        /**
+         * Applies two ordered argument-aware transformations to the generated Fx.
+         *
+         * @since 1.0.0
+         * @category Argument-aware pipelines
+         */
+        <Args extends ReadonlyArray<any>, Yield extends Effect.Effect<any, any, any>, const Result extends Renderable.Any, A, B>(body: (...args: Args) => Generator<Yield, Result, any>, a: (_: ComponentFx<Yield, Result>, ...args: Args) => A, b: (_: A, ...args: Args) => B): ComponentResult<Args, B>;
+        /**
+         * Applies three ordered argument-aware transformations to the generated Fx.
+         *
+         * @since 1.0.0
+         * @category Argument-aware pipelines
+         */
+        <Args extends ReadonlyArray<any>, Yield extends Effect.Effect<any, any, any>, const Result extends Renderable.Any, A, B, C>(body: (...args: Args) => Generator<Yield, Result, any>, a: (_: ComponentFx<Yield, Result>, ...args: Args) => A, b: (_: A, ...args: Args) => B, c: (_: B, ...args: Args) => C): ComponentResult<Args, C>;
+        /**
+         * Applies four ordered argument-aware transformations to the generated Fx.
+         *
+         * @since 1.0.0
+         * @category Argument-aware pipelines
+         */
+        <Args extends ReadonlyArray<any>, Yield extends Effect.Effect<any, any, any>, const Result extends Renderable.Any, A, B, C, D>(body: (...args: Args) => Generator<Yield, Result, any>, a: (_: ComponentFx<Yield, Result>, ...args: Args) => A, b: (_: A, ...args: Args) => B, c: (_: B, ...args: Args) => C, d: (_: C, ...args: Args) => D): ComponentResult<Args, D>;
+        /**
+         * Applies five ordered argument-aware transformations to the generated Fx.
+         *
+         * @since 1.0.0
+         * @category Argument-aware pipelines
+         */
+        <Args extends ReadonlyArray<any>, Yield extends Effect.Effect<any, any, any>, const Result extends Renderable.Any, A, B, C, D, E>(body: (...args: Args) => Generator<Yield, Result, any>, a: (_: ComponentFx<Yield, Result>, ...args: Args) => A, b: (_: A, ...args: Args) => B, c: (_: B, ...args: Args) => C, d: (_: C, ...args: Args) => D, e: (_: D, ...args: Args) => E): ComponentResult<Args, E>;
+        /**
+         * Applies six ordered argument-aware transformations to the generated Fx.
+         *
+         * @since 1.0.0
+         * @category Argument-aware pipelines
+         */
+        <Args extends ReadonlyArray<any>, Yield extends Effect.Effect<any, any, any>, const Result extends Renderable.Any, A, B, C, D, E, F>(body: (...args: Args) => Generator<Yield, Result, any>, a: (_: ComponentFx<Yield, Result>, ...args: Args) => A, b: (_: A, ...args: Args) => B, c: (_: B, ...args: Args) => C, d: (_: C, ...args: Args) => D, e: (_: D, ...args: Args) => E, f: (_: E, ...args: Args) => F): ComponentResult<Args, F>;
+        /**
+         * Applies seven ordered argument-aware transformations to the generated Fx.
+         *
+         * @since 1.0.0
+         * @category Argument-aware pipelines
+         */
+        <Args extends ReadonlyArray<any>, Yield extends Effect.Effect<any, any, any>, const Result extends Renderable.Any, A, B, C, D, E, F, G>(body: (...args: Args) => Generator<Yield, Result, any>, a: (_: ComponentFx<Yield, Result>, ...args: Args) => A, b: (_: A, ...args: Args) => B, c: (_: B, ...args: Args) => C, d: (_: C, ...args: Args) => D, e: (_: D, ...args: Args) => E, f: (_: E, ...args: Args) => F, g: (_: F, ...args: Args) => G): ComponentResult<Args, G>;
+        /**
+         * Applies eight ordered argument-aware transformations to the generated Fx.
+         *
+         * @since 1.0.0
+         * @category Argument-aware pipelines
+         */
+        <Args extends ReadonlyArray<any>, Yield extends Effect.Effect<any, any, any>, const Result extends Renderable.Any, A, B, C, D, E, F, G, H>(body: (...args: Args) => Generator<Yield, Result, any>, a: (_: ComponentFx<Yield, Result>, ...args: Args) => A, b: (_: A, ...args: Args) => B, c: (_: B, ...args: Args) => C, d: (_: C, ...args: Args) => D, e: (_: D, ...args: Args) => E, f: (_: E, ...args: Args) => F, g: (_: F, ...args: Args) => G, h: (_: G, ...args: Args) => H): ComponentResult<Args, H>;
+        /**
+         * Applies nine ordered argument-aware transformations to the generated Fx.
+         *
+         * @since 1.0.0
+         * @category Argument-aware pipelines
+         */
+        <Args extends ReadonlyArray<any>, Yield extends Effect.Effect<any, any, any>, const Result extends Renderable.Any, A, B, C, D, E, F, G, H, I>(body: (...args: Args) => Generator<Yield, Result, any>, a: (_: ComponentFx<Yield, Result>, ...args: Args) => A, b: (_: A, ...args: Args) => B, c: (_: B, ...args: Args) => C, d: (_: C, ...args: Args) => D, e: (_: D, ...args: Args) => E, f: (_: E, ...args: Args) => F, g: (_: F, ...args: Args) => G, h: (_: G, ...args: Args) => H, i: (_: H, ...args: Args) => I): ComponentResult<Args, I>;
+        /**
+         * Applies ten ordered argument-aware transformations to the generated Fx.
+         *
+         * @since 1.0.0
+         * @category Argument-aware pipelines
+         */
+        <Args extends ReadonlyArray<any>, Yield extends Effect.Effect<any, any, any>, const Result extends Renderable.Any, A, B, C, D, E, F, G, H, I, J>(body: (...args: Args) => Generator<Yield, Result, any>, a: (_: ComponentFx<Yield, Result>, ...args: Args) => A, b: (_: A, ...args: Args) => B, c: (_: B, ...args: Args) => C, d: (_: C, ...args: Args) => D, e: (_: D, ...args: Args) => E, f: (_: E, ...args: Args) => F, g: (_: F, ...args: Args) => G, h: (_: G, ...args: Args) => H, i: (_: H, ...args: Args) => I, j: (_: I, ...args: Args) => J): ComponentResult<Args, J>;
+    };
+}
+/**
+ * Defines a Typed Astro island with the generator and pipeline semantics of
+ * @typed/ui/Component. Zero-argument generators produce lazy, callable Fx values
+ * accepted by Astro markup; calling one returns its Fx without running it.
+ * Parameterized generators produce functions. Each generator may return any
+ * Renderable, normalized to RenderEvents under Astro's hydration boundary.
+ * Pipes receive that Fx and the original arguments. Provide application services
+ * in a pipe; Astro supplies Scope and RenderTemplate. Each run owns its state.
+ * A zero-argument pipeline must retain an object value so it can carry the brand.
+ *
+ * @example
+ * ```ts
+ * import { component } from "@typed/astro/Component"
+ * import { RefSubject } from "@typed/fx"
+ * import { html } from "@typed/template"
+ *
+ * export const Quantity = component(function* ({ initial }: { initial: number }) {
+ *   const quantity = yield* RefSubject.make(initial)
+ *   return html`<output>${quantity}</output>`
+ * })
+ * ```
+ *
+ * @since 1.0.0
+ * @category Island components
+ */
+export declare const component: component.Gen;
+/**
+ * Checks the Astro component brand without executing a candidate component.
+ * Used by renderer discovery so probing does not run another framework's setup.
+ *
+ * @since 1.0.0
+ * @category Renderer discovery
+ */
+export declare function isComponent(value: unknown): value is Fx.Fx<RenderEvent, unknown, Services> | ((props: Record<string, unknown>, slots: Slots) => Fx.Fx<RenderEvent, unknown, Services>);
+/**
+ * Resolves Astro's props and slots call while leaving zero-argument Fx values lazy.
+ * Renderer adapters use this after isComponent succeeds; application components
+ * normally enter through Astro markup rather than calling this helper directly.
+ *
+ * @since 1.0.0
+ * @category Renderer dispatch
+ */
+export declare function view(value: Fx.Fx<RenderEvent, unknown, Services> | ((props: Record<string, unknown>, slots: Slots) => Fx.Fx<RenderEvent, unknown, Services>), props: Record<string, unknown>, slots: Slots): Fx.Fx<RenderEvent, unknown, Services>;
+export {};
+//# sourceMappingURL=Component.d.ts.map

package/dist/Component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Component.d.ts","sourceRoot":"","sources":["../src/Component.ts"],"names":[],"mappings":"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"}

package/dist/Component.js

@@ -0,0 +1,78 @@
+import { pipeArguments } from "effect/Pipeable";
+import { component as uiComponent } from "@typed/ui/Component";
+import * as Fx from "@typed/fx/Fx";
+import { html } from "@typed/template";
+const TypeId = Symbol.for("@typed/astro/Component");
+/**
+ * Defines a Typed Astro island with the generator and pipeline semantics of
+ * @typed/ui/Component. Zero-argument generators produce lazy, callable Fx values
+ * accepted by Astro markup; calling one returns its Fx without running it.
+ * Parameterized generators produce functions. Each generator may return any
+ * Renderable, normalized to RenderEvents under Astro's hydration boundary.
+ * Pipes receive that Fx and the original arguments. Provide application services
+ * in a pipe; Astro supplies Scope and RenderTemplate. Each run owns its state.
+ * A zero-argument pipeline must retain an object value so it can carry the brand.
+ *
+ * @example
+ * ```ts
+ * import { component } from "@typed/astro/Component"
+ * import { RefSubject } from "@typed/fx"
+ * import { html } from "@typed/template"
+ *
+ * export const Quantity = component(function* ({ initial }: { initial: number }) {
+ *   const quantity = yield* RefSubject.make(initial)
+ *   return html`<output>${quantity}</output>`
+ * })
+ * ```
+ *
+ * @since 1.0.0
+ * @category Island components
+ */
+export const component = (body, ...pipes) => {
+    const normalized = function* (...args) {
+        return html `${yield* body(...args)}`;
+    };
+    // Fx.fn selects by generator arity, so the parameterized wrapper must retain it.
+    Object.defineProperty(normalized, "length", { value: body.length });
+    const result = uiComponent(normalized, ...pipes);
+    if ((typeof result !== "object" || result === null) && typeof result !== "function") {
+        throw new TypeError("An Astro component pipeline must produce a Renderable object or function");
+    }
+    if (body.length === 0 && Fx.isFx(result)) {
+        // Astro's JSX checker requires a callable component. Preserve the Fx protocol
+        // on that callable; neither calling it nor using run/pipe evaluates the body.
+        const callable = Object.assign(() => result, result, {
+            [Fx.FxTypeId]: result[Fx.FxTypeId],
+            run: result.run.bind(result),
+            pipe() {
+                return pipeArguments(this, arguments);
+            },
+            [TypeId]: true,
+        });
+        return callable;
+    }
+    return Object.assign(result, { [TypeId]: true });
+};
+/**
+ * Checks the Astro component brand without executing a candidate component.
+ * Used by renderer discovery so probing does not run another framework's setup.
+ *
+ * @since 1.0.0
+ * @category Renderer discovery
+ */
+export function isComponent(value) {
+    return (((typeof value === "object" && value !== null) || typeof value === "function") &&
+        TypeId in value &&
+        value[TypeId] === true);
+}
+/**
+ * Resolves Astro's props and slots call while leaving zero-argument Fx values lazy.
+ * Renderer adapters use this after isComponent succeeds; application components
+ * normally enter through Astro markup rather than calling this helper directly.
+ *
+ * @since 1.0.0
+ * @category Renderer dispatch
+ */
+export function view(value, props, slots) {
+    return !Fx.isFx(value) && typeof value === "function" ? value(props, slots) : value;
+}

package/dist/client.d.ts

@@ -0,0 +1,12 @@
+export default _default;
+/**
+ * Creates Astro's native hydration entry. Each island owns its reactive render
+ * lifetime; replacement and unmount close the previous render before proceeding.
+ *
+ * @since 1.0.0
+ * @category Hydration and lifecycle
+ */
+declare function _default(element: HTMLElement): (component: unknown, props: Record<string, unknown>, slots?: Record<string, string>, { client }?: {
+    client: string;
+}) => Promise<void>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";AA+CA;;;;;;GAMG;0BACa,OAAO,EAAE,WAAW,eAErB,OAAO,SACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,eACjB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,KAC7B,OAAO,CAAC,IAAI,CAAC"}

package/dist/client.js

@@ -0,0 +1,97 @@
+import * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import * as Fiber from "effect/Fiber";
+import * as Fx from "@typed/fx/Fx";
+import * as Subject from "@typed/fx/Subject";
+import { DomRenderTemplate, render } from "@typed/template/Render";
+import { DomRenderEvent } from "@typed/template/RenderEvent";
+import * as Component from "./Component.js";
+const islands = new WeakMap();
+/** Adopt only this island's slots; nested islands keep their own renderer ownership. */
+function slotsFromAstro(element, slots, initialized) {
+    const existing = Array.from(element.querySelectorAll("astro-slot")).filter((slot) => slot.closest("astro-island") === element);
+    return Object.fromEntries(Object.entries(slots).map(([name, content]) => {
+        let slot = existing.find((node) => (node.getAttribute("name") ?? "default") === name);
+        if (!slot) {
+            slot = element.ownerDocument.createElement("astro-slot");
+            if (name !== "default")
+                slot.setAttribute("name", name);
+            // Only Astro's trusted slot transport crosses this HTML boundary, never component props.
+            slot.innerHTML = content;
+        }
+        else if (initialized && slot.innerHTML !== content) {
+            // Astro reserializes live child DOM on parent updates. Only replace content that differs.
+            slot.innerHTML = content;
+        }
+        return [name, Fx.succeed(DomRenderEvent(slot))];
+    }));
+}
+/**
+ * Creates Astro's native hydration entry. Each island owns its reactive render
+ * lifetime; replacement and unmount close the previous render before proceeding.
+ *
+ * @since 1.0.0
+ * @category Hydration and lifecycle
+ */
+export default (element) => (component, props, slots = {}, { client } = { client: "load" }) => {
+    if (!Component.isComponent(component)) {
+        return Promise.reject(new TypeError("@typed/astro requires a component created with component"));
+    }
+    const { promise, resolve, reject } = Promise.withResolvers();
+    const submit = islands.get(element) ?? mount(element);
+    submit({ component, props, slots, client, resolve, reject });
+    return promise;
+};
+function mount(element) {
+    const requests = Subject.unsafeMake();
+    let current = null;
+    let initialized = false;
+    const rendering = requests.pipe(Fx.switchMap((request) => {
+        let ready = false;
+        return Fx.unwrapScoped(Effect.sync(() => {
+            if (request === null || request !== current)
+                return Fx.empty;
+            if (request.client === "only" && !initialized)
+                element.replaceChildren();
+            const children = slotsFromAstro(element, request.slots, initialized);
+            initialized = true;
+            return render(Component.view(request.component, request.props, children), element).pipe(Fx.provide(DomRenderTemplate.using(element.ownerDocument)), Fx.tap(() => {
+                ready = true;
+                request.resolve();
+            }), Fx.continueWith(() => ready ? Fx.never : Fx.die(new Error("Typed component completed without rendering"))));
+        })).pipe(Fx.catchCause((cause) => {
+            if (request !== null && request === current && !Cause.hasInterruptsOnly(cause)) {
+                if (!ready)
+                    request.reject(cause);
+                else
+                    element.dispatchEvent(new CustomEvent("typed:error", { detail: cause }));
+            }
+            return Fx.empty;
+        }));
+    }), Fx.ensuring(Effect.sync(() => {
+        if (islands.get(element) === submit)
+            islands.delete(element);
+        element.removeEventListener("astro:unmount", unmount);
+    })));
+    const fiber = Effect.runFork(Effect.scoped(Fx.drain(rendering)));
+    function submit(request) {
+        current?.resolve();
+        current = request;
+        Effect.runFork(requests.onSuccess(request));
+    }
+    function unmount() {
+        current?.resolve();
+        current = null;
+        initialized = false;
+        Effect.runFork(requests.onSuccess(null).pipe(Effect.andThen(() => {
+            if (current !== null)
+                return Effect.void;
+            if (islands.get(element) === submit)
+                islands.delete(element);
+            return Fiber.interrupt(fiber);
+        })));
+    }
+    islands.set(element, submit);
+    element.addEventListener("astro:unmount", unmount);
+    return submit;
+}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import type { AstroIntegration } from "astro";
+/**
+ * Registers the Typed server and browser renderers with Astro.
+ * Add one instance to astro.config's integrations list. Client directives then
+ * select whether and when each branded Typed component starts in the browser.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "astro/config"
+ * import typed from "@typed/astro"
+ *
+ * export default defineConfig({ integrations: [typed()] })
+ * ```
+ *
+ * @since 1.0.0
+ * @category Integration setup
+ */
+export default function typed(): AstroIntegration;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAE9C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,OAAO,UAAU,KAAK,IAAI,gBAAgB,CAahD"}

package/dist/index.js

@@ -0,0 +1,30 @@
+/**
+ * Registers the Typed server and browser renderers with Astro.
+ * Add one instance to astro.config's integrations list. Client directives then
+ * select whether and when each branded Typed component starts in the browser.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "astro/config"
+ * import typed from "@typed/astro"
+ *
+ * export default defineConfig({ integrations: [typed()] })
+ * ```
+ *
+ * @since 1.0.0
+ * @category Integration setup
+ */
+export default function typed() {
+    return {
+        name: "@typed/astro",
+        hooks: {
+            "astro:config:setup": ({ addRenderer }) => {
+                addRenderer({
+                    name: "@typed/astro",
+                    serverEntrypoint: "@typed/astro/server",
+                    clientEntrypoint: "@typed/astro/client",
+                });
+            },
+        },
+    };
+}

package/dist/server.d.ts

@@ -0,0 +1,19 @@
+import type { AstroComponentMetadata } from "astro";
+/**
+ * Astro renderer protocol for branded Typed components and trusted Astro slots.
+ * Each render owns an HTML rendering scope that closes after serialization.
+ * Astro loads this entry through the integration; it is not a raw-HTML API.
+ *
+ * @since 1.0.0
+ * @category Server rendering
+ */
+declare const renderer: {
+    name: string;
+    supportsAstroStaticSlot: true;
+    check(component: unknown): Promise<boolean>;
+    renderToStaticMarkup(component: unknown, props: Record<string, unknown>, slots?: Record<string, string>, metadata?: AstroComponentMetadata): Promise<{
+        html: string;
+    }>;
+};
+export default renderer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAA+B,MAAM,OAAO,CAAC;AA2CjF;;;;;;;GAOG;AACH,QAAA,MAAM,QAAQ;;;qBAGW,OAAO;oCAIjB,OAAO,SACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,aAClB,sBAAsB;;;CAYE,CAAC;eAEzB,QAAQ"}

package/dist/server.js

@@ -0,0 +1,52 @@
+import * as Fx from "@typed/fx/Fx";
+import * as Effect from "effect/Effect";
+import { HtmlRenderTemplate, renderToHtmlString } from "@typed/template/Html";
+import { HtmlRenderEvent } from "@typed/template/RenderEvent";
+import * as Component from "./Component.js";
+/** Astro supplies already-rendered slot HTML. This boundary is not a public raw HTML helper. */
+function slotsFromAstro(slots, metadata) {
+    const tag = metadata?.hydrate ? "astro-slot" : "astro-static-slot";
+    return Object.fromEntries(Object.entries(slots).map(([name, content]) => [
+        name,
+        Fx.succeed(HtmlRenderEvent(`<${tag}${name === "default" ? "" : ` name="${escapeAttribute(name)}"`}>${content}</${tag}>`, true)),
+    ]));
+}
+function escapeAttribute(value) {
+    return value.replace(/[&"<>']/g, (character) => {
+        switch (character) {
+            case "&":
+                return "&amp;";
+            case '"':
+                return "&quot;";
+            case "'":
+                return "&#39;";
+            case "<":
+                return "&lt;";
+            default:
+                return "&gt;";
+        }
+    });
+}
+/**
+ * Astro renderer protocol for branded Typed components and trusted Astro slots.
+ * Each render owns an HTML rendering scope that closes after serialization.
+ * Astro loads this entry through the integration; it is not a raw-HTML API.
+ *
+ * @since 1.0.0
+ * @category Server rendering
+ */
+const renderer = {
+    name: "@typed/astro",
+    supportsAstroStaticSlot: true,
+    async check(component) {
+        return Component.isComponent(component);
+    },
+    async renderToStaticMarkup(component, props, slots = {}, metadata) {
+        if (!Component.isComponent(component)) {
+            throw new TypeError("@typed/astro requires a component created with component");
+        }
+        const html = await Effect.runPromise(Effect.suspend(() => renderToHtmlString(Component.view(component, props, slotsFromAstro(slots, metadata)))).pipe(Effect.provide(HtmlRenderTemplate), Effect.scoped));
+        return { html };
+    },
+};
+export default renderer;

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@typed/astro",
+  "version": "1.0.0-beta.7",
+  "description": "Astro integration for Typed HTML templates and hydrated islands.",
+  "keywords": [
+    "astro-integration",
+    "effect",
+    "typed"
+  ],
+  "homepage": "https://github.com/TylorS/typed-smol/tree/main/packages/astro#readme",
+  "bugs": "https://github.com/TylorS/typed-smol/issues",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TylorS/typed-smol.git",
+    "directory": "packages/astro"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./Component": {
+      "types": "./dist/Component.d.ts",
+      "import": "./dist/Component.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@typed/fx": "2.0.0-beta.7",
+    "@typed/template": "1.0.0-beta.7",
+    "@typed/ui": "1.0.0-beta.7",
+    "effect": "4.0.0-rc.112"
+  },
+  "devDependencies": {
+    "@vitest/browser-playwright": "5.0.0",
+    "astro": "^7.3.1",
+    "happy-dom": "20.13.2",
+    "playwright": "^1.62.1",
+    "typescript": "7.0.2",
+    "vite": "8.2.2",
+    "vitest": "5.0.0"
+  },
+  "peerDependencies": {
+    "astro": "^7.3.1"
+  },
+  "scripts": {
+    "build": "rm -rf dist tsconfig.tsbuildinfo && tsc",
+    "test": "pnpm run test:node && pnpm run test:browser && pnpm run test:types",
+    "test:node": "vitest run --config vitest.config.ts",
+    "test:browser": "vitest run --config vitest.browser.config.ts",
+    "test:types": "tsc -p tsconfig.tests.json",
+    "test:integration": "pnpm run build && node test.integration.mjs"
+  }
+}