@terra-symposium/boundaries 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Terra Symposium
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,93 @@
-# Temporary Holding Version
+# Error Boundaries
 
-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.
+Shared error-page copy and adapters for React, Next.js route boundaries, and Astro status responses.
+
+## What it does
+
+Not applicable.
+
+## Prerequisites
+
+Not applicable.
+
+## Get started
+
+### Install
+
+```sh
+pnpm add @terra-symposium/boundaries
+```
+
+From `standards/main/`, run `pnpm install`, then `pnpm --filter @terra-symposium/boundaries build`. Validate adapter changes with `pnpm --filter @terra-symposium/boundaries test`.
+
+## Usage
+
+### Catch React render failures
+
+````tsx
+import { ErrorBoundary } from '@terra-symposium/boundaries/react';
+
+## Structure
+
+- See [src](src/), [package.json](package.json), and `tests/`.
+
+## References
+
+### Catch Astro island hydration failures
+Wrap hydrated islands in the shared Astro boundary to show a static fallback if a client module fails before React can render:
+
+```astro
+---
+import AstroErrorBoundary from '@terra-symposium/boundaries/astro-boundary';
+---
+
+<AstroErrorBoundary title="Workspace unavailable" description="Reload to try the workspace again.">
+	<Workspace client:load />
+</AstroErrorBoundary>
+````
+
+The Astro wrapper listens for Astro's cancelable `astro:hydration-error` event and reveals its fallback without depending on the failed island's JavaScript. It complements the React `ErrorBoundary`; it cannot render a fallback if the server fails before sending HTML.
+
+### Other entry points
+
+`@terra-symposium/boundaries/astro` exports status-copy helpers for 400, 401, 403, 404, 500, 502, and 503 responses.
+
+`@terra-symposium/boundaries/astro-boundary` exports the reusable static Astro island guard.
+
+`@terra-symposium/boundaries/next` exports types and `errorDigest(error)` for framework-provided route-error digests.
+
+- The package root re-exports all entry-point APIs.
+
+See the [package guide](https://standards-docs.netlify.app/error-boundaries/1-react/react-boundaries/) for prop behavior and usage details.
+
+## Configuration and security
+
+Not applicable.
+
+## Development and structure
+
+Not applicable.
+
+## Validation
+
+Not applicable.
+
+## Deployment and operations
+
+Not applicable.
+
+## Data, privacy, and limitations
+
+Not applicable.
+
+## References
+
+Not applicable.
+
+## Contributing
+
+Not applicable.
+
+## Credits and license
+
+Not applicable.

package/dist/components/AstroErrorBoundary.astro

@@ -0,0 +1,78 @@
+---
+/** Keeps Astro island hydration failures inside a visible, recoverable boundary. */
+type Props = {
+	title?: string;
+	description?: string;
+	reloadLabel?: string;
+};
+
+const { title = 'This section could not load', description = 'The interactive interface failed to start. The error has been recorded for diagnosis.', reloadLabel = 'Reload page' } = Astro.props;
+---
+
+<terra-error-boundary data-terra-error-boundary>
+	<slot />
+	<section class='terra-error-boundary-fallback' data-terra-hydration-fallback hidden role='alert'>
+		<div>
+			<h1>{title}</h1>
+			<p>{description}</p>
+			<a href={Astro.url.href}>{reloadLabel}</a>
+		</div>
+	</section>
+</terra-error-boundary>
+
+<script is:inline>
+	(() => {
+		document.addEventListener('astro:hydration-error', event => {
+			if (event.defaultPrevented) return;
+			const island = event.target;
+			if (!(island instanceof Element)) return;
+			const boundary = island.closest('terra-error-boundary[data-terra-error-boundary]');
+			const fallback = boundary?.querySelector('[data-terra-hydration-fallback]');
+			if (!boundary || !fallback) return;
+
+			// Astro emits this cancelable event before logging a failed island import.
+			event.preventDefault();
+			console.error('[Terra error boundary] island hydration failed', event.detail?.error);
+			island.setAttribute('hidden', '');
+			fallback.removeAttribute('hidden');
+		});
+	})();
+</script>
+
+<style>
+	terra-error-boundary {
+		display: contents;
+	}
+
+	.terra-error-boundary-fallback {
+		box-sizing: border-box;
+		max-width: 42rem;
+		margin: 3rem auto;
+		padding: 1.5rem;
+		color: var(--foreground, #171717);
+		background: var(--background, #fff);
+		border: 1px solid var(--border, #d1d5db);
+		border-radius: 0.75rem;
+		font: inherit;
+	}
+
+	.terra-error-boundary-fallback h1 {
+		margin: 0 0 0.5rem;
+		font-size: 1.25rem;
+		font-weight: 600;
+	}
+
+	.terra-error-boundary-fallback p {
+		margin: 0 0 1rem;
+	}
+
+	.terra-error-boundary-fallback a {
+		color: var(--primary, #2563eb);
+		text-decoration: underline;
+		text-underline-offset: 0.2em;
+	}
+
+	.terra-error-boundary-fallback[hidden] {
+		display: none !important;
+	}
+</style>

package/dist/components/react.d.ts

@@ -0,0 +1,64 @@
+/**
+ * packages/error-boundaries/src/components/react.tsx
+ * React error boundary and higher-order wrapper implementations.
+ */
+import React, { Component } from 'react';
+/** Receives a render error and boundary metadata for application-owned logging. */
+export type ErrorReporter = (err: Error, report: {
+    name: string;
+    componentStack: string | null;
+}) => void;
+/** Configuration and child content accepted by the reusable React error boundary. */
+export type ErrorBoundaryProps = {
+    children?: React.ReactNode;
+    fallback?: (err: Error) => React.ReactNode;
+    name?: string;
+    resetKey?: string;
+    onError?: ErrorReporter;
+};
+/** Internal React state containing the current descendant render error, if any. */
+export type ErrorBoundaryState = {
+    error: Error | null;
+};
+/**
+ * Wraps a component in a named error boundary without coupling it to application UI.
+ *
+ * @param ComponentToWrap Component to render inside the error boundary.
+ * @param name Stable name reported when the wrapped component fails.
+ * @param onErr Optional callback that receives render errors and component metadata.
+ *
+ * @return A component with the same props that renders through an error boundary.
+ */
+export declare function withErrorBoundary<P extends object>(ComponentToWrap: React.ComponentType<P>, name: string, onErr?: ErrorReporter): React.ComponentType<P>;
+/** Catches render failures while keeping error reporting and fallback UI injectable. */
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    state: ErrorBoundaryState;
+    /**
+     * Stores a descendant render error so the boundary switches to its fallback.
+     *
+     * @param err Error caught while rendering a child.
+     *
+     * @return State containing the captured error.
+     */
+    static getDerivedStateFromError(err: Error): ErrorBoundaryState;
+    /**
+     * Reports a captured render error with its component stack when a callback is configured.
+     *
+     * @param err Error caught while rendering a child.
+     * @param info React component stack captured for the failed render.
+     */
+    componentDidCatch(err: Error, info: React.ErrorInfo): void;
+    /**
+     * Clears the captured error when the boundary receives a new reset key.
+     *
+     * @param prev Props from the previous render, used to detect reset-key changes.
+     */
+    componentDidUpdate(prev: ErrorBoundaryProps): void;
+    /**
+     * Renders the children until an error is captured, then renders fallback content.
+     *
+     * @return The children, configured fallback, or default alert.
+     */
+    render(): React.ReactNode;
+}
+//# sourceMappingURL=react.d.ts.map

package/dist/components/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../../src/components/react.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMzC,mFAAmF;AACnF,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,KAAK,IAAI,CAAC;AAC1G,qFAAqF;AACrF,MAAM,MAAM,kBAAkB,GAAG;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,KAAK,CAAC,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC;AACvK,mFAAmF;AACnF,MAAM,MAAM,kBAAkB,GAAG;IAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CAAE,CAAC;AAMzD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,eAAe,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAiBxJ;AAED,wFAAwF;AACxF,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IACnF,KAAK,EAAE,kBAAkB,CAAmB;IAC5C;;;;;;OAMG;IACH,MAAM,CAAC,wBAAwB,CAAC,GAAG,EAAE,KAAK,GAAG,kBAAkB;IAG/D;;;;;OAKG;IACH,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI;IAG1D;;;;OAIG;IACH,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI;IAGlD;;;;OAIG;IACH,MAAM,IAAI,KAAK,CAAC,SAAS;CAKzB"}

package/dist/components/react.js

@@ -0,0 +1,81 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * packages/error-boundaries/src/components/react.tsx
+ * React error boundary and higher-order wrapper implementations.
+ */
+/*//////////////////////////////////////////////////
+IMPORTS
+//////////////////////////////////////////////////*/
+// COMPONENTS
+import { Component } from 'react';
+/*//////////////////////////////////////////////////
+HELPERS
+//////////////////////////////////////////////////*/
+/**
+ * Wraps a component in a named error boundary without coupling it to application UI.
+ *
+ * @param ComponentToWrap Component to render inside the error boundary.
+ * @param name Stable name reported when the wrapped component fails.
+ * @param onErr Optional callback that receives render errors and component metadata.
+ *
+ * @return A component with the same props that renders through an error boundary.
+ */
+export function withErrorBoundary(ComponentToWrap, name, onErr) {
+    /**
+     * Renders the wrapped component inside the configured boundary.
+     *
+     * @param props Props forwarded unchanged to the wrapped component.
+     *
+     * @return The wrapped component as a React element under the error boundary.
+     */
+    function BoundedComponent(props) {
+        return (_jsx(ErrorBoundary, { name: name, onError: onErr, children: _jsx(ComponentToWrap, { ...props }) }));
+    }
+    BoundedComponent.displayName = `withErrorBoundary(${ComponentToWrap.displayName || ComponentToWrap.name || 'Component'})`;
+    return BoundedComponent;
+}
+/** Catches render failures while keeping error reporting and fallback UI injectable. */
+export class ErrorBoundary extends Component {
+    state = { error: null };
+    /**
+     * Stores a descendant render error so the boundary switches to its fallback.
+     *
+     * @param err Error caught while rendering a child.
+     *
+     * @return State containing the captured error.
+     */
+    static getDerivedStateFromError(err) {
+        return { error: err };
+    }
+    /**
+     * Reports a captured render error with its component stack when a callback is configured.
+     *
+     * @param err Error caught while rendering a child.
+     * @param info React component stack captured for the failed render.
+     */
+    componentDidCatch(err, info) {
+        this.props.onError?.(err, { name: this.props.name ?? 'Component', componentStack: info.componentStack ?? null });
+    }
+    /**
+     * Clears the captured error when the boundary receives a new reset key.
+     *
+     * @param prev Props from the previous render, used to detect reset-key changes.
+     */
+    componentDidUpdate(prev) {
+        if (prev.resetKey !== this.props.resetKey && this.state.error)
+            this.setState({ error: null });
+    }
+    /**
+     * Renders the children until an error is captured, then renders fallback content.
+     *
+     * @return The children, configured fallback, or default alert.
+     */
+    render() {
+        if (!this.state.error)
+            return this.props.children;
+        if (this.props.fallback)
+            return this.props.fallback(this.state.error);
+        return _jsx("div", { role: 'alert', children: "An unexpected error occurred while rendering this section." });
+    }
+}
+//# sourceMappingURL=react.js.map

package/dist/components/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../src/components/react.tsx"],"names":[],"mappings":";AAAA;;;GAGG;AAEH;;oDAEoD;AAEpD,aAAa;AACb,OAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAazC;;oDAEoD;AAEpD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAmB,eAAuC,EAAE,IAAY,EAAE,KAAqB;IAC/H;;;;;;OAMG;IACH,SAAS,gBAAgB,CAAC,KAAQ;QACjC,OAAO,CACN,KAAC,aAAa,IAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,YACxC,KAAC,eAAe,OAAK,KAAK,GAAI,GACf,CAChB,CAAC;IACH,CAAC;IACD,gBAAgB,CAAC,WAAW,GAAG,qBAAqB,eAAe,CAAC,WAAW,IAAI,eAAe,CAAC,IAAI,IAAI,WAAW,GAAG,CAAC;IAC1H,OAAO,gBAAgB,CAAC;AACzB,CAAC;AAED,wFAAwF;AACxF,MAAM,OAAO,aAAc,SAAQ,SAAiD;IACnF,KAAK,GAAuB,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC5C;;;;;;OAMG;IACH,MAAM,CAAC,wBAAwB,CAAC,GAAU;QACzC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACvB,CAAC;IACD;;;;;OAKG;IACH,iBAAiB,CAAC,GAAU,EAAE,IAAqB;QAClD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,WAAW,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC,CAAC;IAClH,CAAC;IACD;;;;OAIG;IACH,kBAAkB,CAAC,IAAwB;QAC1C,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD;;;;OAIG;IACH,MAAM;QACL,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QAClD,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACtE,OAAO,cAAK,IAAI,EAAC,OAAO,2EAAiE,CAAC;IAC3F,CAAC;CACD"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * packages/error-boundaries/src/index.ts
+ */
+export * from './lib/index.js';
+//# 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;;GAEG;AAEH,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+/**
+ * packages/error-boundaries/src/index.ts
+ */
+export * from './lib/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC"}

package/dist/lib/astro-integration.d.ts

@@ -0,0 +1,18 @@
+/**
+ * packages/error-boundaries/src/lib/astro-integration.ts
+ * Installs a visible page-local fallback for Astro island hydration failures.
+ */
+/**
+ * Adds a shared accessible fallback before Astro starts hydrating any page islands.
+ *
+ * @return An Astro integration that handles each failed island without replacing the page.
+ */
+export declare function terraErrorBoundaryIntegration(): {
+    name: string;
+    hooks: {
+        'astro:config:setup': ({ injectScript }: {
+            injectScript: (stage: "before-hydration", content: string) => void;
+        }) => void;
+    };
+};
+//# sourceMappingURL=astro-integration.d.ts.map

package/dist/lib/astro-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"astro-integration.d.ts","sourceRoot":"","sources":["../../src/lib/astro-integration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH;;;;GAIG;AACH,wBAAgB,6BAA6B;;;iDAID;YAAE,YAAY,EAAE,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;SAAE;;EAkCjH"}

package/dist/lib/astro-integration.js

@@ -0,0 +1,52 @@
+/**
+ * packages/error-boundaries/src/lib/astro-integration.ts
+ * Installs a visible page-local fallback for Astro island hydration failures.
+ */
+/*//////////////////////////////////////////////////
+CONFIG
+//////////////////////////////////////////////////*/
+/*//////////////////////////////////////////////////
+FUNCTIONS
+//////////////////////////////////////////////////*/
+/**
+ * Adds a shared accessible fallback before Astro starts hydrating any page islands.
+ *
+ * @return An Astro integration that handles each failed island without replacing the page.
+ */
+export function terraErrorBoundaryIntegration() {
+    return {
+        name: '@terra-symposium/boundaries',
+        hooks: {
+            'astro:config:setup': ({ injectScript }) => {
+                injectScript('before-hydration', `(() => {
+	if (window.__terraHydrationBoundaryInstalled) return;
+	window.__terraHydrationBoundaryInstalled = true;
+	document.addEventListener('astro:hydration-error', (event) => {
+		if (event.defaultPrevented) return;
+		const island = event.target;
+		if (!(island instanceof HTMLElement) || !island.isConnected) return;
+		event.preventDefault();
+		island.hidden = true;
+		const fallback = document.createElement('section');
+		fallback.setAttribute('role', 'alert');
+		fallback.setAttribute('data-terra-hydration-fallback', '');
+		fallback.style.cssText = 'box-sizing:border-box;max-width:42rem;margin:3rem auto;padding:1.5rem;color:var(--foreground,#171717);background:var(--background,#fff);border:1px solid var(--border,#d1d5db);border-radius:.75rem;font:inherit';
+		const heading = document.createElement('h1');
+		heading.textContent = 'Interactive section could not load';
+		heading.style.cssText = 'margin:0 0 .5rem;font-size:1.25rem;font-weight:600';
+		const message = document.createElement('p');
+		message.textContent = 'The rest of this page is still available. Reload to try this section again.';
+		const reload = document.createElement('a');
+		reload.href = window.location.href;
+		reload.textContent = 'Reload page';
+		reload.style.cssText = 'color:var(--primary,#2563eb);text-decoration:underline;text-underline-offset:.2em';
+		fallback.append(heading, message, reload);
+		island.insertAdjacentElement('afterend', fallback);
+		console.error('[Terra error boundary] island hydration failed', event.detail?.error);
+	});
+})();`);
+            },
+        },
+    };
+}
+//# sourceMappingURL=astro-integration.js.map

package/dist/lib/astro-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"astro-integration.js","sourceRoot":"","sources":["../../src/lib/astro-integration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;oDAEoD;AAEpD;;oDAEoD;AAEpD;;;;GAIG;AACH,MAAM,UAAU,6BAA6B;IAC5C,OAAO;QACN,IAAI,EAAE,6BAA6B;QACnC,KAAK,EAAE;YACN,oBAAoB,EAAE,CAAC,EAAE,YAAY,EAA0E,EAAE,EAAE;gBAClH,YAAY,CACX,kBAAkB,EAClB;;;;;;;;;;;;;;;;;;;;;;;;;;MA0BC,CACD,CAAC;YACH,CAAC;SACD;KACD,CAAC;AACH,CAAC"}

package/dist/lib/astro.d.ts

@@ -0,0 +1,21 @@
+/**
+ * packages/error-boundaries/src/lib/astro.ts
+ * Shared status-code copy for Astro error responses.
+ */
+/** Supported HTTP statuses with shared user-facing error-page copy. */
+export type ErrorStatus = 400 | 401 | 403 | 404 | 500 | 502 | 503;
+/** Heading and description shown for one supported error status. */
+export type ErrorStatusCopy = {
+    title: string;
+    description: string;
+};
+export declare const ERROR_STATUS_COPY: Readonly<Record<ErrorStatus, ErrorStatusCopy>>;
+/**
+ * Resolves unknown status values to the safe internal-server-error response.
+ *
+ * @param status HTTP status code to resolve.
+ *
+ * @return Shared copy for a supported status, or generic copy for an unknown value.
+ */
+export declare function errorStatusCopy(status: number): ErrorStatusCopy;
+//# sourceMappingURL=astro.d.ts.map

package/dist/lib/astro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"astro.d.ts","sourceRoot":"","sources":["../../src/lib/astro.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,uEAAuE;AACvE,MAAM,MAAM,WAAW,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAClE,oEAAoE;AACpE,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AACrE,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,eAAe,CAAC,CAQ3E,CAAC;AAMH;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAE/D"}

package/dist/lib/astro.js

@@ -0,0 +1,27 @@
+/**
+ * packages/error-boundaries/src/lib/astro.ts
+ * Shared status-code copy for Astro error responses.
+ */
+export const ERROR_STATUS_COPY = Object.freeze({
+    400: { title: 'Bad Request', description: 'The server could not understand the request due to invalid syntax.' },
+    401: { title: 'Unauthorized', description: 'You need to authenticate to access this resource.' },
+    403: { title: 'Forbidden', description: 'You do not have permission to access this resource.' },
+    404: { title: 'Not Found', description: 'The requested page or resource could not be found.' },
+    500: { title: 'Internal Server Error', description: 'The server encountered an unexpected condition preventing it from fulfilling the request.' },
+    502: { title: 'Bad Gateway', description: 'The server received an invalid response from an upstream server.' },
+    503: { title: 'Service Unavailable', description: 'The server is currently unable to handle the request due to temporary overload or maintenance.' },
+});
+/*//////////////////////////////////////////////////
+FUNCTIONS
+//////////////////////////////////////////////////*/
+/**
+ * Resolves unknown status values to the safe internal-server-error response.
+ *
+ * @param status HTTP status code to resolve.
+ *
+ * @return Shared copy for a supported status, or generic copy for an unknown value.
+ */
+export function errorStatusCopy(status) {
+    return ERROR_STATUS_COPY[status] ?? { title: 'Unknown Error', description: 'Something went wrong.' };
+}
+//# sourceMappingURL=astro.js.map

package/dist/lib/astro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"astro.js","sourceRoot":"","sources":["../../src/lib/astro.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,CAAC,MAAM,iBAAiB,GAAmD,MAAM,CAAC,MAAM,CAAC;IAC9F,GAAG,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,oEAAoE,EAAE;IAChH,GAAG,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,mDAAmD,EAAE;IAChG,GAAG,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,qDAAqD,EAAE;IAC/F,GAAG,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,oDAAoD,EAAE;IAC9F,GAAG,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,2FAA2F,EAAE;IACjJ,GAAG,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,kEAAkE,EAAE;IAC9G,GAAG,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,gGAAgG,EAAE;CACpJ,CAAC,CAAC;AAEH;;oDAEoD;AAEpD;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC7C,OAAO,iBAAiB,CAAC,MAAqB,CAAC,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,uBAAuB,EAAE,CAAC;AACrH,CAAC"}

package/dist/lib/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * packages/error-boundaries/src/lib/index.ts
+ * Public exports for the framework error-boundary helpers.
+ */
+export * from './astro.js';
+export * from './next.js';
+export * from '../components/react.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC"}

package/dist/lib/index.js

@@ -0,0 +1,8 @@
+/**
+ * packages/error-boundaries/src/lib/index.ts
+ * Public exports for the framework error-boundary helpers.
+ */
+export * from './astro.js';
+export * from './next.js';
+export * from '../components/react.js';
+//# sourceMappingURL=index.js.map

package/dist/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC"}

package/dist/lib/next.d.ts

@@ -0,0 +1,22 @@
+/**
+ * packages/error-boundaries/src/lib/next.ts
+ * Shared error helpers for Next.js route boundaries.
+ */
+/** Next.js route error with the optional framework-provided diagnostic digest. */
+export type NextRouteError = Error & {
+    digest?: string;
+};
+/** Props used by a Next.js route error component that can retry rendering. */
+export type NextRouteErrorProps = {
+    error: NextRouteError;
+    reset: () => void;
+};
+/**
+ * Returns the framework-provided digest without exposing an error message as a public identifier.
+ *
+ * @param err Route error whose framework digest should be read.
+ *
+ * @return The framework digest, when present, without exposing the error message.
+ */
+export declare function errorDigest(err: NextRouteError): string | undefined;
+//# sourceMappingURL=next.d.ts.map

package/dist/lib/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../src/lib/next.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,kFAAkF;AAClF,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACzD,8EAA8E;AAC9E,MAAM,MAAM,mBAAmB,GAAG;IAAE,KAAK,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC;AAM/E;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAEnE"}

package/dist/lib/next.js

@@ -0,0 +1,18 @@
+/**
+ * packages/error-boundaries/src/lib/next.ts
+ * Shared error helpers for Next.js route boundaries.
+ */
+/*//////////////////////////////////////////////////
+FUNCTIONS
+//////////////////////////////////////////////////*/
+/**
+ * Returns the framework-provided digest without exposing an error message as a public identifier.
+ *
+ * @param err Route error whose framework digest should be read.
+ *
+ * @return The framework digest, when present, without exposing the error message.
+ */
+export function errorDigest(err) {
+    return err.digest;
+}
+//# sourceMappingURL=next.js.map

package/dist/lib/next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.js","sourceRoot":"","sources":["../../src/lib/next.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH;;oDAEoD;AAEpD;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,GAAmB;IAC9C,OAAO,GAAG,CAAC,MAAM,CAAC;AACnB,CAAC"}

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@terra-symposium/boundaries",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Framework-neutral React error boundaries for Terra Symposium applications",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Terra-Symposium/standards.git"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./react": "./dist/components/react.js",
+    "./astro": "./dist/lib/astro.js",
+    "./astro-integration": "./dist/lib/astro-integration.js",
+    "./astro-boundary": "./dist/components/AstroErrorBoundary.astro",
+    "./next": "./dist/lib/next.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "devDependencies": {
+    "@types/react": "^19.3.0",
+    "react": "^19.3.1",
+    "typescript": "^6.0.3"
+  },
+  "scripts": {
+    "quality": "node \"$(git rev-parse --show-toplevel)/scripts/quality-runner.mjs\" quality",
+    "quality:all": "node \"$(git rev-parse --show-toplevel)/scripts/quality-runner.mjs\" quality --all",
+    "build": "tsc -p config/tsconfig.json && mkdir -p dist/components && cp src/components/AstroErrorBoundary.astro dist/components/AstroErrorBoundary.astro",
+    "test": "npm run build && mkdir -p tests/results && node --test --test-reporter=spec --test-reporter-destination=stdout --test-reporter=junit --test-reporter-destination=tests/results/junit.xml tests/*.test.mjs",
+    "typecheck": "tsc --noEmit -p config/tsconfig.json"
+  }
 }