@easyling/sanity-connector 0.0.2-rc.1 → 0.0.2-rc.2

package/dist/index.js.LICENSE.txt

@@ -0,0 +1,28 @@
+/**
+ * @license React
+ * react-is.production.min.js
+ *
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * @license React
+ * react-jsx-runtime.production.min.js
+ *
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/**
+ * Prism: Lightweight, robust, elegant syntax highlighting
+ *
+ * @license MIT <https://opensource.org/licenses/MIT>
+ * @author Lea Verou <https://lea.verou.me>
+ * @namespace
+ * @public
+ */

package/dist-types/actions/bulkTranslate.d.ts

@@ -0,0 +1,6 @@
+import { Tool } from 'sanity';
+/**
+ * Bulk Translation Tool Definition
+ * Requirements: 2.1, 2.5, 4.1, 4.2
+ */
+export declare const bulkTranslateTool: Tool;

package/dist-types/actions/manageDNTFields.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Document action for managing DNT (Do Not Translate) field preferences
+ *
+ * Now uses document-type-based configuration: DNT settings apply to ALL documents
+ * of the same type, not just individual document instances.
+ */
+import { DocumentActionComponent } from 'sanity';
+/**
+ * Document action for managing DNT fields
+ */
+export declare const manageDNTFieldsAction: DocumentActionComponent;

package/dist-types/actions/translateDocument.d.ts

@@ -0,0 +1,6 @@
+import { DocumentActionComponent } from 'sanity';
+/**
+ * Document action for translating a single document
+ * Requirements: 2.1, 2.3, 3.1, 3.3, 4.1, 4.2
+ */
+export declare const translateDocumentAction: DocumentActionComponent;

package/dist-types/components/RadioWithDefault.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Custom Radio Input Component with Auto-Default
+ *
+ * This component wraps Sanity's default radio input and automatically sets
+ * the default value when the field is undefined. This ensures that:
+ * 1. New users see defaults immediately
+ * 2. Existing users with legacy configs see defaults without manual intervention
+ * 3. The UX is seamless and doesn't require any user action
+ */
+import React from 'react';
+import { StringInputProps } from 'sanity';
+interface RadioWithDefaultProps extends StringInputProps {
+    defaultValue: string;
+}
+export declare const RadioWithDefault: React.FC<RadioWithDefaultProps>;
+export {};

package/dist-types/components/auth/AuthNavbar.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Authentication Navbar Component
+ * Requirements: 6.2, 6.3
+ *
+ * Navbar component that displays authentication status in the Sanity Studio.
+ * Positioned for easy access across all plugin pages.
+ */
+import React from 'react';
+/**
+ * Authentication Navbar
+ *
+ * Displays the authentication status in a navbar-style component.
+ * Designed to be visible across all plugin pages.
+ *
+ * Requirements: 6.2, 6.3
+ */
+export declare const AuthNavbar: React.FC;

package/dist-types/components/auth/AuthStatus.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Authentication Status Component
+ * Requirements: 6.2, 6.3, 1.1, 7.1, 7.2, 7.3
+ *
+ * Displays the current authentication status and provides controls
+ * for connecting to and disconnecting from Easyling.
+ */
+import React from 'react';
+import { AuthStateManager } from '../../services/authStateManager';
+export interface AuthStatusProps {
+    /** Authentication state manager instance */
+    authStateManager: AuthStateManager;
+    /** Callback when user clicks connect button */
+    onConnect: () => void;
+    /** Callback when user clicks disconnect button */
+    onDisconnect: () => void;
+}
+/**
+ * Authentication Status Component
+ *
+ * Subscribes to AuthStateManager for reactive updates and displays
+ * different UI based on the current authentication state.
+ *
+ * Requirements: 6.2, 6.3, 1.1, 7.1, 7.2, 7.3
+ */
+export declare const AuthStatus: React.FC<AuthStatusProps>;

package/dist-types/components/auth/AuthStatusWrapper.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Authentication Status Wrapper Component
+ *
+ * Wrapper component that connects AuthStatus to the service manager.
+ * Provides the necessary callbacks for connect and disconnect actions.
+ */
+import React from 'react';
+/**
+ * Authentication Status Wrapper
+ *
+ * Connects the AuthStatus component to the service manager singleton.
+ * Handles connect and disconnect actions by delegating to the service manager.
+ */
+export declare const AuthStatusWrapper: React.FC;

