@ankhorage/zora 12.0.0 → 12.1.0

package/src/features/auth/oauthProviderButtonMeta.ts

@@ -0,0 +1,62 @@
+import { ZORA_COLORS } from '../../internal/colorModel';
+import type { ZoraComponentMeta } from '../../metadata';
+
+export const oauthProviderButtonMeta = {
+  name: 'OAuthProviderButton',
+  category: 'pattern',
+  description: 'Renders a provider-branded OAuth action button.',
+  directManifestNode: true,
+  allowedChildren: [],
+  blueprint: {
+    label: 'OAuth provider button',
+    defaultProps: {
+      providerId: 'google',
+      fullWidth: true,
+      size: 'l',
+      variant: 'outline',
+      color: 'neutral',
+      loading: false,
+      disabled: false,
+    },
+  },
+  events: {
+    press: {
+      label: 'Press',
+      eventType: 'oauthProviderButton.press',
+      payloadFields: [{ path: 'providerId', type: 'string', label: 'Provider ID' }],
+    },
+  },
+  props: {
+    providerId: {
+      type: 'string',
+      category: 'Authentication',
+      label: 'Provider ID',
+      default: 'google',
+    },
+    label: { type: 'string', category: 'Content', label: 'Label' },
+    disabled: { type: 'boolean', category: 'State', label: 'Disabled', default: false },
+    loading: { type: 'boolean', category: 'State', label: 'Loading', default: false },
+    fullWidth: { type: 'boolean', category: 'Layout', label: 'Full width', default: true },
+    size: {
+      type: 'enum',
+      category: 'Style',
+      label: 'Size',
+      enum: ['s', 'm', 'l'],
+      default: 'l',
+    },
+    variant: {
+      type: 'enum',
+      category: 'Style',
+      label: 'Variant',
+      enum: ['solid', 'outline', 'ghost', 'soft'],
+      default: 'outline',
+    },
+    color: {
+      type: 'enum',
+      category: 'Style',
+      label: 'Color',
+      enum: [...ZORA_COLORS],
+      default: 'neutral',
+    },
+  },
+} as const satisfies ZoraComponentMeta;

package/src/features/auth/oauthProviderListMeta.ts

@@ -0,0 +1,67 @@
+import { ZORA_COLORS } from '../../internal/colorModel';
+import type { ZoraComponentMeta } from '../../metadata';
+
+export const oauthProviderListMeta = {
+  name: 'OAuthProviderList',
+  category: 'pattern',
+  description: 'Renders a configurable group of OAuth provider actions.',
+  directManifestNode: true,
+  allowedChildren: [],
+  blueprint: {
+    label: 'OAuth provider list',
+    defaultProps: {
+      providers: [{ id: 'google', label: 'Continue with Google' }],
+      layout: 'stack',
+      loading: false,
+      disabled: false,
+    },
+  },
+  events: {
+    providerPress: {
+      label: 'Provider press',
+      eventType: 'oauthProviderList.providerPress',
+      payloadFields: [{ path: 'providerId', type: 'string', label: 'Provider ID' }],
+    },
+  },
+  props: {
+    providers: {
+      type: 'array',
+      category: 'Authentication',
+      label: 'Providers',
+      itemSchema: [
+        { key: 'id', schema: { type: 'string', category: 'Identity', label: 'Provider ID' } },
+        { key: 'label', schema: { type: 'string', category: 'Content', label: 'Label' } },
+        { key: 'disabled', schema: { type: 'boolean', category: 'State', label: 'Disabled' } },
+        { key: 'loading', schema: { type: 'boolean', category: 'State', label: 'Loading' } },
+      ],
+    },
+    disabled: { type: 'boolean', category: 'State', label: 'Disabled', default: false },
+    loading: { type: 'boolean', category: 'State', label: 'Loading', default: false },
+    fullWidth: { type: 'boolean', category: 'Layout', label: 'Full width' },
+    layout: {
+      type: 'enum',
+      category: 'Layout',
+      label: 'Layout',
+      enum: ['stack', 'inline'],
+      default: 'stack',
+    },
+    size: {
+      type: 'enum',
+      category: 'Style',
+      label: 'Size',
+      enum: ['s', 'm', 'l'],
+    },
+    variant: {
+      type: 'enum',
+      category: 'Style',
+      label: 'Variant',
+      enum: ['solid', 'outline', 'ghost', 'soft'],
+    },
+    color: {
+      type: 'enum',
+      category: 'Style',
+      label: 'Color',
+      enum: [...ZORA_COLORS],
+    },
+  },
+} as const satisfies ZoraComponentMeta;

