@alfadocs/ui-kit-debug 1.39.0 → 1.41.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfadocs/ui-kit-debug",
-  "version": "1.39.0",
+  "version": "1.41.0",
   "type": "module",
   "description": "AlfaDocs shared design system — tokens, components, patterns, and translations for platform, booking, and alfascribe. (debug build — identical runtime to @alfadocs/ui-kit, ships source maps for symbolication).",
   "license": "BUSL-1.1",
@@ -817,6 +817,10 @@
       "types": "./dist/patterns/calendar/index.d.ts",
       "import": "./dist/patterns/calendar/index.js"
     },
+    "./patterns/help-me-write-templates": {
+      "types": "./dist/patterns/help-me-write-templates/index.d.ts",
+      "import": "./dist/patterns/help-me-write-templates/index.js"
+    },
     "./patterns/marketplace-app-shell": {
       "types": "./dist/patterns/marketplace-app-shell/index.d.ts",
       "import": "./dist/patterns/marketplace-app-shell/index.js"

package/dist/_chunks/ai-consent-banner-DvtaM3yg.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ai-consent-banner-DvtaM3yg.js","sources":["../../src/components/ai-consent-banner/ai-consent-banner.agent.ts","../../src/components/ai-consent-banner/ai-consent-banner.tsx"],"sourcesContent":["/* -------------------------------------------------------------------- */\n/* Agent adapter — AiConsentBanner.                                       */\n/*                                                                        */\n/* Read-only structural surface: the current consent state and whether   */\n/* the grant affordance is armed. Identifiers / structural state ONLY —   */\n/* never the grantee's name or any PHI. The real consent gate lives       */\n/* server-side; this adapter does not expose a grant action so an agent   */\n/* cannot consent on a user's behalf.                                     */\n/* -------------------------------------------------------------------- */\n\nimport type { AgentAdapter } from '../../agent/types';\nimport type { AiConsentBannerHandle } from './ai-consent-banner';\n\nexport const aiConsentBannerAgent: AgentAdapter<AiConsentBannerHandle> = {\n  id: 'ai-consent-banner',\n  capabilities: [],\n  state: {\n    consentState: {\n      type: \"'granted' | 'required' | 'pending'\",\n      descriptionKey: 'ui.agent.aiConsentBanner.state.consentState',\n      description:\n        'Current consent state. Structural only — never the grantee identity.',\n      read: (handle) => handle.getState(),\n    },\n    armed: {\n      type: 'boolean',\n      descriptionKey: 'ui.agent.aiConsentBanner.state.armed',\n      description:\n        'Whether the consent confirmation checkbox is ticked (required state only).',\n      read: (handle) => handle.isArmed(),\n    },\n  },\n  actions: {},\n  domHooks: {\n    root: {\n      attr: 'data-component',\n      value: 'ai-consent-banner',\n      description: 'Marks the AiConsentBanner root region.',\n    },\n    instanceId: {\n      attr: 'data-component-id',\n      sourceProp: 'id',\n      description:\n        'Sourced from the id prop. Required to address a specific banner from the agent.',\n    },\n  },\n};\n","import {\n  forwardRef,\n  useMemo,\n  useRef,\n  useState,\n  type ComponentPropsWithoutRef,\n} from 'react';\nimport { cva, type VariantProps } from 'class-variance-authority';\nimport { useTranslation } from 'react-i18next';\nimport { Alert } from '../alert/alert';\nimport { Badge } from '../badge/badge';\nimport { Button } from '../button/button';\nimport { Checkbox } from '../checkbox/checkbox';\nimport { Spinner } from '../spinner/spinner';\nimport { Timestamp } from '../timestamp/timestamp';\nimport { useAgentRegistration } from '../../agent/registry';\nimport { aiConsentBannerAgent } from './ai-consent-banner.agent';\n\n/* -------------------------------------------------------------------- */\n/* AiConsentBanner                                                        */\n/*                                                                        */\n/* Presentational AI-consent gate surfaced above an AI-assisted surface  */\n/* (e.g. Alfascribe consultation transcription). The SERVER owns the     */\n/* real gate — this component only reflects the consent record and lets  */\n/* the operator initiate a grant; it never enforces access itself.       */\n/*                                                                        */\n/* Three states drive the Alert variant + body:                          */\n/*   - granted  → success Alert with a Badge + when/who it was granted.  */\n/*   - required → info Alert with a Checkbox-gated Grant Button.         */\n/*   - pending  → info Alert in a disabled, Spinner-busy state while the */\n/*                server persists the grant.                             */\n/*                                                                        */\n/* All visible text flows through useTranslation('ui') against the       */\n/* `aiConsentBanner.*` namespace.                                        */\n/* -------------------------------------------------------------------- */\n\n/* -------------------------------------------------------------------- */\n/* CVA — root                                                            */\n/* -------------------------------------------------------------------- */\n\nconst rootVariants = cva('ds:w-full ds:text-[color:var(--foreground)]', {\n  variants: {\n    state: {\n      granted: '',\n      required: '',\n      pending: '',\n    },\n  },\n  defaultVariants: {\n    state: 'required',\n  },\n});\n\n/* -------------------------------------------------------------------- */\n/* State derivation                                                      */\n/* -------------------------------------------------------------------- */\n\nexport type AiConsentState = NonNullable<\n  VariantProps<typeof rootVariants>['state']\n>;\n\n/** Pending wins over granted/required so the busy state is never masked. */\nfunction deriveState(granted: boolean, pending: boolean): AiConsentState {\n  if (pending) return 'pending';\n  return granted ? 'granted' : 'required';\n}\n\n/* -------------------------------------------------------------------- */\n/* Public types                                                          */\n/* -------------------------------------------------------------------- */\n\n/** Agent-readiness curated handle. Exposes the structural consent state only. */\nexport interface AiConsentBannerHandle {\n  /** Current derived state: 'granted' | 'required' | 'pending'. */\n  getState: () => AiConsentState;\n  /** Whether the Grant affordance is currently armed (checkbox ticked). */\n  isArmed: () => boolean;\n}\n\nexport interface AiConsentBannerProps extends Omit<\n  ComponentPropsWithoutRef<'div'>,\n  'aria-label' | 'children' | 'role'\n> {\n  /**\n   * Stable instance id. Surfaced on the root as `data-component-id` so an\n   * agent / MCP UI bridge can address this specific banner. Mirrored to the\n   * real DOM `id`.\n   */\n  id?: string;\n  /** Whether consent has already been granted. Server-sourced. */\n  granted: boolean;\n  /**\n   * When consent was granted — ISO-8601 string, ms-epoch, or Date. Rendered\n   * via `Timestamp` in the granted state.\n   */\n  grantedAt?: string | number | Date;\n  /** Who granted consent (operator display name / role). Granted state only. */\n  grantedBy?: string;\n  /**\n   * Whether the current user is allowed to grant consent. When `false`, the\n   * required-state Grant affordance is hidden and a not-allowed note shows.\n   * Default `true`.\n   */\n  canGrant?: boolean;\n  /** The grant is being persisted server-side — shows the busy Spinner state. */\n  pending?: boolean;\n  /** Fired when the operator confirms the consent grant. */\n  onGrantConsent?: () => void;\n  /** Override the region's accessible name. */\n  'aria-label'?: string;\n}\n\n/* -------------------------------------------------------------------- */\n/* Component                                                             */\n/* -------------------------------------------------------------------- */\n\nexport const AiConsentBanner = forwardRef<HTMLDivElement, AiConsentBannerProps>(\n  (\n    {\n      id,\n      granted,\n      grantedAt,\n      grantedBy,\n      canGrant = true,\n      pending = false,\n      onGrantConsent,\n      'aria-label': ariaLabel,\n      className,\n      ...rest\n    },\n    ref,\n  ) => {\n    const { t } = useTranslation();\n    const state = deriveState(granted, pending);\n\n    // Local arm switch — the required state gates the Grant Button behind an\n    // explicit \"I understand\" checkbox so consent is never one mis-click away.\n    const [armed, setArmed] = useState(false);\n\n    const armedRef = useRef(armed);\n    armedRef.current = armed;\n\n    const handle = useMemo<AiConsentBannerHandle>(\n      () => ({\n        getState: () => deriveState(granted, pending),\n        isArmed: () => armedRef.current,\n      }),\n      [granted, pending],\n    );\n    useAgentRegistration(aiConsentBannerAgent, handle, id);\n\n    const resolvedAriaLabel =\n      ariaLabel ?? t('aiConsentBanner.regionLabel', 'AI assistance consent');\n\n    // Alert variant per state: granted → success, required/pending → info.\n    const alertVariant = state === 'granted' ? 'success' : 'info';\n\n    let body: React.ReactNode;\n    if (state === 'granted') {\n      body = (\n        <div className=\"ds:flex ds:flex-col ds:gap-[var(--spacing-xs)]\">\n          <div className=\"ds:flex ds:flex-wrap ds:items-center ds:gap-[var(--spacing-sm)]\">\n            <Badge variant=\"success\">\n              {t('aiConsentBanner.badge.granted', 'Consent granted')}\n            </Badge>\n            {grantedAt !== undefined ? (\n              <span className=\"type-body-sm ds:text-[color:var(--muted-foreground)]\">\n                {t('aiConsentBanner.grantedAtPrefix', 'Granted')}{' '}\n                <Timestamp value={grantedAt} format=\"relative\" shape=\"inline\" />\n              </span>\n            ) : null}\n          </div>\n          {grantedBy ? (\n            <p className=\"type-body-sm ds:m-0 ds:text-[color:var(--muted-foreground)]\">\n              {t('aiConsentBanner.grantedBy', {\n                name: grantedBy,\n                defaultValue: 'By {{name}}',\n              })}\n            </p>\n          ) : null}\n        </div>\n      );\n    } else if (state === 'pending') {\n      body = (\n        <div className=\"ds:flex ds:items-center ds:gap-[var(--spacing-sm)]\">\n          <Spinner\n            variant=\"pulse\"\n            size=\"sm\"\n            label={t('aiConsentBanner.pendingLabel', 'Saving consent…')}\n          />\n          <span className=\"type-body-sm ds:text-[color:var(--muted-foreground)]\">\n            {t('aiConsentBanner.pendingLabel', 'Saving consent…')}\n          </span>\n        </div>\n      );\n    } else {\n      // required\n      body = canGrant ? (\n        <div className=\"ds:flex ds:flex-col ds:gap-[var(--spacing-sm)]\">\n          <Checkbox\n            checked={armed}\n            onCheckedChange={(next) => setArmed(next === true)}\n            label={t(\n              'aiConsentBanner.confirmLabel',\n              'I confirm consent has been obtained for AI assistance.',\n            )}\n          />\n          <Alert.Action>\n            <Button\n              intent=\"primary\"\n              size=\"sm\"\n              disabled={!armed}\n              onClick={onGrantConsent}\n            >\n              {t('aiConsentBanner.grantButton', 'Grant consent')}\n            </Button>\n          </Alert.Action>\n        </div>\n      ) : (\n        <p className=\"type-body-sm ds:m-0 ds:text-[color:var(--muted-foreground)]\">\n          {t(\n            'aiConsentBanner.notAllowed',\n            'You do not have permission to grant AI assistance consent.',\n          )}\n        </p>\n      );\n    }\n\n    return (\n      <div\n        ref={ref}\n        role=\"region\"\n        aria-label={resolvedAriaLabel}\n        aria-busy={state === 'pending' ? true : undefined}\n        data-component=\"ai-consent-banner\"\n        data-component-id={id}\n        data-state={state}\n        id={id}\n        className={rootVariants({ state, className })}\n        {...rest}\n      >\n        <Alert\n          variant={alertVariant}\n          icon={state === 'pending' ? null : undefined}\n        >\n          <Alert.Title>\n            {t('aiConsentBanner.title', 'AI assistance consent')}\n          </Alert.Title>\n          <Alert.Description>\n            {state === 'granted'\n              ? t(\n                  'aiConsentBanner.description.granted',\n                  'AI assistance is enabled for this record.',\n                )\n              : t(\n                  'aiConsentBanner.description.required',\n                  'AI assistance requires recorded consent before it can run.',\n                )}\n          </Alert.Description>\n          {body}\n        </Alert>\n      </div>\n    );\n  },\n);\n\nAiConsentBanner.displayName = 'AiConsentBanner';\n"],"names":["aiConsentBannerAgent","handle","rootVariants","cva","deriveState","granted","pending","AiConsentBanner","forwardRef","id","grantedAt","grantedBy","canGrant","onGrantConsent","ariaLabel","className","rest","ref","t","useTranslation","state","armed","setArmed","useState","armedRef","useRef","useMemo","useAgentRegistration","resolvedAriaLabel","alertVariant","body","jsxs","jsx","Badge","Timestamp","Spinner","Checkbox","next","Alert","Button"],"mappings":"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"}