package/dist-types/components/auth/MigrationPrompt.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Migration Prompt Component - DEPRECATED
+ *
+ * This component is no longer used since OAuth migration prompts are not needed
+ * with the new long-lived token authentication approach.
+ */
+import React from 'react';
+export interface MigrationPromptProps {
+    /** Callback when user wants to set up OAuth (deprecated) */
+    onSetupOAuth: () => void;
+    /** Callback when user dismisses the prompt (deprecated) */
+    onDismiss: () => void;
+}
+/**
+ * Migration Prompt Component - DEPRECATED
+ *
+ * Returns null as OAuth migration is no longer applicable.
+ */
+export declare const MigrationPrompt: React.FC<MigrationPromptProps>;

package/dist-types/components/auth/MigrationPromptWrapper.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Migration Prompt Wrapper Component - DEPRECATED
+ *
+ * This component is no longer used since OAuth migration prompts are not needed
+ * with the new long-lived token authentication approach.
+ */
+import React from 'react';
+/**
+ * Migration Prompt Wrapper - DEPRECATED
+ *
+ * Returns null as OAuth migration is no longer applicable.
+ */
+export declare const MigrationPromptWrapper: React.FC;

package/dist-types/components/auth/OAuthCallback.d.ts

@@ -0,0 +1,19 @@
+/**
+ * OAuth Callback Component - DEPRECATED
+ *
+ * This component is no longer used with the new long-lived token authentication approach.
+ * Easyling authentication now uses direct access token configuration instead of OAuth flows.
+ */
+import React from 'react';
+export interface OAuthCallbackProps {
+    /** Callback when authentication is complete (not used) */
+    onComplete?: () => void;
+    /** Callback to retry authentication (not used) */
+    onRetry?: () => void;
+}
+/**
+ * OAuth Callback Component - DEPRECATED
+ *
+ * Shows a message that OAuth callbacks are no longer supported.
+ */
+export declare const OAuthCallback: React.FC<OAuthCallbackProps>;

package/dist-types/components/auth/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Authentication Components
+ *
+ * Exports all authentication-related UI components
+ */
+export { AuthStatus } from './AuthStatus';
+export type { AuthStatusProps } from './AuthStatus';
+export { OAuthCallback } from './OAuthCallback';
+export type { OAuthCallbackProps } from './OAuthCallback';
+export { AuthStatusWrapper } from './AuthStatusWrapper';
+export { AuthNavbar } from './AuthNavbar';
+export { MigrationPrompt } from './MigrationPrompt';
+export type { MigrationPromptProps } from './MigrationPrompt';
+export { MigrationPromptWrapper } from './MigrationPromptWrapper';

package/dist-types/components/config/LocaleConfigTool.d.ts

@@ -0,0 +1,16 @@
+/**
+ * LocaleConfigTool Component
+ * Requirements: 1.1, 1.2, 1.6, 1.7
+ *
+ * Administrative interface for managing locale configuration
+ */
+import React from 'react';
+import { LocaleService } from '../../services/localeService';
+export interface LocaleConfigToolProps {
+    /** Locale service instance for CRUD operations */
+    localeService: LocaleService;
+}
+/**
+ * LocaleConfigTool component for administrative locale management
+ */
+export declare const LocaleConfigTool: React.FC<LocaleConfigToolProps>;

package/dist-types/components/config/LocaleConfigToolWrapper.d.ts

@@ -0,0 +1,12 @@
+/**
+ * LocaleConfigTool Wrapper for Sanity Tool Integration
+ * Requirements: 1.1, 5.1, 5.2, 5.3, 5.7
+ *
+ * Wraps the LocaleConfigTool component with Sanity client integration
+ */
+import React from 'react';
+/**
+ * Wrapper component that provides LocaleService with Sanity storage adapter
+ * Requirements: 1.1, 5.1, 5.2, 5.3, 5.7
+ */
+export declare const LocaleConfigToolWrapper: React.FC;

package/dist-types/components/config/OAuthConfig.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Easyling Configuration Component
+ *
+ * UI component for configuring Easyling integration with access token and project ID
+ */
+import React from 'react';
+import { OAuthConfig as OAuthConfigType } from '../../types/oauth';
+export interface OAuthConfigProps {
+    /** Callback when configuration is saved */
+    onConfigSaved?: (config: OAuthConfigType) => void;
+    /** Initial configuration to load */
+    initialConfig?: OAuthConfigType | null;
+    /** Function to save configuration */
+    onSave?: (config: OAuthConfigType) => Promise<void>;
+    /** Function to load configuration */
+    onLoad?: () => Promise<OAuthConfigType | null>;
+}
+/**
+ * Easyling Configuration Component
+ *
+ * Provides a form for configuring Easyling authentication:
+ * - Project ID
+ * - Access Token (secure password field)
+ */
+export declare const OAuthConfig: React.FC<OAuthConfigProps>;