package/src/features/auth/otpFormMeta.ts

@@ -0,0 +1,55 @@
+import type { ZoraComponentMeta } from '../../metadata';
+
+export const otpFormMeta = {
+  name: 'OtpForm',
+  category: 'pattern',
+  description: 'Collects and verifies a one-time passcode with an optional resend action.',
+  directManifestNode: true,
+  allowedChildren: [],
+  blueprint: {
+    label: 'OTP form',
+    defaultProps: {
+      length: 6,
+      otpLabel: 'Code',
+      resendLabel: 'Resend code',
+      submitLabel: 'Verify code',
+      resendDisabled: false,
+      resendLoading: false,
+      loading: false,
+      disabled: false,
+    },
+  },
+  events: {
+    submit: {
+      label: 'Submit',
+      eventType: 'otpForm.submit',
+      payloadFields: [{ path: 'otp', type: 'string', label: 'One-time passcode' }],
+    },
+    resend: {
+      label: 'Resend',
+      eventType: 'otpForm.resend',
+      payloadFields: [],
+    },
+  },
+  props: {
+    length: { type: 'number', category: 'Validation', label: 'Code length', default: 6 },
+    otpLabel: { type: 'string', category: 'Content', label: 'Code label' },
+    resendLabel: { type: 'string', category: 'Content', label: 'Resend label' },
+    submitLabel: { type: 'string', category: 'Content', label: 'Submit label' },
+    error: { type: 'string', category: 'State', label: 'Error' },
+    resendDisabled: {
+      type: 'boolean',
+      category: 'State',
+      label: 'Resend disabled',
+      default: false,
+    },
+    resendLoading: {
+      type: 'boolean',
+      category: 'State',
+      label: 'Resend loading',
+      default: false,
+    },
+    loading: { type: 'boolean', category: 'State', label: 'Loading', default: false },
+    disabled: { type: 'boolean', category: 'State', label: 'Disabled', default: false },
+  },
+} as const satisfies ZoraComponentMeta;

package/src/features/auth/public.test.ts

@@ -0,0 +1,34 @@
+import { expect, test } from 'bun:test';
+
+import { ZORA_COMPONENT_META } from '../../metadata/componentMeta';
+
+const AUTH_MANIFEST_ELEMENTS = [
+  'ForgotPasswordForm',
+  'OAuthProviderButton',
+  'OAuthProviderList',
+  'OtpForm',
+  'SignInForm',
+  'SignUpForm',
+] as const;
+const authMetaByName = new Map(Object.entries(ZORA_COMPONENT_META));
+
+test('auth solutions are direct manifest leaf nodes with authoring schemas', () => {
+  for (const name of AUTH_MANIFEST_ELEMENTS) {
+    const meta = authMetaByName.get(name);
+    expect(meta?.directManifestNode, name).toBe(true);
+    expect(meta?.allowedChildren, name).toEqual([]);
+    expect(Object.keys(meta?.props ?? {}).length, name).toBeGreaterThan(0);
+  }
+});
+
+test('auth solution events expose their actionable boundaries', () => {
+  expect(ZORA_COMPONENT_META.SignInForm?.events?.submit?.payloadFields).toContainEqual({
+    path: 'secret',
+    type: 'string',
+    label: 'Secret',
+  });
+  expect(ZORA_COMPONENT_META.OtpForm?.events?.resend?.eventType).toBe('otpForm.resend');
+  expect(ZORA_COMPONENT_META.OAuthProviderList?.events?.providerPress?.payloadFields).toEqual([
+    { path: 'providerId', type: 'string', label: 'Provider ID' },
+  ]);
+});

package/src/{patterns/auth/index.ts → features/auth/public.ts}

