fontdue-js 3.0.5 → 3.1.0

package/dist/components/FeatureTester/FeatureTesters.js

@@ -0,0 +1,156 @@
+'use client';
+
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+import _FeatureTestersSlugQuery from "../../__generated__/FeatureTestersSlugQuery.graphql.js";
+import _FeatureTestersIdQuery from "../../__generated__/FeatureTestersIdQuery.graphql.js";
+import _FeatureTesters_collection from "../../__generated__/FeatureTesters_collection.graphql.js";
+import React from 'react';
+import { graphql, useFragment, useLazyLoadQuery, usePreloadedQuery } from 'react-relay';
+import FeatureTesterCard from './FeatureTesterCard.js';
+import { EnsureFontdueContext } from '../FontdueContextProvider/index.js';
+import FeatureTestersIdQueryNode from '../../__generated__/FeatureTestersIdQuery.graphql.js';
+import FeatureTestersSlugQueryNode from '../../__generated__/FeatureTestersSlugQuery.graphql.js';
+import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
+import useSerializablePreloadedQuery from '../../relay/useSerializablePreloadedQuery.js';
+const collectionFragment = (_FeatureTesters_collection.hash && _FeatureTesters_collection.hash !== "933c122b193ca5df430509d87e9c4e1d" && console.error("The definition of 'FeatureTesters_collection' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _FeatureTesters_collection);
+function FeatureTestersList(_ref) {
+  let {
+    collection,
+    highlightColor,
+    toggle,
+    autofit
+  } = _ref;
+  const data = useFragment(collectionFragment, collection);
+  return /*#__PURE__*/React.createElement(React.Fragment, null, data.featureTesters.map(ft => ft.fontStyle ? /*#__PURE__*/React.createElement(FeatureTesterCard, {
+    key: ft.id,
+    fontStyle: ft.fontStyle,
+    feature: ft.feature,
+    label: ft.label ?? undefined,
+    content: ft.content,
+    fontSize: ft.size != null ? Number(ft.size) : undefined,
+    lineHeight: ft.lineHeight != null ? Number(ft.lineHeight) : undefined,
+    alignment: ft.alignment === 'left' || ft.alignment === 'center' || ft.alignment === 'right' ? ft.alignment : undefined,
+    defaultOn: data.featureTesterDefaultOn,
+    changedRanges: ft.changedRanges,
+    variableSettings: ft.variableSettings,
+    highlightColor: highlightColor,
+    toggle: toggle,
+    autofit: autofit ?? ft.autofit,
+    showTag: data.featureTesterShowTag
+  }) : null));
+}
+const idQuery = (_FeatureTestersIdQuery.hash && _FeatureTestersIdQuery.hash !== "55f152ae85db4ebafd21ff7945f4079a" && console.error("The definition of 'FeatureTestersIdQuery' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _FeatureTestersIdQuery);
+const slugQuery = (_FeatureTestersSlugQuery.hash && _FeatureTestersSlugQuery.hash !== "726fca18c4a30ca9dd8f5aaf074c8139" && console.error("The definition of 'FeatureTestersSlugQuery' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _FeatureTestersSlugQuery);
+function ById(_ref2) {
+  let {
+    collectionId,
+    ...rest
+  } = _ref2;
+  const data = useLazyLoadQuery(idQuery, {
+    id: collectionId
+  });
+  return data.node ? /*#__PURE__*/React.createElement(FeatureTestersList, _extends({
+    collection: data.node
+  }, rest)) : null;
+}
+function BySlug(_ref3) {
+  var _data$viewer, _data$viewer$slug;
+  let {
+    collectionSlug,
+    ...rest
+  } = _ref3;
+  const data = useLazyLoadQuery(slugQuery, {
+    slug: collectionSlug
+  });
+  const coll = (_data$viewer = data.viewer) === null || _data$viewer === void 0 ? void 0 : (_data$viewer$slug = _data$viewer.slug) === null || _data$viewer$slug === void 0 ? void 0 : _data$viewer$slug.fontCollection;
+  return coll ? /*#__PURE__*/React.createElement(FeatureTestersList, _extends({
+    collection: coll
+  }, rest)) : null;
+}
+
+// ---- Server-preload path (RSC): the server awaits the query and hands the
+// serialized response to these client renderers, which commit it into the store
+// so `usePreloadedQuery` resolves synchronously on the client (no refetch on
+// hydration). Mirrors CharacterViewer.
+
+export async function loadFeatureTestersQuery(variables, options) {
+  if (variables.collectionId) {
+    return loadSerializableQuery(FeatureTestersIdQueryNode, {
+      id: variables.collectionId
+    }, options);
+  }
+  if (variables.collectionSlug) {
+    return loadSerializableQuery(FeatureTestersSlugQueryNode, {
+      slug: variables.collectionSlug
+    }, options);
+  }
+  throw new Error('loadFeatureTestersQuery expected either collectionId or collectionSlug');
+}
+export function FeatureTestersPreloadedIDQueryRenderer(_ref4) {
+  let {
+    preloadedQuery,
+    ...options
+  } = _ref4;
+  const queryRef = useSerializablePreloadedQuery(preloadedQuery, 'store-or-network', idQuery);
+  const data = usePreloadedQuery(idQuery, queryRef);
+  return data.node ? /*#__PURE__*/React.createElement(FeatureTestersList, _extends({
+    collection: data.node
+  }, options)) : null;
+}
+export function FeatureTestersPreloadedSlugQueryRenderer(_ref5) {
+  var _data$viewer2, _data$viewer2$slug;
+  let {
+    preloadedQuery,
+    ...options
+  } = _ref5;
+  const queryRef = useSerializablePreloadedQuery(preloadedQuery, 'store-or-network', slugQuery);
+  const data = usePreloadedQuery(slugQuery, queryRef);
+  const coll = (_data$viewer2 = data.viewer) === null || _data$viewer2 === void 0 ? void 0 : (_data$viewer2$slug = _data$viewer2.slug) === null || _data$viewer2$slug === void 0 ? void 0 : _data$viewer2$slug.fontCollection;
+  return coll ? /*#__PURE__*/React.createElement(FeatureTestersList, _extends({
+    collection: coll
+  }, options)) : null;
+}
+function FeatureTestersPreloadedRenderer(_ref6) {
+  let {
+    preloadedQuery,
+    ...options
+  } = _ref6;
+  if (preloadedQuery.params.name === 'FeatureTestersIdQuery') {
+    return /*#__PURE__*/React.createElement(FeatureTestersPreloadedIDQueryRenderer, _extends({
+      preloadedQuery: preloadedQuery
+    }, options));
+  }
+  return /*#__PURE__*/React.createElement(FeatureTestersPreloadedSlugQueryRenderer, _extends({
+    preloadedQuery: preloadedQuery
+  }, options));
+}
+
+// Renders every Feature Tester card a tenant has configured on a font
+// collection. Accepts a preloaded query (server-side preload path — Astro/RR7
+// frontmatter or a manual loader call) or `{collectionId}`/`{collectionSlug}`
+// for lazy fetch.
+export default function FeatureTesters(_ref7) {
+  let {
+    config,
+    ...props
+  } = _ref7;
+  const {
+    highlightColor,
+    toggle,
+    autofit
+  } = props;
+  const options = {
+    highlightColor,
+    toggle,
+    autofit
+  };
+  return /*#__PURE__*/React.createElement(EnsureFontdueContext, {
+    config: config
+  }, 'preloadedQuery' in props && props.preloadedQuery ? /*#__PURE__*/React.createElement(FeatureTestersPreloadedRenderer, _extends({
+    preloadedQuery: props.preloadedQuery
+  }, options)) : 'collectionId' in props && props.collectionId ? /*#__PURE__*/React.createElement(ById, _extends({
+    collectionId: props.collectionId
+  }, options)) : /*#__PURE__*/React.createElement(BySlug, _extends({
+    collectionSlug: props.collectionSlug
+  }, options)));
+}

package/dist/components/FeatureTester/FeatureTesters.server.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { FeatureTestersProps } from './FeatureTesters.js';
+export type { FeatureTestersPreloadedQuery } from './FeatureTesters.js';
+export declare function loadFeatureTestersQuery(): never;
+export default function FeatureTesters({ collectionId, collectionSlug, ...rest }: Extract<FeatureTestersProps, {
+    collectionId: string;
+} | {
+    collectionSlug: string;
+}>): Promise<React.JSX.Element | null>;

package/dist/components/FeatureTester/FeatureTesters.server.js

@@ -0,0 +1,40 @@
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+import React from 'react';
+import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
+import { FeatureTestersPreloadedIDQueryRenderer, FeatureTestersPreloadedSlugQueryRenderer } from './FeatureTesters.js';
+import FeatureTestersIdQueryNode from '../../__generated__/FeatureTestersIdQuery.graphql.js';
+import FeatureTestersSlugQueryNode from '../../__generated__/FeatureTestersSlugQuery.graphql.js';
+// Stub for the RSC export condition. See FontdueProvider/index.server.tsx
+// for the rationale.
+export function loadFeatureTestersQuery() {
+  throw new Error("loadFeatureTestersQuery isn't needed in React Server Components — " + 'the <FeatureTesters> server entrypoint awaits its query automatically. ' + 'Drop the manual call.');
+}
+
+// Next RSC variant: awaits the query on the server and hands the response to
+// the client `*PreloadedQueryRenderer`. Lets pages just write
+// `<FeatureTesters collectionSlug="..." />` in an RSC without manually invoking
+// `loadFeatureTestersQuery` + threading `preloadedQuery` through props.
+export default async function FeatureTesters(_ref) {
+  let {
+    collectionId,
+    collectionSlug,
+    ...rest
+  } = _ref;
+  if (collectionId) {
+    const preloadedQuery = await loadSerializableQuery(FeatureTestersIdQueryNode, {
+      id: collectionId
+    });
+    return /*#__PURE__*/React.createElement(FeatureTestersPreloadedIDQueryRenderer, _extends({
+      preloadedQuery: preloadedQuery
+    }, rest));
+  }
+  if (collectionSlug) {
+    const preloadedQuery = await loadSerializableQuery(FeatureTestersSlugQueryNode, {
+      slug: collectionSlug
+    });
+    return /*#__PURE__*/React.createElement(FeatureTestersPreloadedSlugQueryRenderer, _extends({
+      preloadedQuery: preloadedQuery
+    }, rest));
+  }
+  return null;
+}

package/dist/components/FeatureTester/FeatureTestersElement.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+interface FeatureTestersElement_props {
+    collectionId?: string;
+    collectionSlug?: string;
+    highlightColor?: string;
+    toggle?: string;
+    autofit?: string;
+}
+export declare const FeatureTestersElement: React.FC<FeatureTestersElement_props>;
+export default FeatureTestersElement;

package/dist/components/FeatureTester/FeatureTestersElement.js

@@ -0,0 +1,27 @@
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+import React from 'react';
+import FeatureTesters from './FeatureTesters.js';
+const parseBool = (input, fallback) => input === undefined || input === '' ? fallback : input === 'true';
+export const FeatureTestersElement = _ref => {
+  let {
+    collectionId,
+    collectionSlug,
+    highlightColor,
+    toggle,
+    autofit
+  } = _ref;
+  const shared = {
+    highlightColor: highlightColor || undefined,
+    // Only override the per-card dashboard settings when the attribute is
+    // actually present on the element; otherwise leave undefined so each card
+    // uses its own.
+    toggle: toggle === undefined ? undefined : toggle === 'hover' ? 'hover' : 'button',
+    autofit: autofit === undefined ? undefined : parseBool(autofit, false)
+  };
+  return collectionId ? /*#__PURE__*/React.createElement(FeatureTesters, _extends({
+    collectionId: collectionId
+  }, shared)) : /*#__PURE__*/React.createElement(FeatureTesters, _extends({
+    collectionSlug: collectionSlug || ''
+  }, shared));
+};
+export default FeatureTestersElement;

package/dist/components/FeatureTester/highlight.d.ts

@@ -0,0 +1,19 @@
+export interface GlyphNameEntry {
+    readonly characters: string;
+    readonly features?: readonly string[] | null;
+}
+export interface Segment {
+    text: string;
+    sensitive: boolean;
+}
+export interface Mark {
+    start: number;
+    end: number;
+}
+export declare function sensitiveStringsForFeature(glyphNames: readonly GlyphNameEntry[] | null | undefined, feature: string): string[];
+export interface SensitivityOptions {
+    autoStrings?: readonly string[];
+    addMarks?: readonly Mark[];
+}
+export declare function computeSensitivityFlags(content: string, opts: SensitivityOptions): boolean[];
+export declare function segmentByFlags(content: string, flags: readonly boolean[]): Segment[];

package/dist/components/FeatureTester/highlight.js

@@ -0,0 +1,71 @@
+// Decide which characters in a sample string are "sensitive" to an OpenType
+// feature.
+//
+// Auto-detection: `FontStyle.glyphNames` lists `{ characters, features }` where
+// `characters` is the INPUT string a feature substitutes (a single character
+// for single substitutions like ss03/smcp, or a sequence for ligatures like
+// dlig). "Which characters does feature X touch" is the set of `characters`
+// whose `features` includes X. That static map only covers single + ligature
+// substitutions; the exact set for any feature comes from the server's shaped
+// diff (`changedRanges`), which FeatureTesterCard passes in as marks.
+//
+// Everything is computed as a boolean-per-codepoint array so the sources
+// compose cleanly. A contiguous run of `true` becomes one highlight span, which
+// keeps ligature clusters whole (we never split a cluster across spans).
+
+// An inclusive code-point index range. FeatureTesterCard builds these from the
+// server-materialized `changedRanges`.
+
+// The de-duplicated set of input strings the feature substitutes.
+export function sensitiveStringsForFeature(glyphNames, feature) {
+  if (!glyphNames) return [];
+  const set = new Set();
+  for (const g of glyphNames) {
+    if (g.characters && g.features && g.features.includes(feature)) {
+      set.add(g.characters);
+    }
+  }
+  return Array.from(set);
+}
+
+// Set flags[i] = true for every occurrence of `value` (matched by code point).
+function applyText(chars, value, flags) {
+  const seq = Array.from(value);
+  if (seq.length === 0) return;
+  for (let i = 0; i + seq.length <= chars.length; i++) {
+    if (seq.every((c, k) => chars[i + k] === c)) {
+      for (let k = 0; k < seq.length; k++) flags[i + k] = true;
+    }
+  }
+}
+export function computeSensitivityFlags(content, opts) {
+  const chars = Array.from(content);
+  const flags = new Array(chars.length).fill(false);
+  if (opts.autoStrings) {
+    for (const value of opts.autoStrings) applyText(chars, value, flags);
+  }
+  if (opts.addMarks) {
+    for (const mark of opts.addMarks) {
+      for (let i = Math.max(0, mark.start); i <= mark.end && i < chars.length; i++) {
+        flags[i] = true;
+      }
+    }
+  }
+  return flags;
+}
+
+// Collapse a per-codepoint flag array into consecutive sensitive/non-sensitive
+// runs (one highlight span each).
+export function segmentByFlags(content, flags) {
+  const chars = Array.from(content);
+  const segments = [];
+  for (let i = 0; i < chars.length; i++) {
+    const sensitive = flags[i] ?? false;
+    const last = segments[segments.length - 1];
+    if (last && last.sensitive === sensitive) last.text += chars[i];else segments.push({
+      text: chars[i],
+      sensitive
+    });
+  }
+  return segments;
+}

package/dist/components/FeatureTester/index.d.ts

@@ -0,0 +1,26 @@
+import React from 'react';
+import { FeatureTesterCardOptions } from './FeatureTesterCard.js';
+import { Config } from '../ConfigContext.js';
+import { SerializablePreloadedQuery, type LoadQueryOptions } from '../../relay/loadSerializableQuery.js';
+import { FeatureTesterStandaloneQuery } from '../../__generated__/FeatureTesterStandaloneQuery.graphql.js';
+export type FeatureTesterPreloadedQuery = SerializablePreloadedQuery<FeatureTesterStandaloneQuery>;
+export interface LoadFeatureTesterQueryVariables {
+    familyName: string;
+    styleName: string;
+}
+export declare function loadFeatureTesterQuery(variables: LoadFeatureTesterQueryVariables, options?: LoadQueryOptions): Promise<FeatureTesterPreloadedQuery>;
+export declare function FeatureTesterPreloadedRenderer({ preloadedQuery, ...rest }: FeatureTesterCardOptions & {
+    preloadedQuery: FeatureTesterPreloadedQuery;
+}): React.JSX.Element;
+export type FeatureTesterProps = FeatureTesterCardOptions & {
+    config?: Config;
+} & ({
+    preloadedQuery: FeatureTesterPreloadedQuery;
+    familyName?: never;
+    styleName?: never;
+} | {
+    preloadedQuery?: never;
+    familyName: string;
+    styleName: string;
+});
+export default function FeatureTester(props: FeatureTesterProps): React.JSX.Element;

package/dist/components/FeatureTester/index.js

@@ -0,0 +1,66 @@
+'use client';
+
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+import _FeatureTesterStandaloneQuery from "../../__generated__/FeatureTesterStandaloneQuery.graphql.js";
+import React from 'react';
+import { graphql, useLazyLoadQuery, usePreloadedQuery } from 'react-relay';
+import FeatureTesterCard from './FeatureTesterCard.js';
+import { EnsureFontdueContext } from '../FontdueContextProvider/index.js';
+import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
+import useSerializablePreloadedQuery from '../../relay/useSerializablePreloadedQuery.js';
+import FeatureTesterStandaloneQueryNode from '../../__generated__/FeatureTesterStandaloneQuery.graphql.js';
+const query = (_FeatureTesterStandaloneQuery.hash && _FeatureTesterStandaloneQuery.hash !== "eddba300b2fd5e283ab1f8f787edc518" && console.error("The definition of 'FeatureTesterStandaloneQuery' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _FeatureTesterStandaloneQuery);
+function FeatureTesterRender(_ref) {
+  var _data$viewer;
+  let {
+    data,
+    ...rest
+  } = _ref;
+  const fontStyle = (_data$viewer = data.viewer) === null || _data$viewer === void 0 ? void 0 : _data$viewer.fontStyle;
+  if (!fontStyle) {
+    console.log('[FeatureTester]: No FontStyle found');
+    return null;
+  }
+  return /*#__PURE__*/React.createElement(FeatureTesterCard, _extends({
+    fontStyle: fontStyle
+  }, rest));
+}
+export async function loadFeatureTesterQuery(variables, options) {
+  return loadSerializableQuery(FeatureTesterStandaloneQueryNode, {
+    familyName: variables.familyName,
+    styleName: variables.styleName
+  }, options);
+}
+export function FeatureTesterPreloadedRenderer(_ref2) {
+  let {
+    preloadedQuery,
+    ...rest
+  } = _ref2;
+  const queryRef = useSerializablePreloadedQuery(preloadedQuery, 'store-or-network', query);
+  const data = usePreloadedQuery(query, queryRef);
+  return /*#__PURE__*/React.createElement(FeatureTesterRender, _extends({
+    data: data
+  }, rest));
+}
+function FeatureTesterLazyRenderer(_ref3) {
+  let {
+    familyName,
+    styleName,
+    ...rest
+  } = _ref3;
+  const data = useLazyLoadQuery(query, {
+    familyName,
+    styleName
+  });
+  return /*#__PURE__*/React.createElement(FeatureTesterRender, _extends({
+    data: data
+  }, rest));
+}
+// Unified FeatureTester entry point. Accepts either a preloaded query
+// (server-side preload path) or `{familyName, styleName}` (lazy path, used by
+// the CDN custom element and inside an existing `<FontdueProvider>` tree).
+export default function FeatureTester(props) {
+  return /*#__PURE__*/React.createElement(EnsureFontdueContext, {
+    config: props.config
+  }, 'preloadedQuery' in props && props.preloadedQuery ? /*#__PURE__*/React.createElement(FeatureTesterPreloadedRenderer, props) : /*#__PURE__*/React.createElement(FeatureTesterLazyRenderer, props));
+}

package/dist/components/FeatureTester/index.server.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { FeatureTesterProps } from './index.js';
+export type { FeatureTesterPreloadedQuery } from './index.js';
+export declare function loadFeatureTesterQuery(): never;
+export default function FeatureTester(props: Extract<FeatureTesterProps, {
+    familyName: string;
+}>): Promise<React.JSX.Element>;

package/dist/components/FeatureTester/index.server.js

@@ -0,0 +1,30 @@
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+import React from 'react';
+import loadSerializableQuery from '../../relay/loadSerializableQuery.js';
+import { FeatureTesterPreloadedRenderer } from './index.js';
+import FeatureTesterStandaloneQueryNode from '../../__generated__/FeatureTesterStandaloneQuery.graphql.js';
+// Stub for the RSC export condition. See FontdueProvider/index.server.tsx
+// for the rationale.
+export function loadFeatureTesterQuery() {
+  throw new Error("loadFeatureTesterQuery isn't needed in React Server Components — " + 'the <FeatureTester> server entrypoint awaits its query automatically. ' + 'Drop the manual call.');
+}
+
+// Next RSC variant: awaits the query on the server and hands the response to
+// the client `FeatureTesterPreloadedRenderer`. Lets pages just write
+// `<FeatureTester familyName="..." styleName="..." feature="..." content="..." />`
+// in an RSC without manually invoking `loadFeatureTesterQuery` + threading
+// `preloadedQuery` through props.
+export default async function FeatureTester(props) {
+  const {
+    familyName,
+    styleName,
+    ...rest
+  } = props;
+  const preloadedQuery = await loadSerializableQuery(FeatureTesterStandaloneQueryNode, {
+    familyName,
+    styleName
+  });
+  return /*#__PURE__*/React.createElement(FeatureTesterPreloadedRenderer, _extends({
+    preloadedQuery: preloadedQuery
+  }, rest));
+}

package/dist/components/NodePasswordForm/NodePasswordFormElement.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { NodePasswordForm_props } from './index.js';
+export default function NodePasswordFormElement({ collectionId, collectionSlug, ...rest }: NodePasswordForm_props): React.JSX.Element;

package/dist/components/NodePasswordForm/NodePasswordFormElement.js

@@ -0,0 +1,65 @@
+'use client';
+
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+import _NodePasswordFormElementSlugQuery from "../../__generated__/NodePasswordFormElementSlugQuery.graphql.js";
+import _NodePasswordFormElementIDQuery from "../../__generated__/NodePasswordFormElementIDQuery.graphql.js";
+import React from 'react';
+import { graphql, useLazyLoadQuery } from 'react-relay';
+import NodePasswordForm from './index.js';
+// Auto-detecting wrapper behind the <fontdue-node-password-form> custom element.
+// Unlike the presentational React component (the default export of ./index, used
+// when the server has already detected the lock), this queries the collection
+// itself and renders the form only when access is denied — so it works dropped
+// onto any page, hiding itself for a visitor who already has access.
+
+const idQuery = (_NodePasswordFormElementIDQuery.hash && _NodePasswordFormElementIDQuery.hash !== "213a61ae079e4f57b7b197b0d2f5256a" && console.error("The definition of 'NodePasswordFormElementIDQuery' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _NodePasswordFormElementIDQuery);
+function NodePasswordFormIDQueryRenderer(_ref) {
+  let {
+    collectionId,
+    ...rest
+  } = _ref;
+  const data = useLazyLoadQuery(idQuery, {
+    collectionId
+  });
+  // The @catch directive surfaces the password-protection error as ok:false; the
+  // node is only locked then, so only then do we render the form (we don't want
+  // to show it to a visitor who already has access).
+  if (data.collection.ok === false) return /*#__PURE__*/React.createElement(NodePasswordForm, _extends({}, rest, {
+    collectionId: collectionId
+  }));
+  return null;
+}
+const slugQuery = (_NodePasswordFormElementSlugQuery.hash && _NodePasswordFormElementSlugQuery.hash !== "200a33ca6a1f9e4e7e95b7100bbdd261" && console.error("The definition of 'NodePasswordFormElementSlugQuery' appears to have changed. Run `relay-compiler` to update the generated files to receive the expected data."), _NodePasswordFormElementSlugQuery);
+function NodePasswordFormSlugQueryRenderer(_ref2) {
+  var _data$viewer$slug;
+  let {
+    collectionSlug,
+    ...rest
+  } = _ref2;
+  const data = useLazyLoadQuery(slugQuery, {
+    collectionSlug
+  });
+  // see note in NodePasswordFormIDQueryRenderer
+  if (((_data$viewer$slug = data.viewer.slug) === null || _data$viewer$slug === void 0 ? void 0 : _data$viewer$slug.collection.ok) === false) return /*#__PURE__*/React.createElement(NodePasswordForm, _extends({}, rest, {
+    collectionSlug: collectionSlug
+  }));
+  return null;
+}
+export default function NodePasswordFormElement(_ref3) {
+  let {
+    collectionId,
+    collectionSlug,
+    ...rest
+  } = _ref3;
+  if (collectionId) {
+    return /*#__PURE__*/React.createElement(NodePasswordFormIDQueryRenderer, _extends({
+      collectionId: collectionId
+    }, rest));
+  }
+  if (collectionSlug) {
+    return /*#__PURE__*/React.createElement(NodePasswordFormSlugQueryRenderer, _extends({
+      collectionSlug: collectionSlug
+    }, rest));
+  }
+  throw new Error('NodePasswordForm expected either a collectionId or collectionSlug prop');
+}

package/dist/components/NodePasswordForm/index.d.ts

@@ -3,4 +3,19 @@ export interface NodePasswordForm_props {
     collectionId?: string | null;
     collectionSlug?: string | null;
 }
-export default function NodePasswordForm({ collectionId, collectionSlug, ...rest }: NodePasswordForm_props): React.JSX.Element;
+/**
+ * Password form for a collection you already know is locked. Render it when a
+ * collection comes back password-protected (see the per-framework guides): it
+ * commits the `accessNode` mutation, remembers the returned access token, and
+ * reloads so the now-unlocked collection renders.
+ *
+ * Unlike the `<fontdue-node-password-form>` custom element (which detects the
+ * locked state itself), this does no data fetching of its own, so it renders
+ * immediately on the server with no Suspense flash — the server already detected
+ * the lock.
+ *
+ * Self-wraps in `EnsureFontdueContext` so it works as a standalone island (e.g.
+ * an Astro `client:load`) without its own provider, and no-ops inside an outer
+ * `<FontdueProvider>` (Next/RR7/TanStack).
+ */
+export default function NodePasswordForm(props: NodePasswordForm_props): React.JSX.Element;