package/dist-types/components/config/OAuthConfigWrapper.d.ts

@@ -0,0 +1,12 @@
+/**
+ * OAuth Configuration Wrapper for Sanity Integration
+ * Requirements: 9.1, 9.4
+ *
+ * Wraps the OAuthConfig component with Sanity client integration
+ */
+import React from 'react';
+/**
+ * Wrapper component that provides OAuthConfig with Sanity storage
+ * Requirements: 9.1, 9.4
+ */
+export declare const OAuthConfigWrapper: React.FC;

package/dist-types/components/config/PasswordInput.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Password Input Component for Sanity
+ *
+ * Custom input component that obscures sensitive token values in Sanity Studio
+ */
+import React from 'react';
+import { StringInputProps } from 'sanity';
+/**
+ * Password Input Component
+ *
+ * Renders a password-type input field that obscures the value
+ */
+export declare const PasswordInput: React.FC<StringInputProps>;

package/dist-types/components/config/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Configuration components exports
+ */
+export { LocaleConfigTool } from './LocaleConfigTool';
+export type { LocaleConfigToolProps } from './LocaleConfigTool';
+export { LocaleConfigToolWrapper } from './LocaleConfigToolWrapper';
+export { localeConfigTool } from './localeConfigToolDefinition';
+export { PasswordInput } from './PasswordInput';

package/dist-types/components/config/localeConfigToolDefinition.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Locale Configuration Tool Definition
+ * Requirements: 1.1, 5.1, 5.7
+ *
+ * Sanity Studio tool for managing locale configuration
+ */
+import { Tool } from 'sanity';
+/**
+ * Locale Configuration Tool for Sanity Studio
+ * Requirements: 1.1, 5.1, 5.7
+ */
+export declare const localeConfigTool: Tool;

package/dist-types/components/config/oauthConfigToolDefinition.d.ts

@@ -0,0 +1,12 @@
+/**
+ * OAuth Configuration Tool Definition
+ * Requirements: 9.1, 9.3
+ *
+ * Sanity Studio tool for managing OAuth configuration
+ */
+import { Tool } from 'sanity';
+/**
+ * OAuth Configuration Tool for Sanity Studio
+ * Requirements: 9.1, 9.3
+ */
+export declare const oauthConfigTool: Tool;

package/dist-types/components/dialogs/ConfirmationDialog.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ConfirmationDialog Component
+ * Requirements: 3.1, 3.2, 3.8
+ *
+ * A reusable confirmation dialog with proper accessibility support
+ */
+import React from 'react';
+import type { ConfirmationDialogOptions } from '../../types/dialog';
+export interface ConfirmationDialogProps extends ConfirmationDialogOptions {
+    /** Whether the dialog is open */
+    open: boolean;
+    /** Callback when user confirms */
+    onConfirm: () => void;
+    /** Callback when user cancels */
+    onCancel: () => void;
+}
+/**
+ * ConfirmationDialog component with accessibility features
+ */
+export declare const ConfirmationDialog: React.FC<ConfirmationDialogProps>;

package/dist-types/components/dialogs/ErrorDialog.d.ts

@@ -0,0 +1,20 @@
+/**
+ * ErrorDialog Component
+ * Requirements: 3.7, 3.8
+ *
+ * An error notification dialog with accessibility support and retry functionality
+ */
+import React from 'react';
+import type { ErrorDialogOptions } from '../../types/dialog';
+export interface ErrorDialogProps extends ErrorDialogOptions {
+    /** Whether the dialog is open */
+    open: boolean;
+    /** Callback when dialog is closed */
+    onClose: () => void;
+    /** Callback when user clicks retry */
+    onRetry?: () => void;
+}
+/**
+ * ErrorDialog component for displaying error messages
+ */
+export declare const ErrorDialog: React.FC<ErrorDialogProps>;

package/dist-types/components/dialogs/LocaleSelectionDialog.d.ts