@@ -1,14 +1,3 @@
-export { ForgotPasswordForm } from './ForgotPasswordForm';
-export { OAuthProviderButton } from './OAuthProviderButton';
-export { OAuthProviderList } from './OAuthProviderList';
-export {
-  DEFAULT_OAUTH_PROVIDER_ICONS,
-  resolveOAuthProviderIcon,
-  resolveOAuthProviderLabel,
-} from './oauthProviders';
-export { OtpForm } from './OtpForm';
-export { SignInForm } from './SignInForm';
-export { SignUpForm } from './SignUpForm';
 export type {
   AuthFormBaseProps,
   AuthIdentifierKind,
@@ -26,4 +15,15 @@ export type {
   SignUpFormField,
   SignUpFormProps,
   SignUpFormValues,
-} from './types';
+} from '../../types/auth';
+export { ForgotPasswordForm } from './adapters/inbound/ForgotPasswordForm';
+export { OAuthProviderButton } from './adapters/inbound/OAuthProviderButton';
+export { OAuthProviderList } from './adapters/inbound/OAuthProviderList';
+export { OtpForm } from './adapters/inbound/OtpForm';
+export { SignInForm } from './adapters/inbound/SignInForm';
+export { SignUpForm } from './adapters/inbound/SignUpForm';
+export {
+  DEFAULT_OAUTH_PROVIDER_ICONS,
+  resolveOAuthProviderIcon,
+  resolveOAuthProviderLabel,
+} from './utils/oauthProviders';

package/src/features/auth/signInFormMeta.ts

@@ -0,0 +1,63 @@
+import type { ZoraComponentMeta } from '../../metadata';
+
+export const signInFormMeta = {
+  name: 'SignInForm',
+  category: 'pattern',
+  description: 'Collects an account identifier and secret for sign-in.',
+  directManifestNode: true,
+  allowedChildren: [],
+  blueprint: {
+    label: 'Sign-in form',
+    defaultProps: {
+      identifiers: ['email'],
+      identifierLabel: 'Email',
+      secretLabel: 'Password',
+      forgotPasswordLabel: 'Forgot password',
+      signUpLabel: 'Sign up',
+      submitLabel: 'Sign in',
+      loading: false,
+      disabled: false,
+    },
+  },
+  events: {
+    submit: {
+      label: 'Submit',
+      eventType: 'signInForm.submit',
+      payloadFields: [
+        { path: 'identifier', type: 'string', label: 'Identifier' },
+        { path: 'identifierKind', type: 'string', label: 'Identifier kind' },
+        { path: 'secret', type: 'string', label: 'Secret' },
+      ],
+    },
+    forgotPassword: {
+      label: 'Forgot password',
+      eventType: 'signInForm.forgotPassword',
+      payloadFields: [],
+    },
+    signUp: {
+      label: 'Sign up',
+      eventType: 'signInForm.signUp',
+      payloadFields: [],
+    },
+  },
+  props: {
+    identifiers: {
+      type: 'array',
+      category: 'Authentication',
+      label: 'Identifiers',
+      default: ['email'],
+    },
+    identifierLabel: { type: 'string', category: 'Content', label: 'Identifier label' },
+    secretLabel: { type: 'string', category: 'Content', label: 'Secret label' },
+    forgotPasswordLabel: {
+      type: 'string',
+      category: 'Content',
+      label: 'Forgot-password label',
+    },
+    signUpLabel: { type: 'string', category: 'Content', label: 'Sign-up label' },
+    submitLabel: { type: 'string', category: 'Content', label: 'Submit label' },
+    error: { type: 'string', category: 'State', label: 'Error' },
+    loading: { type: 'boolean', category: 'State', label: 'Loading', default: false },
+    disabled: { type: 'boolean', category: 'State', label: 'Disabled', default: false },
+  },
+} as const satisfies ZoraComponentMeta;

package/src/features/auth/signUpFormMeta.ts

