@feelflow/ffid-sdk 2.10.0 → 2.12.0

package/dist/components/index.cjs

@@ -1,34 +1,34 @@
 'use strict';
 
-var chunk55KLWKM7_cjs = require('../chunk-55KLWKM7.cjs');
+var chunk5ZMR3NNO_cjs = require('../chunk-5ZMR3NNO.cjs');
 
 
 
 Object.defineProperty(exports, "FFIDAnnouncementBadge", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.FFIDAnnouncementBadge; }
+  get: function () { return chunk5ZMR3NNO_cjs.FFIDAnnouncementBadge; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementList", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.FFIDAnnouncementList; }
+  get: function () { return chunk5ZMR3NNO_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDInquiryForm", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.FFIDInquiryForm; }
+  get: function () { return chunk5ZMR3NNO_cjs.FFIDInquiryForm; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.FFIDLoginButton; }
+  get: function () { return chunk5ZMR3NNO_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunk5ZMR3NNO_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunk5ZMR3NNO_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.FFIDUserMenu; }
+  get: function () { return chunk5ZMR3NNO_cjs.FFIDUserMenu; }
 });

package/dist/components/index.d.cts

@@ -1,3 +1,3 @@
-export { H as FFIDAnnouncementBadge, ac as FFIDAnnouncementBadgeClassNames, ad as FFIDAnnouncementBadgeProps, I as FFIDAnnouncementList, ae as FFIDAnnouncementListClassNames, af as FFIDAnnouncementListProps, Q as FFIDInquiryForm, R as FFIDInquiryFormCategoryItem, S as FFIDInquiryFormOrganization, T as FFIDInquiryFormPlaceholderContext, U as FFIDInquiryFormPrefill, V as FFIDInquiryFormProps, W as FFIDInquiryFormSubmitData, X as FFIDInquiryFormSubmitResult, Z as FFIDLoginButton, ag as FFIDLoginButtonProps, a3 as FFIDOrganizationSwitcher, ah as FFIDOrganizationSwitcherClassNames, ai as FFIDOrganizationSwitcherProps, a5 as FFIDSubscriptionBadge, aj as FFIDSubscriptionBadgeClassNames, ak as FFIDSubscriptionBadgeProps, a7 as FFIDUserMenu, al as FFIDUserMenuClassNames, am as FFIDUserMenuProps } from '../index-BSuGxrqG.cjs';
+export { H as FFIDAnnouncementBadge, ad as FFIDAnnouncementBadgeClassNames, ae as FFIDAnnouncementBadgeProps, I as FFIDAnnouncementList, af as FFIDAnnouncementListClassNames, ag as FFIDAnnouncementListProps, Q as FFIDInquiryForm, R as FFIDInquiryFormCategoryItem, S as FFIDInquiryFormClassNames, T as FFIDInquiryFormOrganization, U as FFIDInquiryFormPlaceholderContext, V as FFIDInquiryFormPrefill, W as FFIDInquiryFormProps, X as FFIDInquiryFormSubmitData, Y as FFIDInquiryFormSubmitResult, _ as FFIDLoginButton, ah as FFIDLoginButtonProps, a4 as FFIDOrganizationSwitcher, ai as FFIDOrganizationSwitcherClassNames, aj as FFIDOrganizationSwitcherProps, a6 as FFIDSubscriptionBadge, ak as FFIDSubscriptionBadgeClassNames, al as FFIDSubscriptionBadgeProps, a8 as FFIDUserMenu, am as FFIDUserMenuClassNames, an as FFIDUserMenuProps } from '../index-BuT9VaRt.cjs';
 import 'react/jsx-runtime';
 import 'react';

package/dist/components/index.d.ts

@@ -1,3 +1,3 @@
-export { H as FFIDAnnouncementBadge, ac as FFIDAnnouncementBadgeClassNames, ad as FFIDAnnouncementBadgeProps, I as FFIDAnnouncementList, ae as FFIDAnnouncementListClassNames, af as FFIDAnnouncementListProps, Q as FFIDInquiryForm, R as FFIDInquiryFormCategoryItem, S as FFIDInquiryFormOrganization, T as FFIDInquiryFormPlaceholderContext, U as FFIDInquiryFormPrefill, V as FFIDInquiryFormProps, W as FFIDInquiryFormSubmitData, X as FFIDInquiryFormSubmitResult, Z as FFIDLoginButton, ag as FFIDLoginButtonProps, a3 as FFIDOrganizationSwitcher, ah as FFIDOrganizationSwitcherClassNames, ai as FFIDOrganizationSwitcherProps, a5 as FFIDSubscriptionBadge, aj as FFIDSubscriptionBadgeClassNames, ak as FFIDSubscriptionBadgeProps, a7 as FFIDUserMenu, al as FFIDUserMenuClassNames, am as FFIDUserMenuProps } from '../index-BSuGxrqG.js';
+export { H as FFIDAnnouncementBadge, ad as FFIDAnnouncementBadgeClassNames, ae as FFIDAnnouncementBadgeProps, I as FFIDAnnouncementList, af as FFIDAnnouncementListClassNames, ag as FFIDAnnouncementListProps, Q as FFIDInquiryForm, R as FFIDInquiryFormCategoryItem, S as FFIDInquiryFormClassNames, T as FFIDInquiryFormOrganization, U as FFIDInquiryFormPlaceholderContext, V as FFIDInquiryFormPrefill, W as FFIDInquiryFormProps, X as FFIDInquiryFormSubmitData, Y as FFIDInquiryFormSubmitResult, _ as FFIDLoginButton, ah as FFIDLoginButtonProps, a4 as FFIDOrganizationSwitcher, ai as FFIDOrganizationSwitcherClassNames, aj as FFIDOrganizationSwitcherProps, a6 as FFIDSubscriptionBadge, ak as FFIDSubscriptionBadgeClassNames, al as FFIDSubscriptionBadgeProps, a8 as FFIDUserMenu, am as FFIDUserMenuClassNames, an as FFIDUserMenuProps } from '../index-BuT9VaRt.js';
 import 'react/jsx-runtime';
 import 'react';