@@ -0,0 +1,40 @@
+/**
+ * LocaleSelectionDialog Component
+ * Requirements: 2.1, 2.2, 2.3, 2.4, 2.6, 2.7
+ *
+ * A dialog for selecting target locales for translation with search and validation
+ */
+import React from 'react';
+import type { LocaleDefinition } from '../../types/locale';
+export interface LocaleSelectionDialogProps {
+    /** Whether the dialog is open */
+    open: boolean;
+    /** Dialog title */
+    title: string;
+    /** Dialog message/description */
+    message: string;
+    /** Available locales to choose from */
+    availableLocales: LocaleDefinition[];
+    /** Currently selected locale codes */
+    selectedLocales: string[];
+    /** Documents being translated (for context display) */
+    selectedDocuments?: any[];
+    /** Translation mode */
+    mode: 'single' | 'bulk';
+    /** Whether multiple locales can be selected */
+    allowMultiple?: boolean;
+    /** Whether locale selection is required */
+    required?: boolean;
+    /** Whether to show creation mode option in the dialog */
+    showCreationModeOption?: boolean;
+    /** Default creation mode to pre-select */
+    defaultCreationMode?: 'draft' | 'published';
+    /** Callback when user confirms selection */
+    onConfirm: (selectedLocales: string[], creationMode?: 'draft' | 'published') => void;
+    /** Callback when user cancels */
+    onCancel: () => void;
+}
+/**
+ * LocaleSelectionDialog component with search and multi-select functionality
+ */
+export declare const LocaleSelectionDialog: React.FC<LocaleSelectionDialogProps>;

package/dist-types/components/dialogs/SuccessDialog.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SuccessDialog Component
+ * Requirements: 3.6, 3.8
+ *
+ * A success notification dialog with accessibility support
+ */
+import React from 'react';
+import type { SuccessDialogOptions } from '../../types/dialog';
+export interface SuccessDialogProps extends SuccessDialogOptions {
+    /** Whether the dialog is open */
+    open: boolean;
+    /** Callback when dialog is closed */
+    onClose: () => void;
+}
+/**
+ * SuccessDialog component for displaying success messages
+ */
+export declare const SuccessDialog: React.FC<SuccessDialogProps>;

package/dist-types/components/dialogs/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Dialog components exports
+ */
+export { ConfirmationDialog } from './ConfirmationDialog';
+export type { ConfirmationDialogProps } from './ConfirmationDialog';
+export { SuccessDialog } from './SuccessDialog';
+export type { SuccessDialogProps } from './SuccessDialog';
+export { ErrorDialog } from './ErrorDialog';
+export type { ErrorDialogProps } from './ErrorDialog';
+export { LocaleSelectionDialog } from './LocaleSelectionDialog';
+export type { LocaleSelectionDialogProps } from './LocaleSelectionDialog';

package/dist-types/components/dnt/DNTFieldBadge.d.ts

@@ -0,0 +1,15 @@
+/**
+ * DNT Field Badge Component
+ * Displays a badge on fields indicating their translation status and allows toggling
+ *
+ * Now uses document-type-based configuration: toggling DNT for a field applies to
+ * ALL documents of the same type.
+ */
+interface DNTFieldBadgeProps {
+    documentId: string;
+    documentType: string;
+    fieldPath: string;
+    fieldTitle?: string;
+}
+export declare function DNTFieldBadge(props: DNTFieldBadgeProps): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist-types/components/dnt/DNTFieldComponent.d.ts

@@ -0,0 +1,16 @@
+/**
+ * DNT Field Component
+ * A wrapper component that adds DNT toggle functionality to any field
+ */
+import React from 'react';
+import { ObjectInputProps, StringInputProps, NumberInputProps, BooleanInputProps, ArrayOfObjectsInputProps } from 'sanity';
+type FieldInputProps = ObjectInputProps | StringInputProps | NumberInputProps | BooleanInputProps | ArrayOfObjectsInputProps;
+interface DNTFieldComponentProps {
+    documentId?: string;
+    documentType?: string;
+}
+/**
+ * Higher-order component that wraps field components with DNT functionality
+ */
+export declare function withDNTBadge<P extends FieldInputProps>(Component: React.ComponentType<P>): React.ComponentType<P & DNTFieldComponentProps>;
+export {};

package/dist-types/components/dnt/DNTFieldInput.d.ts

@@ -0,0 +1,13 @@
+/**
+ * DNT Field Input Component
+ * Wraps any field with a DNT toggle badge
+ *
+ * Now uses document-type-based configuration: toggling DNT for a field applies to
+ * ALL documents of the same type.
+ */
+import React from 'react';
+import { FieldProps } from 'sanity';
+/**
+ * Field component that adds DNT badge
+ */
+export declare function DNTFieldInput(props: FieldProps): React.JSX.Element;

package/dist-types/components/dnt/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * DNT (Do Not Translate) Components
+ */
+export { DNTFieldBadge } from './DNTFieldBadge';
+export { withDNTBadge } from './DNTFieldComponent';
+export { DNTFieldInput } from './DNTFieldInput';