@@ -0,0 +1,67 @@
+import type { ZoraComponentMeta } from '../../metadata';
+
+export const signUpFormMeta = {
+  name: 'SignUpForm',
+  category: 'pattern',
+  description: 'Collects configurable account fields for sign-up.',
+  directManifestNode: true,
+  allowedChildren: [],
+  blueprint: {
+    label: 'Sign-up form',
+    defaultProps: {
+      signInLabel: 'Sign in',
+      submitLabel: 'Sign up',
+      loading: false,
+      disabled: false,
+    },
+  },
+  events: {
+    submit: {
+      label: 'Submit',
+      eventType: 'signUpForm.submit',
+      payloadFields: [{ path: 'values', type: 'record', label: 'Values' }],
+    },
+    signIn: {
+      label: 'Sign in',
+      eventType: 'signUpForm.signIn',
+      payloadFields: [],
+    },
+  },
+  props: {
+    fields: {
+      type: 'array',
+      category: 'Authentication',
+      label: 'Fields',
+      itemSchema: [
+        { key: 'name', schema: { type: 'string', category: 'Identity', label: 'Name' } },
+        { key: 'label', schema: { type: 'string', category: 'Content', label: 'Label' } },
+        {
+          key: 'type',
+          schema: {
+            type: 'enum',
+            category: 'Authentication',
+            label: 'Type',
+            enum: ['email', 'number', 'otp', 'password', 'tel', 'text', 'url'],
+          },
+        },
+        {
+          key: 'placeholder',
+          schema: { type: 'string', category: 'Content', label: 'Placeholder' },
+        },
+        {
+          key: 'required',
+          schema: { type: 'boolean', category: 'Validation', label: 'Required' },
+        },
+        {
+          key: 'disabled',
+          schema: { type: 'boolean', category: 'State', label: 'Disabled' },
+        },
+      ],
+    },
+    signInLabel: { type: 'string', category: 'Content', label: 'Sign-in label' },
+    submitLabel: { type: 'string', category: 'Content', label: 'Submit label' },
+    error: { type: 'string', category: 'State', label: 'Error' },
+    loading: { type: 'boolean', category: 'State', label: 'Loading', default: false },
+    disabled: { type: 'boolean', category: 'State', label: 'Disabled', default: false },
+  },
+} as const satisfies ZoraComponentMeta;

package/src/{patterns/auth/utils.ts → features/auth/utils/authForm.ts}

@@ -1,5 +1,5 @@
-import type { FormFieldConfig, ValidationRule } from '../../types/form';
-import type { AuthIdentifierKind } from './types';
+import type { AuthIdentifierKind } from '../../../types/auth';
+import type { FormFieldConfig, ValidationRule } from '../../../types/form';
 
 export const defaultIdentifiers = ['email'] as const satisfies readonly AuthIdentifierKind[];
 

package/src/{patterns/auth → features/auth/utils}/oauthProviders.test.ts

@@ -6,7 +6,7 @@ import {
   resolveOAuthProviderLabel,
 } from './oauthProviders';
 