package/dist/components/index.js

@@ -1 +1 @@
-export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-6DYAJ6IJ.js';
+export { FFIDAnnouncementBadge, FFIDAnnouncementList, FFIDInquiryForm, FFIDLoginButton, FFIDOrganizationSwitcher, FFIDSubscriptionBadge, FFIDUserMenu } from '../chunk-KJUA77BM.js';

package/dist/{index-BSuGxrqG.d.cts → index-BuT9VaRt.d.cts}

@@ -886,6 +886,85 @@ interface FFIDAnnouncementListProps {
  */
 declare function FFIDAnnouncementList({ announcements, isLoading, className, classNames, style, formatDate, emptyMessage, loadingRender, renderItem, maxContentLines, }: FFIDAnnouncementListProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Internals shared with the `FFIDInquiryForm` component.
+ *
+ * Split out of `FFIDInquiryForm.tsx` to keep that file under the repo's
+ * hard file-size limit. Everything exported here is part of the SDK's
+ * private surface — do NOT re-export these from `components/index.ts`.
+ * The single source of truth for consumers is `FFIDInquiryForm.tsx`.
+ */
+
+/** Category option rendered in the form select. */
+interface FFIDInquiryFormCategoryItem {
+    value: string;
+    label: string;
+    group?: string;
+    groupLabel?: string;
+}
+/**
+ * Per-slot `className` overrides. Every key is optional; when omitted,
+ * the slot falls back to SDK defaults. Intended to be combined with
+ * `unstyled={true}` for full brand styling (Tailwind / CSS-in-JS /
+ * global CSS), but also works on top of the default inline styles when
+ * `unstyled={false}` if the consumer wants to layer additional classes.
+ *
+ * Composition rules:
+ * - `form` is applied *in addition to* the top-level `className` prop
+ *   (both are space-joined on the root `<form>` and on the success
+ *   `<div role="status">`).
+ * - `readOnlyInput` is applied *in addition to* `input` on name / email
+ *   inputs in `mode='authenticated'`; it is not a standalone class.
+ * - `successBlock` is layered on top of `form` on the success view so
+ *   the wrapper stays themeable while the success-specific layer can
+ *   add its own class.
+ * - `categoryPlaceholderOption` is only rendered when
+ *   `requireCategorySelection` is true; setting it otherwise is a
+ *   silent no-op.
+ */
+interface FFIDInquiryFormClassNames {
+    /** Root `<form>` (or the success `<div role="status">`). Merges with the top-level `className` prop. */
+    form?: string;
+    /** Wrapper around each labeled input. */
+    field?: string;
+    /** `<label>` / `<legend>` elements. */
+    label?: string;
+    /** `<input>` elements for name / email / company / phone. */
+    input?: string;
+    /** Extra class added on top of `input` when the input is read-only. */
+    readOnlyInput?: string;
+    /** `<select>` elements (category + organization). */
+    select?: string;
+    /** `<textarea>` for the message body. */
+    textarea?: string;
+    /** Disabled "選択してください" option emitted when `requireCategorySelection` is true. */
+    categoryPlaceholderOption?: string;
+    /** `<fieldset>` wrapping the newsletter opt-in checkboxes. */
+    newsletterFieldset?: string;
+    /** `<legend>` of the newsletter fieldset. */
+    newsletterLegend?: string;
+    /** `<label>` row for each newsletter checkbox. */
+    newsletterRow?: string;
+    /** Each newsletter `<input type="checkbox">`. */
+    newsletterCheckbox?: string;
+    /** Wrapper around the legal agreement block. */
+    legalBlock?: string;
+    /** `<label>` row for each legal checkbox. */
+    legalRow?: string;
+    /** Each legal `<input type="checkbox">`. */
+    legalCheckbox?: string;
+    /** Terms / privacy `<a>` links rendered inline with the legal checkbox label. */
+    legalLink?: string;
+    /** `<p role="alert">` container for the form-level error message. */
+    errorText?: string;
+    /** `<button type="submit">`. */
+    submitButton?: string;
+    /** Success `<div role="status">` rendered after a successful submit. */
+    successBlock?: string;
+    /** Wrapper around the organization `<select>` (authenticated mode). */
+    orgSelectWrapper?: string;
+}
+
 /**
  * Known category literal with an escape hatch for arbitrary strings, so
  * IDE autocomplete suggests the built-in set while still accepting any
@@ -914,25 +993,14 @@ interface FFIDInquiryFormPrefill {
     /**
      * Preselected category value. Silently ignored if the value does not
      * match any entry in `categories` (or the default list when `categories`
-     * is omitted), so consumers can safely forward URL query strings.
+     * is omitted), so consumers can safely forward URL query strings. When
+     * `requireCategorySelection` is true and this is missing/invalid, the
+     * form starts with an empty selection instead of auto-choosing the
+     * first option.
      */
     category?: FFIDInquiryCategoryValue;
     message?: string;
 }
-/**
- * Category option rendered in the form select. If any item has a
- * `group` the select switches into `<optgroup>` mode; ungrouped items
- * are emitted as bare `<option>` entries before the first `<optgroup>`
- * in DOM order. Groups render in the order each `group` key first
- * appears in `categories`, and the first encountered `groupLabel` wins
- * when a `group` key repeats with inconsistent labels.
- */
-interface FFIDInquiryFormCategoryItem {
-    value: string;
-    label: string;
-    group?: string;
-    groupLabel?: string;
-}
 interface FFIDInquiryFormSubmitData {
     name: string;
     email: string;
@@ -973,18 +1041,11 @@ interface FFIDInquiryFormProps {
     onSubmit: (data: FFIDInquiryFormSubmitData) => Promise<FFIDInquiryFormSubmitResult>;
     /**
      * Called after every change to a field that is part of the submit
-     * payload (including the initial mount with prefilled values and
-     * re-fires when `termsVersion`/`privacyVersion`/`turnstileToken`/
-     * `locale` props change). Enables consumers to mirror state for
-     * URL-driven banners, analytics, or dynamic placeholders without
-     * owning the form. Consent checkboxes (`separateLegalCheckboxes` or
-     * the combined variant) are intentionally excluded — they are not
-     * part of `FFIDInquiryFormSubmitData`. Emitted values use the same
-     * normalization as `onSubmit` (string fields are trimmed; empty
-     * strings become `null` for `company` / `phone`).
-     *
-     * React StrictMode double-invokes effects in development, so expect
-     * two calls per mount in dev builds.
+     * payload. Consent checkboxes are intentionally excluded — they are
+     * not part of `FFIDInquiryFormSubmitData`. Emitted values use the
+     * same normalization as `onSubmit` (trimmed strings; empty
+     * `company`/`phone` become `null`). React StrictMode double-invokes
+     * effects in dev, so expect two calls per mount.
      */
     onChange?: (data: FFIDInquiryFormSubmitData) => void;
     /**
@@ -996,29 +1057,53 @@ interface FFIDInquiryFormProps {
     /**
      * Overrides the `<textarea>` placeholder. A plain string is applied
      * verbatim; a function is called with the currently selected category
-     * so consumers can vary the copy per selection (e.g. different hint
-     * text for "sales" vs "support"). The SDK memoizes the resolved
-     * placeholder keyed on `category` and the `messagePlaceholder`
-     * identity, so the function typically re-runs only when the user
-     * picks a different category or the prop reference changes — keep it
-     * cheap and pure so that contract is safe to rely on.
-     *
-     * When omitted, no `placeholder` attribute is emitted (SDK ≤ 2.9
-     * behavior).
+     * so consumers can vary the copy per selection. Memoized on the
+     * resolved `category` + `messagePlaceholder` identity. Omitting the
+     * prop leaves the textarea with no `placeholder` attribute.
      */
     messagePlaceholder?: string | ((ctx: FFIDInquiryFormPlaceholderContext) => string);
+    /**
+     * When true, the category `<select>` starts empty (unless `prefill.category`
+     * resolves to a valid option) and renders a disabled "選択してください"
+     * placeholder as the first option. Submits are blocked with an error
+     * message until the user explicitly picks a category. Default `false`
+     * preserves the SDK ≤ 2.10 behavior of auto-selecting the first option.
+     *
+     * Use this when the downstream routing depends on an intentional
+     * category choice — the default auto-selection silently misclassifies
+     * inquiries from users who never interacted with the dropdown.
+     */
+    requireCategorySelection?: boolean;
+    /**
+     * When true, drops every inline `style` attribute the SDK adds.
+     * Structural attributes (`required`, `readOnly`, `noValidate`, `role`,
+     * `data-hydrated`, …) are kept so keyboard / screen-reader semantics
+     * are unchanged. Pair with `classNames` for fully branded rendering.
+     * Default `false` keeps the inline-styled defaults from SDK ≤ 2.10.
+     */
+    unstyled?: boolean;
+    /**
+     * Per-slot `className` overrides. See `FFIDInquiryFormClassNames` for
+     * the full list of slots. Classes apply **in addition to** any inline
+     * `style` the SDK emits unless `unstyled={true}`.
+     */
+    classNames?: FFIDInquiryFormClassNames;
     locale?: 'ja' | 'en';
+    /**
+     * Additional class for the root `<form>` (or the success `<div>`).
+     * Kept for backward compatibility with SDK ≤ 2.10; merges with
+     * `classNames.form` when both are provided.
+     */
     className?: string;
 }
 /**
- * Context passed to a function-form `messagePlaceholder`. `category` is
- * typed `string | null` so a future unselected-state can be introduced
- * without breaking consumers, even though the current form always has a
- * non-null category value selected.
+ * Context passed to a function-form `messagePlaceholder`. When
+ * `requireCategorySelection` is true and nothing is selected yet, the
+ * form passes `null` here.
  */
 interface FFIDInquiryFormPlaceholderContext {
     category: string | null;
 }
-declare function FFIDInquiryForm({ mode, prefill, organizations, preselectedOrganizationId, categories, termsVersion, privacyVersion, termsHref, privacyHref, turnstileToken, turnstileSlot, onSubmit, onChange, separateLegalCheckboxes, messagePlaceholder, locale, className, }: FFIDInquiryFormProps): react_jsx_runtime.JSX.Element;
+declare function FFIDInquiryForm({ mode, prefill, organizations, preselectedOrganizationId, categories, termsVersion, privacyVersion, termsHref, privacyHref, turnstileToken, turnstileSlot, onSubmit, onChange, separateLegalCheckboxes, messagePlaceholder, requireCategorySelection, unstyled, classNames, locale, className, }: FFIDInquiryFormProps): react_jsx_runtime.JSX.Element;
 
-export { type FFIDOAuthTokenResponse as $, type FFIDAnnouncementsApiResponse as A, type AnnouncementListResponse as B, type FFIDAnnouncementsLogger as C, type Announcement as D, type AnnouncementStatus as E, type FFIDSubscriptionStatus as F, type AnnouncementType as G, FFIDAnnouncementBadge as H, FFIDAnnouncementList as I, type FFIDAnnouncementsError as J, type FFIDAnnouncementsErrorCode as K, type ListAnnouncementsOptions as L, type FFIDAnnouncementsServerResponse as M, type FFIDCacheConfig as N, type FFIDContextValue as O, type FFIDInquiryCategory as P, FFIDInquiryForm as Q, type FFIDInquiryFormCategoryItem as R, type FFIDInquiryFormOrganization as S, type FFIDInquiryFormPlaceholderContext as T, type FFIDInquiryFormPrefill as U, type FFIDInquiryFormProps as V, type FFIDInquiryFormSubmitData as W, type FFIDInquiryFormSubmitResult as X, type FFIDJwtClaims as Y, FFIDLoginButton as Z, type FFIDMemberStatus as _, type FFIDConfig as a, type FFIDOAuthUserInfoMemberRole as a0, type FFIDOAuthUserInfoSubscription as a1, type FFIDOrganizationMember as a2, FFIDOrganizationSwitcher as a3, type FFIDSeatModel as a4, FFIDSubscriptionBadge as a5, type FFIDTokenIntrospectionResponse as a6, FFIDUserMenu as a7, FFID_INQUIRY_CATEGORIES as a8, type UseFFIDAnnouncementsOptions as a9, type UseFFIDAnnouncementsReturn as aa, useFFIDAnnouncements as ab, type FFIDAnnouncementBadgeClassNames as ac, type FFIDAnnouncementBadgeProps as ad, type FFIDAnnouncementListClassNames as ae, type FFIDAnnouncementListProps as af, type FFIDLoginButtonProps as ag, type FFIDOrganizationSwitcherClassNames as ah, type FFIDOrganizationSwitcherProps as ai, type FFIDSubscriptionBadgeClassNames as aj, type FFIDSubscriptionBadgeProps as ak, type FFIDUserMenuClassNames as al, type FFIDUserMenuProps as am, type FFIDApiResponse as b, type FFIDSessionResponse as c, type FFIDRedirectResult as d, type FFIDError as e, type FFIDSubscriptionCheckResponse as f, type FFIDListMembersResponse as g, type FFIDMemberRole as h, type FFIDUpdateMemberRoleResponse as i, type FFIDRemoveMemberResponse as j, type FFIDCreateCheckoutParams as k, type FFIDCheckoutSessionResponse as l, type FFIDCreatePortalParams as m, type FFIDPortalSessionResponse as n, type FFIDVerifyAccessTokenOptions as o, type FFIDOAuthUserInfo as p, type FFIDInquiryCreateParams as q, type FFIDInquiryCreateResponse as r, type FFIDAuthMode as s, type FFIDLogger as t, type FFIDCacheAdapter as u, type FFIDUser as v, type FFIDOrganization as w, type FFIDSubscription as x, type FFIDSubscriptionContextValue as y, type FFIDAnnouncementsClientConfig as z };
+export { type FFIDMemberStatus as $, type FFIDAnnouncementsApiResponse as A, type AnnouncementListResponse as B, type FFIDAnnouncementsLogger as C, type Announcement as D, type AnnouncementStatus as E, type FFIDSubscriptionStatus as F, type AnnouncementType as G, FFIDAnnouncementBadge as H, FFIDAnnouncementList as I, type FFIDAnnouncementsError as J, type FFIDAnnouncementsErrorCode as K, type ListAnnouncementsOptions as L, type FFIDAnnouncementsServerResponse as M, type FFIDCacheConfig as N, type FFIDContextValue as O, type FFIDInquiryCategory as P, FFIDInquiryForm as Q, type FFIDInquiryFormCategoryItem as R, type FFIDInquiryFormClassNames as S, type FFIDInquiryFormOrganization as T, type FFIDInquiryFormPlaceholderContext as U, type FFIDInquiryFormPrefill as V, type FFIDInquiryFormProps as W, type FFIDInquiryFormSubmitData as X, type FFIDInquiryFormSubmitResult as Y, type FFIDJwtClaims as Z, FFIDLoginButton as _, type FFIDConfig as a, type FFIDOAuthTokenResponse as a0, type FFIDOAuthUserInfoMemberRole as a1, type FFIDOAuthUserInfoSubscription as a2, type FFIDOrganizationMember as a3, FFIDOrganizationSwitcher as a4, type FFIDSeatModel as a5, FFIDSubscriptionBadge as a6, type FFIDTokenIntrospectionResponse as a7, FFIDUserMenu as a8, FFID_INQUIRY_CATEGORIES as a9, type UseFFIDAnnouncementsOptions as aa, type UseFFIDAnnouncementsReturn as ab, useFFIDAnnouncements as ac, type FFIDAnnouncementBadgeClassNames as ad, type FFIDAnnouncementBadgeProps as ae, type FFIDAnnouncementListClassNames as af, type FFIDAnnouncementListProps as ag, type FFIDLoginButtonProps as ah, type FFIDOrganizationSwitcherClassNames as ai, type FFIDOrganizationSwitcherProps as aj, type FFIDSubscriptionBadgeClassNames as ak, type FFIDSubscriptionBadgeProps as al, type FFIDUserMenuClassNames as am, type FFIDUserMenuProps as an, type FFIDApiResponse as b, type FFIDSessionResponse as c, type FFIDRedirectResult as d, type FFIDError as e, type FFIDSubscriptionCheckResponse as f, type FFIDListMembersResponse as g, type FFIDMemberRole as h, type FFIDUpdateMemberRoleResponse as i, type FFIDRemoveMemberResponse as j, type FFIDCreateCheckoutParams as k, type FFIDCheckoutSessionResponse as l, type FFIDCreatePortalParams as m, type FFIDPortalSessionResponse as n, type FFIDVerifyAccessTokenOptions as o, type FFIDOAuthUserInfo as p, type FFIDInquiryCreateParams as q, type FFIDInquiryCreateResponse as r, type FFIDAuthMode as s, type FFIDLogger as t, type FFIDCacheAdapter as u, type FFIDUser as v, type FFIDOrganization as w, type FFIDSubscription as x, type FFIDSubscriptionContextValue as y, type FFIDAnnouncementsClientConfig as z };

package/dist/{index-BSuGxrqG.d.ts → index-BuT9VaRt.d.ts}

@@ -886,6 +886,85 @@ interface FFIDAnnouncementListProps {
  */
 declare function FFIDAnnouncementList({ announcements, isLoading, className, classNames, style, formatDate, emptyMessage, loadingRender, renderItem, maxContentLines, }: FFIDAnnouncementListProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Internals shared with the `FFIDInquiryForm` component.
+ *
+ * Split out of `FFIDInquiryForm.tsx` to keep that file under the repo's
+ * hard file-size limit. Everything exported here is part of the SDK's
+ * private surface — do NOT re-export these from `components/index.ts`.
+ * The single source of truth for consumers is `FFIDInquiryForm.tsx`.
+ */
+
+/** Category option rendered in the form select. */
+interface FFIDInquiryFormCategoryItem {
+    value: string;
+    label: string;
+    group?: string;
+    groupLabel?: string;
+}
+/**
+ * Per-slot `className` overrides. Every key is optional; when omitted,
+ * the slot falls back to SDK defaults. Intended to be combined with
+ * `unstyled={true}` for full brand styling (Tailwind / CSS-in-JS /
+ * global CSS), but also works on top of the default inline styles when
+ * `unstyled={false}` if the consumer wants to layer additional classes.
+ *
+ * Composition rules:
+ * - `form` is applied *in addition to* the top-level `className` prop
+ *   (both are space-joined on the root `<form>` and on the success
+ *   `<div role="status">`).
+ * - `readOnlyInput` is applied *in addition to* `input` on name / email
+ *   inputs in `mode='authenticated'`; it is not a standalone class.
+ * - `successBlock` is layered on top of `form` on the success view so
+ *   the wrapper stays themeable while the success-specific layer can
+ *   add its own class.
+ * - `categoryPlaceholderOption` is only rendered when
+ *   `requireCategorySelection` is true; setting it otherwise is a
+ *   silent no-op.
+ */
+interface FFIDInquiryFormClassNames {
+    /** Root `<form>` (or the success `<div role="status">`). Merges with the top-level `className` prop. */
+    form?: string;
+    /** Wrapper around each labeled input. */
+    field?: string;
+    /** `<label>` / `<legend>` elements. */
+    label?: string;
+    /** `<input>` elements for name / email / company / phone. */
+    input?: string;
+    /** Extra class added on top of `input` when the input is read-only. */
+    readOnlyInput?: string;
+    /** `<select>` elements (category + organization). */
+    select?: string;
+    /** `<textarea>` for the message body. */
+    textarea?: string;
+    /** Disabled "選択してください" option emitted when `requireCategorySelection` is true. */
+    categoryPlaceholderOption?: string;
+    /** `<fieldset>` wrapping the newsletter opt-in checkboxes. */
+    newsletterFieldset?: string;
+    /** `<legend>` of the newsletter fieldset. */
+    newsletterLegend?: string;
+    /** `<label>` row for each newsletter checkbox. */
+    newsletterRow?: string;
+    /** Each newsletter `<input type="checkbox">`. */
+    newsletterCheckbox?: string;
+    /** Wrapper around the legal agreement block. */
+    legalBlock?: string;
+    /** `<label>` row for each legal checkbox. */
+    legalRow?: string;
+    /** Each legal `<input type="checkbox">`. */
+    legalCheckbox?: string;
+    /** Terms / privacy `<a>` links rendered inline with the legal checkbox label. */
+    legalLink?: string;
+    /** `<p role="alert">` container for the form-level error message. */
+    errorText?: string;
+    /** `<button type="submit">`. */
+    submitButton?: string;
+    /** Success `<div role="status">` rendered after a successful submit. */
+    successBlock?: string;
+    /** Wrapper around the organization `<select>` (authenticated mode). */
+    orgSelectWrapper?: string;
+}
+
 /**
  * Known category literal with an escape hatch for arbitrary strings, so
  * IDE autocomplete suggests the built-in set while still accepting any
@@ -914,25 +993,14 @@ interface FFIDInquiryFormPrefill {
     /**
      * Preselected category value. Silently ignored if the value does not
      * match any entry in `categories` (or the default list when `categories`
-     * is omitted), so consumers can safely forward URL query strings.
+     * is omitted), so consumers can safely forward URL query strings. When
+     * `requireCategorySelection` is true and this is missing/invalid, the
+     * form starts with an empty selection instead of auto-choosing the
+     * first option.
      */
     category?: FFIDInquiryCategoryValue;
     message?: string;
 }
-/**
- * Category option rendered in the form select. If any item has a
- * `group` the select switches into `<optgroup>` mode; ungrouped items
- * are emitted as bare `<option>` entries before the first `<optgroup>`
- * in DOM order. Groups render in the order each `group` key first
- * appears in `categories`, and the first encountered `groupLabel` wins
- * when a `group` key repeats with inconsistent labels.
- */
-interface FFIDInquiryFormCategoryItem {
-    value: string;
-    label: string;
-    group?: string;
-    groupLabel?: string;
-}
 interface FFIDInquiryFormSubmitData {
     name: string;
     email: string;
@@ -973,18 +1041,11 @@ interface FFIDInquiryFormProps {
     onSubmit: (data: FFIDInquiryFormSubmitData) => Promise<FFIDInquiryFormSubmitResult>;
     /**
      * Called after every change to a field that is part of the submit
-     * payload (including the initial mount with prefilled values and
-     * re-fires when `termsVersion`/`privacyVersion`/`turnstileToken`/
-     * `locale` props change). Enables consumers to mirror state for
-     * URL-driven banners, analytics, or dynamic placeholders without
-     * owning the form. Consent checkboxes (`separateLegalCheckboxes` or
-     * the combined variant) are intentionally excluded — they are not
-     * part of `FFIDInquiryFormSubmitData`. Emitted values use the same
-     * normalization as `onSubmit` (string fields are trimmed; empty
-     * strings become `null` for `company` / `phone`).
-     *
-     * React StrictMode double-invokes effects in development, so expect
-     * two calls per mount in dev builds.
+     * payload. Consent checkboxes are intentionally excluded — they are
+     * not part of `FFIDInquiryFormSubmitData`. Emitted values use the
+     * same normalization as `onSubmit` (trimmed strings; empty
+     * `company`/`phone` become `null`). React StrictMode double-invokes
+     * effects in dev, so expect two calls per mount.
      */
     onChange?: (data: FFIDInquiryFormSubmitData) => void;
     /**
@@ -996,29 +1057,53 @@ interface FFIDInquiryFormProps {
     /**
      * Overrides the `<textarea>` placeholder. A plain string is applied
      * verbatim; a function is called with the currently selected category
-     * so consumers can vary the copy per selection (e.g. different hint
-     * text for "sales" vs "support"). The SDK memoizes the resolved
-     * placeholder keyed on `category` and the `messagePlaceholder`
-     * identity, so the function typically re-runs only when the user
-     * picks a different category or the prop reference changes — keep it
-     * cheap and pure so that contract is safe to rely on.
-     *
-     * When omitted, no `placeholder` attribute is emitted (SDK ≤ 2.9
-     * behavior).
+     * so consumers can vary the copy per selection. Memoized on the
+     * resolved `category` + `messagePlaceholder` identity. Omitting the
+     * prop leaves the textarea with no `placeholder` attribute.
      */
     messagePlaceholder?: string | ((ctx: FFIDInquiryFormPlaceholderContext) => string);
+    /**
+     * When true, the category `<select>` starts empty (unless `prefill.category`
+     * resolves to a valid option) and renders a disabled "選択してください"
+     * placeholder as the first option. Submits are blocked with an error
+     * message until the user explicitly picks a category. Default `false`
+     * preserves the SDK ≤ 2.10 behavior of auto-selecting the first option.
+     *
+     * Use this when the downstream routing depends on an intentional
+     * category choice — the default auto-selection silently misclassifies
+     * inquiries from users who never interacted with the dropdown.
+     */
+    requireCategorySelection?: boolean;
+    /**
+     * When true, drops every inline `style` attribute the SDK adds.
+     * Structural attributes (`required`, `readOnly`, `noValidate`, `role`,
+     * `data-hydrated`, …) are kept so keyboard / screen-reader semantics
+     * are unchanged. Pair with `classNames` for fully branded rendering.
+     * Default `false` keeps the inline-styled defaults from SDK ≤ 2.10.
+     */
+    unstyled?: boolean;
+    /**
+     * Per-slot `className` overrides. See `FFIDInquiryFormClassNames` for
+     * the full list of slots. Classes apply **in addition to** any inline
+     * `style` the SDK emits unless `unstyled={true}`.
+     */
+    classNames?: FFIDInquiryFormClassNames;
     locale?: 'ja' | 'en';
+    /**
+     * Additional class for the root `<form>` (or the success `<div>`).
+     * Kept for backward compatibility with SDK ≤ 2.10; merges with
+     * `classNames.form` when both are provided.
+     */
     className?: string;
 }
 /**
- * Context passed to a function-form `messagePlaceholder`. `category` is
- * typed `string | null` so a future unselected-state can be introduced
- * without breaking consumers, even though the current form always has a
- * non-null category value selected.
+ * Context passed to a function-form `messagePlaceholder`. When
+ * `requireCategorySelection` is true and nothing is selected yet, the
+ * form passes `null` here.
  */
 interface FFIDInquiryFormPlaceholderContext {
     category: string | null;
 }
-declare function FFIDInquiryForm({ mode, prefill, organizations, preselectedOrganizationId, categories, termsVersion, privacyVersion, termsHref, privacyHref, turnstileToken, turnstileSlot, onSubmit, onChange, separateLegalCheckboxes, messagePlaceholder, locale, className, }: FFIDInquiryFormProps): react_jsx_runtime.JSX.Element;
+declare function FFIDInquiryForm({ mode, prefill, organizations, preselectedOrganizationId, categories, termsVersion, privacyVersion, termsHref, privacyHref, turnstileToken, turnstileSlot, onSubmit, onChange, separateLegalCheckboxes, messagePlaceholder, requireCategorySelection, unstyled, classNames, locale, className, }: FFIDInquiryFormProps): react_jsx_runtime.JSX.Element;
 
-export { type FFIDOAuthTokenResponse as $, type FFIDAnnouncementsApiResponse as A, type AnnouncementListResponse as B, type FFIDAnnouncementsLogger as C, type Announcement as D, type AnnouncementStatus as E, type FFIDSubscriptionStatus as F, type AnnouncementType as G, FFIDAnnouncementBadge as H, FFIDAnnouncementList as I, type FFIDAnnouncementsError as J, type FFIDAnnouncementsErrorCode as K, type ListAnnouncementsOptions as L, type FFIDAnnouncementsServerResponse as M, type FFIDCacheConfig as N, type FFIDContextValue as O, type FFIDInquiryCategory as P, FFIDInquiryForm as Q, type FFIDInquiryFormCategoryItem as R, type FFIDInquiryFormOrganization as S, type FFIDInquiryFormPlaceholderContext as T, type FFIDInquiryFormPrefill as U, type FFIDInquiryFormProps as V, type FFIDInquiryFormSubmitData as W, type FFIDInquiryFormSubmitResult as X, type FFIDJwtClaims as Y, FFIDLoginButton as Z, type FFIDMemberStatus as _, type FFIDConfig as a, type FFIDOAuthUserInfoMemberRole as a0, type FFIDOAuthUserInfoSubscription as a1, type FFIDOrganizationMember as a2, FFIDOrganizationSwitcher as a3, type FFIDSeatModel as a4, FFIDSubscriptionBadge as a5, type FFIDTokenIntrospectionResponse as a6, FFIDUserMenu as a7, FFID_INQUIRY_CATEGORIES as a8, type UseFFIDAnnouncementsOptions as a9, type UseFFIDAnnouncementsReturn as aa, useFFIDAnnouncements as ab, type FFIDAnnouncementBadgeClassNames as ac, type FFIDAnnouncementBadgeProps as ad, type FFIDAnnouncementListClassNames as ae, type FFIDAnnouncementListProps as af, type FFIDLoginButtonProps as ag, type FFIDOrganizationSwitcherClassNames as ah, type FFIDOrganizationSwitcherProps as ai, type FFIDSubscriptionBadgeClassNames as aj, type FFIDSubscriptionBadgeProps as ak, type FFIDUserMenuClassNames as al, type FFIDUserMenuProps as am, type FFIDApiResponse as b, type FFIDSessionResponse as c, type FFIDRedirectResult as d, type FFIDError as e, type FFIDSubscriptionCheckResponse as f, type FFIDListMembersResponse as g, type FFIDMemberRole as h, type FFIDUpdateMemberRoleResponse as i, type FFIDRemoveMemberResponse as j, type FFIDCreateCheckoutParams as k, type FFIDCheckoutSessionResponse as l, type FFIDCreatePortalParams as m, type FFIDPortalSessionResponse as n, type FFIDVerifyAccessTokenOptions as o, type FFIDOAuthUserInfo as p, type FFIDInquiryCreateParams as q, type FFIDInquiryCreateResponse as r, type FFIDAuthMode as s, type FFIDLogger as t, type FFIDCacheAdapter as u, type FFIDUser as v, type FFIDOrganization as w, type FFIDSubscription as x, type FFIDSubscriptionContextValue as y, type FFIDAnnouncementsClientConfig as z };
+export { type FFIDMemberStatus as $, type FFIDAnnouncementsApiResponse as A, type AnnouncementListResponse as B, type FFIDAnnouncementsLogger as C, type Announcement as D, type AnnouncementStatus as E, type FFIDSubscriptionStatus as F, type AnnouncementType as G, FFIDAnnouncementBadge as H, FFIDAnnouncementList as I, type FFIDAnnouncementsError as J, type FFIDAnnouncementsErrorCode as K, type ListAnnouncementsOptions as L, type FFIDAnnouncementsServerResponse as M, type FFIDCacheConfig as N, type FFIDContextValue as O, type FFIDInquiryCategory as P, FFIDInquiryForm as Q, type FFIDInquiryFormCategoryItem as R, type FFIDInquiryFormClassNames as S, type FFIDInquiryFormOrganization as T, type FFIDInquiryFormPlaceholderContext as U, type FFIDInquiryFormPrefill as V, type FFIDInquiryFormProps as W, type FFIDInquiryFormSubmitData as X, type FFIDInquiryFormSubmitResult as Y, type FFIDJwtClaims as Z, FFIDLoginButton as _, type FFIDConfig as a, type FFIDOAuthTokenResponse as a0, type FFIDOAuthUserInfoMemberRole as a1, type FFIDOAuthUserInfoSubscription as a2, type FFIDOrganizationMember as a3, FFIDOrganizationSwitcher as a4, type FFIDSeatModel as a5, FFIDSubscriptionBadge as a6, type FFIDTokenIntrospectionResponse as a7, FFIDUserMenu as a8, FFID_INQUIRY_CATEGORIES as a9, type UseFFIDAnnouncementsOptions as aa, type UseFFIDAnnouncementsReturn as ab, useFFIDAnnouncements as ac, type FFIDAnnouncementBadgeClassNames as ad, type FFIDAnnouncementBadgeProps as ae, type FFIDAnnouncementListClassNames as af, type FFIDAnnouncementListProps as ag, type FFIDLoginButtonProps as ah, type FFIDOrganizationSwitcherClassNames as ai, type FFIDOrganizationSwitcherProps as aj, type FFIDSubscriptionBadgeClassNames as ak, type FFIDSubscriptionBadgeProps as al, type FFIDUserMenuClassNames as am, type FFIDUserMenuProps as an, type FFIDApiResponse as b, type FFIDSessionResponse as c, type FFIDRedirectResult as d, type FFIDError as e, type FFIDSubscriptionCheckResponse as f, type FFIDListMembersResponse as g, type FFIDMemberRole as h, type FFIDUpdateMemberRoleResponse as i, type FFIDRemoveMemberResponse as j, type FFIDCreateCheckoutParams as k, type FFIDCheckoutSessionResponse as l, type FFIDCreatePortalParams as m, type FFIDPortalSessionResponse as n, type FFIDVerifyAccessTokenOptions as o, type FFIDOAuthUserInfo as p, type FFIDInquiryCreateParams as q, type FFIDInquiryCreateResponse as r, type FFIDAuthMode as s, type FFIDLogger as t, type FFIDCacheAdapter as u, type FFIDUser as v, type FFIDOrganization as w, type FFIDSubscription as x, type FFIDSubscriptionContextValue as y, type FFIDAnnouncementsClientConfig as z };

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk55KLWKM7_cjs = require('./chunk-55KLWKM7.cjs');
+var chunk5ZMR3NNO_cjs = require('./chunk-5ZMR3NNO.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -46,7 +46,7 @@ function createKVCacheAdapter(kv) {
 }
 function withFFIDAuth(Component, options = {}) {
   const WrappedComponent = (props) => {
-    const { isLoading, isAuthenticated, login } = chunk55KLWKM7_cjs.useFFIDContext();
+    const { isLoading, isAuthenticated, login } = chunk5ZMR3NNO_cjs.useFFIDContext();
     const hasRedirected = react.useRef(false);
     react.useEffect(() => {
       if (!isLoading && !isAuthenticated && options.redirectToLogin && !hasRedirected.current) {
@@ -74,91 +74,95 @@ var FFID_NEWSLETTER_TYPES = ["inquiry_followup", "general"];
 
 Object.defineProperty(exports, "DEFAULT_API_BASE_URL", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.DEFAULT_API_BASE_URL; }
+  get: function () { return chunk5ZMR3NNO_cjs.DEFAULT_API_BASE_URL; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementBadge", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.FFIDAnnouncementBadge; }
+  get: function () { return chunk5ZMR3NNO_cjs.FFIDAnnouncementBadge; }
 });
 Object.defineProperty(exports, "FFIDAnnouncementList", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.FFIDAnnouncementList; }
+  get: function () { return chunk5ZMR3NNO_cjs.FFIDAnnouncementList; }
 });
 Object.defineProperty(exports, "FFIDInquiryForm", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.FFIDInquiryForm; }
+  get: function () { return chunk5ZMR3NNO_cjs.FFIDInquiryForm; }
 });
 Object.defineProperty(exports, "FFIDLoginButton", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.FFIDLoginButton; }
+  get: function () { return chunk5ZMR3NNO_cjs.FFIDLoginButton; }
 });
 Object.defineProperty(exports, "FFIDOrganizationSwitcher", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.FFIDOrganizationSwitcher; }
+  get: function () { return chunk5ZMR3NNO_cjs.FFIDOrganizationSwitcher; }
 });
 Object.defineProperty(exports, "FFIDProvider", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.FFIDProvider; }