package/dist-types/config/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Configuration exports
+ * Centralized exports for plugin configuration
+ */
+export { pluginConfigSchema, defaultLocaleConfig, commonLocales, validateLocaleCode, createLocaleDefinition, updateLocaleDefinition } from './pluginConfig';

package/dist-types/config/pluginConfig.d.ts

@@ -0,0 +1,162 @@
+/**
+ * Plugin configuration schema and utilities
+ * Requirements: 5.1, 5.2, 5.3
+ */
+import { LocaleConfig, LocaleDefinition } from '../types/locale';
+/**
+ * Create unified plugin configuration schema for Sanity
+ * Internal type prefixed with EL_ to separate from customer document types
+ *
+ * This single document type stores all plugin configuration:
+ * - OAuth/authentication settings
+ * - Locale definitions
+ * - DNT (Do Not Translate) field mappings by document type
+ *
+ * @param PasswordInputComponent - Optional password input component for access token field
+ */
+export declare const createPluginConfigSchema: (PasswordInputComponent?: any) => {
+    name: string;
+    title: string;
+    type: string;
+    fields: any[];
+    groups: ({
+        name: string;
+        title: string;
+        default: boolean;
+        description?: undefined;
+    } | {
+        name: string;
+        title: string;
+        default?: undefined;
+        description?: undefined;
+    } | {
+        name: string;
+        title: string;
+        description: string;
+        default?: undefined;
+    })[];
+    preview: {
+        prepare: () => {
+            title: string;
+            subtitle: string;
+        };
+    };
+};
+/**
+ * Default export for backward compatibility and tests
+ */
+export declare const pluginConfigSchema: {
+    name: string;
+    title: string;
+    type: string;
+    fields: any[];
+    groups: ({
+        name: string;
+        title: string;
+        default: boolean;
+        description?: undefined;
+    } | {
+        name: string;
+        title: string;
+        default?: undefined;
+        description?: undefined;
+    } | {
+        name: string;
+        title: string;
+        description: string;
+        default?: undefined;
+    })[];
+    preview: {
+        prepare: () => {
+            title: string;
+            subtitle: string;
+        };
+    };
+};
+/**
+ * Legacy locale-only configuration schema (deprecated, kept for migration)
+ * @deprecated Use pluginConfigSchema instead
+ */
+export declare const legacyLocaleConfigSchema: {
+    name: string;
+    title: string;
+    type: string;
+    fields: ({
+        name: string;
+        title: string;
+        type: string;
+        description: string;
+        of: {
+            type: string;
+            title: string;
+            fields: ({
+                name: string;
+                title: string;
+                type: string;
+                description: string;
+                validation: (Rule: any) => any;
+                initialValue?: undefined;
+            } | {
+                name: string;
+                title: string;
+                type: string;
+                description: string;
+                initialValue: boolean;
+                validation?: undefined;
+            })[];
+            preview: {
+                select: {
+                    title: string;
+                    subtitle: string;
+                    enabled: string;
+                };
+                prepare: ({ title, subtitle, enabled }: any) => {
+                    title: any;
+                    subtitle: string;
+                    media: string;
+                };
+            };
+        }[];
+        validation?: undefined;
+        initialValue?: undefined;
+        readOnly?: undefined;
+    } | {
+        name: string;
+        title: string;
+        type: string;
+        description: string;
+        validation: (Rule: any) => any;
+        of?: undefined;
+        initialValue?: undefined;
+        readOnly?: undefined;
+    } | {
+        name: string;
+        title: string;
+        type: string;
+        description: string;
+        initialValue: string;
+        readOnly: boolean;
+        of?: undefined;
+        validation?: undefined;
+    })[];
+};
+/**
+ * Default locale configuration
+ */
+export declare const defaultLocaleConfig: LocaleConfig;
+/**
+ * Common locale definitions for quick setup
+ */
+export declare const commonLocales: LocaleDefinition[];
+/**
+ * Validate locale code format
+ */
+export declare function validateLocaleCode(code: string): boolean;
+/**
+ * Create a new locale definition with current timestamps
+ */
+export declare function createLocaleDefinition(code: string, displayName: string, enabled?: boolean): LocaleDefinition;
+/**
+ * Update an existing locale definition with new timestamp
+ */
+export declare function updateLocaleDefinition(locale: LocaleDefinition, updates: Partial<Omit<LocaleDefinition, 'createdAt' | 'updatedAt'>>): LocaleDefinition;