-describe('OAuth provider UI helpers', () => {
+describe('Auth OAuth provider helpers', () => {
   it('resolves known provider labels', () => {
     expect(resolveOAuthProviderLabel('google')).toBe('Google');
     expect(resolveOAuthProviderLabel('github')).toBe('GitHub');

package/src/{patterns/auth → features/auth/utils}/oauthProviders.ts

@@ -1,4 +1,4 @@
-import type { OAuthProviderIconSpec } from './types';
+import type { OAuthProviderIconSpec } from '../../../types/auth';
 
 export const DEFAULT_OAUTH_PROVIDER_ICONS = {
   apple: { provider: 'FontAwesome', name: 'apple' },

package/src/{components/gradient → features/gradient/adapters/inbound}/Gradient.tsx

@@ -1,9 +1,9 @@
 import React from 'react';
 
-import { Box } from '../../features/layout/public';
-import { withZoraThemeScope } from '../../theme/withZoraThemeScope';
+import { withZoraThemeScope } from '../../../../theme/withZoraThemeScope';
+import type { GradientProps } from '../../../../types/gradient';
+import { Box } from '../../../layout/public';
 import { useGradientRenderer } from './GradientRendererContext';
-import type { GradientProps } from './types';
 
 function GradientInner({
   themeId: _themeId,

package/src/{components/gradient → features/gradient/adapters/inbound}/GradientRendererContext.tsx

@@ -1,10 +1,10 @@
 import React, { createContext, use } from 'react';
 
-import type { GradientRenderer, GradientRendererProviderProps } from './types';
+import type { GradientRenderer, GradientRendererProviderProps } from '../../../../types/gradient';
 
 const GradientRendererContext = createContext<GradientRenderer | null>(null);
 
-/**
+/***
  * Supplies the host-owned renderer used by `Gradient`.
  *
  * Expo apps can adapt `expo-linear-gradient` here, while standalone React
@@ -14,6 +14,7 @@ export function GradientRendererProvider({ children, renderer }: GradientRendere
   return <GradientRendererContext value={renderer}>{children}</GradientRendererContext>;
 }
 
+/*** Resolves the host-owned gradient renderer for a Gradient instance. */
 export function useGradientRenderer(): GradientRenderer {
   const renderer = use(GradientRendererContext);
 

package/src/features/gradient/gradientMeta.ts

@@ -0,0 +1,26 @@
+import type { ZoraComponentMeta } from '../../metadata';
+import { CONTAINER_ALLOWED_CHILDREN } from '../../metadata/allowedChildren';
+
+export const gradientMeta = {
+  name: 'Gradient',
+  category: 'component',
+  description: 'Renders a host-backed gradient container for nested manifest content.',
+  directManifestNode: true,
+  allowedChildren: [...CONTAINER_ALLOWED_CHILDREN],
+  blueprint: {
+    label: 'Gradient',
+  },
+  props: {
+    colors: {
+      type: 'array',
+      category: 'Style',
+      label: 'Colors',
+    },
+    locations: { type: 'array', category: 'Style', label: 'Locations' },
+    width: { type: 'number', category: 'Layout', label: 'Width' },
+    height: { type: 'number', category: 'Layout', label: 'Height' },
+    minHeight: { type: 'number', category: 'Layout', label: 'Minimum height' },
+    radius: { type: 'radius', category: 'Style', label: 'Corner radius' },
+    p: { type: 'spacing', category: 'Layout', label: 'Padding' },
+  },
+} as const satisfies ZoraComponentMeta;

package/src/features/gradient/public.test.ts

@@ -0,0 +1,15 @@
+import { expect, test } from 'bun:test';
+
+import { ZORA_COMPONENT_META } from '../../metadata/componentMeta';
+
+test('Gradient is a direct manifest container with serializable colors', () => {
+  const meta = ZORA_COMPONENT_META.Gradient;
+
+  expect(meta?.directManifestNode).toBe(true);
+  expect(meta?.allowedChildren.length).toBeGreaterThan(0);
+  expect(meta?.props.colors).toEqual({
+    type: 'array',
+    category: 'Style',
+    label: 'Colors',
+  });
+});

package/src/{components/gradient/index.ts → features/gradient/public.ts}

@@ -1,5 +1,3 @@
-export { Gradient } from './Gradient';
-export { GradientRendererProvider } from './GradientRendererContext';
 export type {
   GradientColor,
   GradientColors,
@@ -9,4 +7,6 @@ export type {
   GradientRenderer,
   GradientRendererProps,
   GradientRendererProviderProps,
-} from './types';
+} from '../../types/gradient';
+export { Gradient } from './adapters/inbound/Gradient';
+export { GradientRendererProvider } from './adapters/inbound/GradientRendererContext';

package/src/index.ts

@@ -2,17 +2,6 @@ export type { AppBarMode, AppBarOverflowAction, AppBarProps } from './components
 export { AppBar } from './components/app-bar';
 export type { BreadcrumbItem, BreadcrumbsProps } from './components/breadcrumbs';
 export { Breadcrumbs } from './components/breadcrumbs';
-export type {
-  GradientColor,
-  GradientColors,
-  GradientLocations,
-  GradientPoint,
-  GradientProps,
-  GradientRenderer,
-  GradientRendererProps,
-  GradientRendererProviderProps,
-} from './components/gradient';
-export { Gradient, GradientRendererProvider } from './components/gradient';
 export type { DropdownMenuProps, MenuAction, MenuActionIntent, MenuProps } from './components/menu';
 export { DropdownMenu, Menu } from './components/menu';
 export type { ModalProps } from './components/modal';
@@ -37,6 +26,35 @@ export {
   ActivityIndicator,
   type ActivityIndicatorProps,
 } from './features/activity-indicator/public';
+export type {
+  AuthFormBaseProps,
+  AuthIdentifierKind,
+  ForgotPasswordFormProps,
+  ForgotPasswordFormValues,
+  OAuthProviderButtonProps,
+  OAuthProviderIconSpec,
+  OAuthProviderItem,
+  OAuthProviderListLayout,
+  OAuthProviderListProps,
+  OtpFormProps,
+  OtpFormValues,
+  SignInFormProps,
+  SignInFormValues,
+  SignUpFormField,
+  SignUpFormProps,
+  SignUpFormValues,
+} from './features/auth/public';
+export {
+  DEFAULT_OAUTH_PROVIDER_ICONS,
+  ForgotPasswordForm,
+  OAuthProviderButton,
+  OAuthProviderList,
+  OtpForm,
+  resolveOAuthProviderIcon,
+  resolveOAuthProviderLabel,
+  SignInForm,
+  SignUpForm,
+} from './features/auth/public';
 export type { AvatarProps, AvatarShape, AvatarSize } from './features/avatar/public';
 export type { AvatarGroupItem, AvatarGroupProps } from './features/avatar/public';
 export { Avatar, resolveAvatarInitials } from './features/avatar/public';
@@ -141,6 +159,17 @@ export {
   type TextInputProps,
   type TextInputTrailingAction,
 } from './features/form/text-input/public';
+export type {
+  GradientColor,
+  GradientColors,
+  GradientLocations,
+  GradientPoint,
+  GradientProps,
+  GradientRenderer,
+  GradientRendererProps,
+  GradientRendererProviderProps,
+} from './features/gradient/public';
+export { Gradient, GradientRendererProvider } from './features/gradient/public';
 export {
   Hero,
   type HeroAction,
@@ -296,35 +325,6 @@ export {
   ZORA_THEME_RECIPE_META,
   ZORA_THEME_TOKEN_FAMILIES,
 } from './metadata';
-export type {
-  AuthFormBaseProps,
-  AuthIdentifierKind,
-  ForgotPasswordFormProps,
-  ForgotPasswordFormValues,
-  OAuthProviderButtonProps,
-  OAuthProviderIconSpec,
-  OAuthProviderItem,
-  OAuthProviderListLayout,
-  OAuthProviderListProps,
-  OtpFormProps,
-  OtpFormValues,
-  SignInFormProps,
-  SignInFormValues,
-  SignUpFormField,
-  SignUpFormProps,
-  SignUpFormValues,
-} from './patterns/auth';
-export {
-  DEFAULT_OAUTH_PROVIDER_ICONS,
-  ForgotPasswordForm,
-  OAuthProviderButton,
-  OAuthProviderList,
-  OtpForm,
-  resolveOAuthProviderIcon,
-  resolveOAuthProviderLabel,
-  SignInForm,
-  SignUpForm,
-} from './patterns/auth';
 export type { ChatListAvatar, ChatListItemProps } from './patterns/chat-list-item';
 export { ChatListItem } from './patterns/chat-list-item';
 export type {

package/src/metadata/allowedChildren.ts

@@ -1,5 +1,11 @@
 export const CONTAINER_ALLOWED_CHILDREN = [
   'ActivityIndicator',
+  'ForgotPasswordForm',
+  'OAuthProviderButton',
+  'OAuthProviderList',
+  'OtpForm',
+  'SignInForm',
+  'SignUpForm',
   'Surface',
   'Avatar',
   'AvatarGroup',
@@ -23,6 +29,7 @@ export const CONTAINER_ALLOWED_CHILDREN = [
   'Box',
   'Stack',
   'Grid',
+  'Gradient',
   'Container',
   'Divider',
   'Text',

package/src/metadata/componentMeta.test.ts

@@ -137,6 +137,12 @@ describe('ZORA_COMPONENT_META invariants', () => {
   test('direct manifest node leaf/container rules', () => {
     const expectedLeafNodes = new Set([
       'ActivityIndicator',
+      'ForgotPasswordForm',
+      'OAuthProviderButton',
+      'OAuthProviderList',
+      'OtpForm',
+      'SignInForm',
+      'SignUpForm',
       'Avatar',
       'AvatarGroup',
       'Badge',
@@ -181,6 +187,7 @@ describe('ZORA_COMPONENT_META invariants', () => {
 
     const expectedContainerNodes = new Set([
       'Form',
+      'Gradient',
       'Surface',
       'MediaCard',
       'FlatList',