+  get: function () { return chunk5ZMR3NNO_cjs.FFIDProvider; }
+});
+Object.defineProperty(exports, "FFIDSDKError", {
+  enumerable: true,
+  get: function () { return chunk5ZMR3NNO_cjs.FFIDSDKError; }
 });
 Object.defineProperty(exports, "FFIDSubscriptionBadge", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.FFIDSubscriptionBadge; }
+  get: function () { return chunk5ZMR3NNO_cjs.FFIDSubscriptionBadge; }
 });
 Object.defineProperty(exports, "FFIDUserMenu", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.FFIDUserMenu; }
+  get: function () { return chunk5ZMR3NNO_cjs.FFIDUserMenu; }
 });
 Object.defineProperty(exports, "FFID_ANNOUNCEMENTS_ERROR_CODES", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
+  get: function () { return chunk5ZMR3NNO_cjs.FFID_ANNOUNCEMENTS_ERROR_CODES; }
 });
 Object.defineProperty(exports, "FFID_INQUIRY_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.FFID_INQUIRY_CATEGORIES; }
+  get: function () { return chunk5ZMR3NNO_cjs.FFID_INQUIRY_CATEGORIES; }
 });
 Object.defineProperty(exports, "createFFIDAnnouncementsClient", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.createFFIDAnnouncementsClient; }
