netjes 0.0.0-stage → 0.0.2

package/dist/root.d.ts

@@ -0,0 +1,12 @@
+import type { ModuleLoader, RouteModules } from './modules.ts';
+import type { InitialPayload } from './payload.ts';
+type RootProps = {
+    payload: InitialPayload;
+    modules: RouteModules;
+    loader: ModuleLoader;
+    dataJson: string;
+};
+/** The same tree on the server and in the browser, so hydration matches. */
+export declare function Root({ payload, modules, loader, dataJson }: RootProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=root.d.ts.map

package/dist/root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../src/root.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,cAAc,CAAC;AAIjE,KAAK,SAAS,GAAG;IAAE,OAAO,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAY5G,4EAA4E;AAC5E,wBAAgB,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,SAAS,+BAcrE"}

package/dist/root.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { QueryShell } from 'virtual:netjes/query';
+import { Document } from './document.js';
+import { ImageConfigProvider } from './image.js';
+import { NonceProvider } from './nonce.js';
+import { PublicConfigProvider } from './public-config.js';
+import { RouterProvider } from './router.js';
+import { VitalsEndpointProvider } from './vitals-config.js';
+/** App-wide configuration the server sends with the first document (it does not change between navigations). */
+function RootProviders({ info, children }) {
+    let element = children;
+    if (info.images)
+        element = _jsx(ImageConfigProvider, { value: info.images, children: element });
+    if (info.publicConfig)
+        element = _jsx(PublicConfigProvider, { value: info.publicConfig, children: element });
+    if (info.nonce)
+        element = _jsx(NonceProvider, { value: info.nonce, children: element });
+    if (info.vitalsEndpoint)
+        element = _jsx(VitalsEndpointProvider, { value: info.vitalsEndpoint, children: element });
+    return element;
+}
+/** The same tree on the server and in the browser, so hydration matches. */
+export function Root({ payload, modules, loader, dataJson }) {
+    return (_jsx(Document, { info: payload.document, dataJson: dataJson, children: _jsx(RootProviders, { info: payload.document, children: _jsx(RouterProvider, { initial: payload, initialModules: modules, loader: loader, errorPage: payload.document.errorPage, shell: QueryShell }) }) }));
+}
+//# sourceMappingURL=root.js.map

package/dist/root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../src/root.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAgB,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAa,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAa,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAqB,CAAC;AAG3D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAc,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAI5D,gHAAgH;AAChH,SAAS,aAAa,CAAC,EAAE,IAAI,EAAE,QAAQ,EAA+C;IACpF,IAAI,OAAO,GAAG,QAAQ,CAAC;IACvB,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,GAAG,KAAC,mBAAmB,IAAC,KAAK,EAAE,IAAI,CAAC,MAAM,YAAG,OAAO,GAAuB,CAAC;IACpG,IAAI,IAAI,CAAC,YAAY;QAAE,OAAO,GAAG,KAAC,oBAAoB,IAAC,KAAK,EAAE,IAAI,CAAC,YAAY,YAAG,OAAO,GAAwB,CAAC;IAClH,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,KAAC,aAAa,IAAC,KAAK,EAAE,IAAI,CAAC,KAAK,YAAG,OAAO,GAAiB,CAAC;IACtF,IAAI,IAAI,CAAC,cAAc;QAAE,OAAO,GAAG,KAAC,sBAAsB,IAAC,KAAK,EAAE,IAAI,CAAC,cAAc,YAAG,OAAO,GAA0B,CAAC;IAC1H,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAa;IACpE,OAAO,CACL,KAAC,QAAQ,IAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,YAClD,KAAC,aAAa,IAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,YACnC,KAAC,cAAc,IACb,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,OAAO,EACvB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,SAAS,EACrC,KAAK,EAAE,UAAU,GACjB,GACY,GACP,CACZ,CAAC;AACJ,CAAC"}

package/dist/route-tree.d.ts

@@ -0,0 +1,56 @@
+import { Component, type ReactElement, type ReactNode } from 'react';
+import { type Metadata } from './metadata.tsx';
+import type { RouteModules } from './modules.ts';
+import type { PageKind, Params, SegmentRef } from './payload.ts';
+export type { ErrorPageProps } from './modules.ts';
+type RouteTreeProps = {
+    modules: RouteModules;
+    /** The payload's segments, for their loader props; matched to `modules.segments` by position. */
+    segments?: readonly SegmentRef[];
+    props: Record<string, unknown>;
+    params: Params;
+    status: number;
+    pageKind?: PageKind | undefined;
+    /** Remounts the page and templates (not layouts) when it changes, so page state does not leak between URLs. */
+    pageKey: string;
+    /** What `reset` does on an error page the server chose: load the page again. */
+    retry?: () => void;
+    /** Metadata from the C# loader. */
+    metadata?: Metadata | undefined;
+};
+/** How many URL segments the layout rendering here covers: what useSelectedLayoutSegment(s) count from. */
+export declare const LayoutDepthContext: import("react").Context<number>;
+type BoundaryProps = {
+    resetKey: unknown;
+    fallback: (error: unknown, reset: () => void) => ReactNode;
+    children: ReactNode;
+};
+/** Catches render errors below it; resets when `resetKey` changes (a navigation) or `reset` is called. */
+export declare class ErrorBoundary extends Component<BoundaryProps, {
+    error: unknown;
+    failed: boolean;
+}> {
+    state: {
+        error: unknown;
+        failed: boolean;
+    };
+    static getDerivedStateFromError(error: unknown): {
+        error: unknown;
+        failed: boolean;
+    };
+    componentDidUpdate(previous: BoundaryProps): void;
+    private readonly reset;
+    render(): ReactNode;
+}
+/**
+ * The page wrapped in its segments, outermost first. Per segment, as in the Next.js App Router:
+ * layout > template > error boundary > Suspense (loading) > the next segment or the page. Layouts keep their state
+ * while the page underneath changes; templates remount.
+ */
+export declare function RouteTree({ modules, segments, props, params, status, pageKind, pageKey, retry, metadata }: RouteTreeProps): ReactElement;
+/** Shown for 404s and errors when the app has no not-found or error page of its own. */
+export declare function BuiltInPage({ status, props }: {
+    status: number;
+    props: Record<string, unknown>;
+}): import("react").JSX.Element;
+//# sourceMappingURL=route-tree.d.ts.map

package/dist/route-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-tree.d.ts","sourceRoot":"","sources":["../src/route-tree.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAA2B,MAAM,OAAO,CAAC;AAC9F,OAAO,EAAE,KAAK,QAAQ,EAAiC,MAAM,gBAAgB,CAAC;AAC9E,OAAO,KAAK,EAAiC,YAAY,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEjE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,KAAK,cAAc,GAAG;IACpB,OAAO,EAAE,YAAY,CAAC;IACtB,iGAAiG;IACjG,QAAQ,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC,+GAA+G;IAC/G,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;CACjC,CAAC;AAEF,2GAA2G;AAC3G,eAAO,MAAM,kBAAkB,iCAAmB,CAAC;AAUnD,KAAK,aAAa,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,CAAC;AAE5H,0GAA0G;AAC1G,qBAAa,aAAc,SAAQ,SAAS,CAAC,aAAa,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;IACrF,KAAK;QAAK,KAAK,EAAU,OAAO;QAAE,MAAM;MAAU;IAE3D,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO;;;MAE7C;IAEQ,kBAAkB,CAAC,QAAQ,EAAE,aAAa,QAElD;IAED,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuD;IAEpE,MAAM,cAEd;CACF;AAcD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,OAAO,EAAE,QAAa,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,cAAc,GAAG,YAAY,CAoC7I;AAWD,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,+BAkBhG"}

package/dist/route-tree.js

@@ -0,0 +1,86 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Component, Suspense, createContext } from 'react';
+import { MetadataTags, resolveMetadata } from './metadata.js';
+/** How many URL segments the layout rendering here covers: what useSelectedLayoutSegment(s) count from. */
+export const LayoutDepthContext = createContext(0);
+/**
+ * URL depth of a segment folder when the server did not send it (special pages): its folders after the router root,
+ * route groups not counted.
+ */
+function depthOf(segmentId) {
+    return segmentId.split('/').slice(1).filter((folder) => !(folder.startsWith('(') && folder.endsWith(')'))).length;
+}
+/** Catches render errors below it; resets when `resetKey` changes (a navigation) or `reset` is called. */
+export class ErrorBoundary extends Component {
+    state = { error: null, failed: false };
+    static getDerivedStateFromError(error) {
+        return { error, failed: true };
+    }
+    componentDidUpdate(previous) {
+        if (previous.resetKey !== this.props.resetKey && this.state.failed)
+            this.setState({ error: null, failed: false });
+    }
+    reset = () => this.setState({ error: null, failed: false });
+    render() {
+        return this.state.failed ? this.props.fallback(this.state.error, this.reset) : this.props.children;
+    }
+}
+function asError(error) {
+    return error instanceof Error ? error : new Error(typeof error === 'string' ? error : 'Something went wrong');
+}
+/** The error the server reported (props of the error page it rendered), as an Error for `error.tsx`. */
+function serverError(props) {
+    const error = new Error(typeof props.message === 'string' ? props.message : 'Something went wrong');
+    if (typeof props.status === 'number')
+        error.status = props.status;
+    if (typeof props.stack === 'string')
+        error.stack = props.stack;
+    return error;
+}
+/**
+ * The page wrapped in its segments, outermost first. Per segment, as in the Next.js App Router:
+ * layout > template > error boundary > Suspense (loading) > the next segment or the page. Layouts keep their state
+ * while the page underneath changes; templates remount.
+ */
+export function RouteTree({ modules, segments = [], props, params, status, pageKind, pageKey, retry, metadata }) {
+    const Page = modules.page;
+    const pageProps = pageKind === 'error' ? { ...props, error: serverError(props), reset: retry ?? (() => { }) } : props;
+    let element = Page ? _jsx(Page, { ...pageProps }, pageKey) : _jsx(BuiltInPage, { status: status, props: props }, pageKey);
+    for (let i = modules.segments.length - 1; i >= 0; i--) {
+        const { Layout, Template, Loading, Error: SegmentError, slots } = modules.segments[i];
+        if (Loading)
+            element = _jsx(Suspense, { fallback: _jsx(Loading, {}), children: element });
+        if (SegmentError) {
+            const inner = element;
+            element = (_jsx(ErrorBoundary, { resetKey: pageKey, fallback: (error, reset) => _jsx(SegmentError, { error: asError(error), reset: reset }), children: inner }));
+        }
+        if (Template)
+            element = _jsx(Template, { children: element }, pageKey);
+        if (Layout) {
+            element = (_jsx(LayoutDepthContext, { value: segments[i]?.depth ?? depthOf(modules.segments[i].id), children: _jsx(Layout, { ...segments[i]?.props, ...slotElements(slots, params, segments[i]?.slotParams), params: params, children: element }) }));
+        }
+    }
+    const layoutsMetadata = modules.segments.map((segment) => segment.metadata);
+    const hasMetadata = layoutsMetadata.some(Boolean) || Boolean(modules.pageMetadata) || Boolean(metadata);
+    // One shape whether or not this page has metadata: the layouts stay at the same place in the tree, so React keeps
+    // them mounted when the user navigates between a page with metadata and one without.
+    return (_jsxs(_Fragment, { children: [hasMetadata ? _jsx(MetadataTags, { metadata: resolveMetadata(layoutsMetadata, modules.pageMetadata, metadata) }) : null, element] }));
+}
+/**
+ * Parallel routes: each slot as a prop of its layout, named like the folder without the @ (null renders nothing).
+ * Each slot's element gets the slot page's own params when the server sent them (else the page's).
+ */
+function slotElements(slots, params, slotParams) {
+    if (!slots)
+        return {};
+    return Object.fromEntries(Object.entries(slots).map(([name, Slot]) => [name, Slot ? _jsx(Slot, { params: slotParams?.[name] ?? params }) : null]));
+}
+/** Shown for 404s and errors when the app has no not-found or error page of its own. */
+export function BuiltInPage({ status, props }) {
+    const notFound = status === 404;
+    const title = notFound ? 'This page could not be found' : 'Something went wrong';
+    const message = !notFound && typeof props.message === 'string' ? props.message : null;
+    const stack = !notFound && typeof props.stack === 'string' ? props.stack : null;
+    return (_jsxs("main", { style: { fontFamily: 'system-ui, sans-serif', maxWidth: '42rem', margin: '12vh auto', padding: '0 1.5rem', lineHeight: 1.5 }, children: [_jsx("title", { children: `${status} · ${title}` }), _jsx("p", { style: { fontSize: '3.5rem', fontWeight: 700, margin: 0 }, children: status }), _jsx("h1", { style: { fontSize: '1.5rem', margin: '0.25rem 0 1rem' }, children: title }), message && _jsx("p", { style: { whiteSpace: 'pre-wrap', overflowWrap: 'anywhere' }, children: message }), stack && _jsx("pre", { style: { whiteSpace: 'pre-wrap', fontSize: '0.8rem', background: '#f4f4f5', padding: '1rem', borderRadius: 8 }, children: stack }), _jsx("p", { children: _jsx("a", { href: "/", children: "Go to the home page" }) })] }));
+}
+//# sourceMappingURL=route-tree.js.map