+  get: function () { return chunk5ZMR3NNO_cjs.createFFIDAnnouncementsClient; }
 });
 Object.defineProperty(exports, "createFFIDClient", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.createFFIDClient; }
+  get: function () { return chunk5ZMR3NNO_cjs.createFFIDClient; }
 });
 Object.defineProperty(exports, "createTokenStore", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.createTokenStore; }
+  get: function () { return chunk5ZMR3NNO_cjs.createTokenStore; }
 });
 Object.defineProperty(exports, "generateCodeChallenge", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.generateCodeChallenge; }
+  get: function () { return chunk5ZMR3NNO_cjs.generateCodeChallenge; }
 });
 Object.defineProperty(exports, "generateCodeVerifier", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.generateCodeVerifier; }
+  get: function () { return chunk5ZMR3NNO_cjs.generateCodeVerifier; }
 });
 Object.defineProperty(exports, "retrieveCodeVerifier", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.retrieveCodeVerifier; }
+  get: function () { return chunk5ZMR3NNO_cjs.retrieveCodeVerifier; }
 });
 Object.defineProperty(exports, "storeCodeVerifier", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.storeCodeVerifier; }
+  get: function () { return chunk5ZMR3NNO_cjs.storeCodeVerifier; }
 });
 Object.defineProperty(exports, "useFFID", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.useFFID; }
+  get: function () { return chunk5ZMR3NNO_cjs.useFFID; }
 });
 Object.defineProperty(exports, "useFFIDAnnouncements", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.useFFIDAnnouncements; }
+  get: function () { return chunk5ZMR3NNO_cjs.useFFIDAnnouncements; }
 });
 Object.defineProperty(exports, "useSubscription", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.useSubscription; }
+  get: function () { return chunk5ZMR3NNO_cjs.useSubscription; }
 });
 Object.defineProperty(exports, "withSubscription", {
   enumerable: true,
-  get: function () { return chunk55KLWKM7_cjs.withSubscription; }
+  get: function () { return chunk5ZMR3NNO_cjs.withSubscription; }
 });
 exports.FFID_NEWSLETTER_TYPES = FFID_NEWSLETTER_TYPES;
 exports.createKVCacheAdapter = createKVCacheAdapter;