package/dist/route-tree.js.map

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

package/dist/router.d.ts

@@ -0,0 +1,118 @@
+import { type ComponentType, type ReactNode } from 'react';
+import type { EncodedForm } from './form-data.ts';
+import type { Href } from './href.ts';
+import { type ModuleLoader, type RouteModules } from './modules.ts';
+import { type ActionResponse, type PagePayload, type Params, type SpecialPageRef } from './payload.ts';
+import { type StandardSchemaV1 } from './schema.ts';
+/** A form post that did not produce a page: a non-page error response (`status`), or no response at all (`null`). */
+export type SubmitError = {
+    status: number | null;
+    action: string;
+};
+/** What the router is doing: idle, or on its way to `location` for a navigation (`loading`) or a form post (`submitting`). */
+export type NavigationState = {
+    state: 'idle';
+    error?: SubmitError;
+} | {
+    state: 'loading' | 'submitting';
+    location: string;
+};
+/** The client router that `useRouter()` returns. */
+export type Router = {
+    push(href: Href, options?: {
+        scroll?: boolean;
+    }): Promise<void>;
+    replace(href: Href, options?: {
+        scroll?: boolean;
+    }): Promise<void>;
+    /** Fetches the page payload and modules ahead of a navigation. Links do this on hover and focus. */
+    prefetch(href: Href): void;
+    /** Re-runs the current page's loader and re-renders with the new props. */
+    refresh(): Promise<void>;
+    back(): void;
+    forward(): void;
+};
+export type SubmitBody = EncodedForm;
+/** Called with every server action response, e.g. by the query shell to apply query updates. */
+export type ActionListener = (response: ActionResponse) => void;
+export type InternalRouter = Router & {
+    submit(action: URL, body: SubmitBody): Promise<void>;
+    onActionResponse(listener: ActionListener): () => void;
+    /**
+     * Called as soon as a server action call or form post says it set or deleted a cookie (signed someone in or out),
+     * e.g. by the query shell to drop the previous user's queries.
+     */
+    onCookiesChanged(listener: () => void): () => void;
+};
+/**
+ * Records how far the browser clock is from the server's, given a server time for "now": the `X-Netjes-Now` header
+ * of a data response, or for the initial document the payload's `renderedAt` (so the browser judges seeded data
+ * as fresh as the server did when it rendered, and hydration matches).
+ */
+export declare function withClockOffset<T extends PagePayload>(payload: T, serverNow: number | undefined, now?: number): T;
+/**
+ * Root-relative hrefs (`/about`, not `//host` or `https://…`) are written as if the app were mounted at the root.
+ * One that already starts with the base path (built from it on purpose) is left as it is.
+ */
+export declare function withBasePath(href: string, basePath: string): string;
+export type RouterProviderProps = {
+    initial: PagePayload;
+    initialModules: RouteModules;
+    loader: ModuleLoader;
+    errorPage: SpecialPageRef | null;
+    hardNavigate?: (href: string) => void;
+    showDocument?: (html: string, url: string) => void;
+    download?: (file: Blob, name: string) => void;
+    /** Wraps every page and the error page, inside the router: where app-wide providers such as the QueryClient go. */
+    shell?: ComponentType<{
+        children: ReactNode;
+    }> | undefined;
+};
+export declare function RouterProvider({ initial, initialModules, loader, errorPage, hardNavigate, showDocument, download, shell: Shell, }: RouterProviderProps): import("react").JSX.Element;
+/** The router's contexts without the router: for the test harness (netjes/testing), which fakes navigation. */
+export declare function RouterContexts({ router, payload, url, navigation, children, }: {
+    router: InternalRouter;
+    payload: PagePayload;
+    url: URL;
+    navigation: NavigationState;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare function useInternalRouter(): InternalRouter;
+/** The client router: `push`, `replace`, `prefetch`, `refresh`, `back` and `forward`. Throws outside a Netjes page. */
+export declare function useRouter(): Router;
+/** The path without the base path, as the app's routes see it (like Next.js's `usePathname` with `basePath`). */
+export declare function usePathname(): string;
+/** An href for a plain `<a>` or attribute, under the base path: what `<Link>` does for its own. */
+export declare function useHref(href: string): string;
+/** `UsePathBase`'s base path for this page, or '' when the app is mounted at the root. */
+export declare function useBasePath(): string;
+/**
+ * The query string; with a schema, parsed from `{ key: string | string[] }` (repeated keys become arrays).
+ * Visitors control the query string, so values the schema rejects are dropped (defaults then apply) rather than
+ * failing the page. Define the schema at module level: a new schema object each render parses again.
+ */
+export declare function useSearchParams(): URLSearchParams;
+export declare function useSearchParams<Schema extends StandardSchemaV1>(schema: Schema): StandardSchemaV1.InferOutput<Schema>;
+/**
+ * The route parameters (catch-all parameters are arrays); with a schema, parsed by it. A rejected value throws to
+ * the error boundary, so prefer C# route constraints (or a loader returning NotFound) for URLs visitors can mistype.
+ */
+export declare function useParams(): Params;
+export declare function useParams<Schema extends StandardSchemaV1>(schema: Schema): StandardSchemaV1.InferOutput<Schema>;
+/**
+ * The props configured with `NetjesOptions.SharedProps` on the server, available to every page and layout.
+ * Pass a schema to get them parsed and typed; without one they are `unknown`.
+ */
+export declare function useSharedProps(): unknown;
+export declare function useSharedProps<Schema extends StandardSchemaV1>(schema: Schema): StandardSchemaV1.InferOutput<Schema>;
+/**
+ * In a layout: the URL segments below it, decoded (route groups do not appear in URLs). Next.js
+ * `useSelectedLayoutSegments`. Outside layouts, the whole path.
+ */
+export declare function useSelectedLayoutSegments(): string[];
+/** In a layout: the active segment one level below it (e.g. the selected tab), or null at the layout's own page. */
+export declare function useSelectedLayoutSegment(): string | null;
+export declare function usePagePayload(): PagePayload;
+/** The router's state: `loading` during a navigation, `submitting` during a form post, else `idle` (with `error` after a post that produced no page). */
+export declare function useNavigation(): NavigationState;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

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