nucleus-core-ts 0.9.885 → 0.9.886

package/dist/.build-ok

@@ -1 +1 @@
-0.9.885
+0.9.886

package/dist/fe/components/Captcha/components/Captcha.d.ts

@@ -1,3 +1,3 @@
 import type { ReactElement } from 'react';
 import type { CaptchaProps } from '../types';
-export declare function Captcha({ generateAction, config, onChallengeLoad, onAnswerChange, disabled, autoGenerate, className, label, errorMessage, themeOverride, }: CaptchaProps): ReactElement;
+export declare function Captcha({ generateAction, config, onChallengeLoad, onAnswerChange, disabled, autoGenerate, className, label, labels: labelOverrides, errorMessage, themeOverride, }: CaptchaProps): ReactElement;

package/dist/fe/components/Captcha/components/Captcha.js

@@ -4,6 +4,7 @@ import { useGSAP } from '@gsap/react';
 import gsap from 'gsap';
 import { useEffect, useEffectEvent, useRef, useState } from 'react';
 import { cn } from '../../../utils/cn';
+import { DEFAULT_CAPTCHA_LABELS } from '../labels';
 import { captchaTheme } from '../theme';
 gsap.registerPlugin(useGSAP);
 function mergeTheme(base, override) {
@@ -62,7 +63,14 @@ const RefreshIcon = ({ className, iconRef })=>/*#__PURE__*/ _jsxs("svg", {
             })
         ]
     });
-export function Captcha({ generateAction, config, onChallengeLoad, onAnswerChange, disabled = false, autoGenerate = true, className, label = 'Security Check', errorMessage, themeOverride }) {
+export function Captcha({ generateAction, config, onChallengeLoad, onAnswerChange, disabled = false, autoGenerate = true, className, label, labels: labelOverrides, errorMessage, themeOverride }) {
+    // `label` came first and some installs pass it; it still wins for the
+    // heading so nothing that already works changes.
+    const labels = {
+        ...DEFAULT_CAPTCHA_LABELS,
+        ...labelOverrides
+    };
+    const heading = label ?? labels.heading;
     const theme = themeOverride ? mergeTheme(captchaTheme, themeOverride) : captchaTheme;
     const containerRef = useRef(null);
     const challengeRef = useRef(null);
@@ -89,9 +97,8 @@ export function Captcha({ generateAction, config, onChallengeLoad, onAnswerChang
             },
             onAfterHandle: (response)=>{
                 const { data } = response;
-                console.log('[DEBUG]:', response);
                 if (!data || data.rateLimited) {
-                    setRateLimitError(response.message ?? 'Too many requests. Please try again later.');
+                    setRateLimitError(response.message ?? labels.tooManyRequests);
                     setChallengeData(null);
                     return;
                 }
@@ -111,7 +118,7 @@ export function Captcha({ generateAction, config, onChallengeLoad, onAnswerChang
             },
             onErrorHandle: (_error, code)=>{
                 if (code === 429) {
-                    setRateLimitError('Too many requests. Please try again later.');
+                    setRateLimitError(labels.tooManyRequests);
                 }
                 setChallengeData(null);
             }
@@ -186,17 +193,17 @@ export function Captcha({ generateAction, config, onChallengeLoad, onAnswerChang
         return `${mins}:${secs.toString().padStart(2, '0')}`;
     };
     const getPlaceholder = ()=>{
-        if (!challenge) return 'Enter answer';
+        if (!challenge) return labels.enterAnswer;
         switch(challenge.type){
             case 'math':
-                return 'Enter the result';
+                return labels.enterResult;
             case 'image':
             case 'text':
-                return 'Enter the text shown';
+                return labels.enterTextShown;
             case 'puzzle':
-                return 'Enter piece order (e.g., 0,1,2,3)';
+                return labels.enterPieceOrder;
             default:
-                return 'Enter answer';
+                return labels.enterAnswer;
         }
     };
     if (config?.enabled === false) {
@@ -210,7 +217,7 @@ export function Captcha({ generateAction, config, onChallengeLoad, onAnswerChang
             children: [
                 /*#__PURE__*/ _jsx("span", {
                     className: theme.label.base,
-                    children: label
+                    children: heading
                 }),
                 /*#__PURE__*/ _jsx("div", {
                     ref: challengeRef,
@@ -234,7 +241,7 @@ export function Captcha({ generateAction, config, onChallengeLoad, onAnswerChang
                                 className: theme.challenge.image.wrapper,
                                 children: /*#__PURE__*/ _jsx("img", {
                                     src: challenge.imageData,
-                                    alt: "Captcha",
+                                    alt: labels.imageAlt,
                                     className: theme.challenge.image.img,
                                     draggable: false
                                 })
@@ -242,14 +249,9 @@ export function Captcha({ generateAction, config, onChallengeLoad, onAnswerChang
                             challenge.type === 'puzzle' && challenge.puzzleData && /*#__PURE__*/ _jsxs("div", {
                                 className: theme.challenge.puzzle.wrapper,
                                 children: [
-                                    /*#__PURE__*/ _jsxs("p", {
+                                    /*#__PURE__*/ _jsx("p", {
                                         className: theme.challenge.puzzle.instruction,
-                                        children: [
-                                            "Click the pieces in the correct order (0 to",
-                                            ' ',
-                                            challenge.puzzleData.pieces.length - 1,
-                                            ")"
-                                        ]
+                                        children: labels.puzzleInstruction.replace('{last}', String(challenge.puzzleData.pieces.length - 1))
                                     }),
                                     /*#__PURE__*/ _jsx("div", {
                                         className: theme.challenge.puzzle.grid,
@@ -272,7 +274,7 @@ export function Captcha({ generateAction, config, onChallengeLoad, onAnswerChang
                                                 type: "button",
                                                 onClick: handleClearPuzzleOrder,
                                                 className: theme.challenge.puzzle.clearButton,
-                                                children: "Clear"
+                                                children: labels.clearOrder
                                             })
                                         ]
                                     })
@@ -283,7 +285,7 @@ export function Captcha({ generateAction, config, onChallengeLoad, onAnswerChang
                         className: theme.loading.wrapper,
                         children: /*#__PURE__*/ _jsx("p", {
                             className: "text-sm text-zinc-500",
-                            children: "Click refresh to load captcha"
+                            children: labels.clickRefresh
                         })
                     })
                 }),
@@ -293,7 +295,7 @@ export function Captcha({ generateAction, config, onChallengeLoad, onAnswerChang
                         /*#__PURE__*/ _jsx("label", {
                             htmlFor: "captcha-answer",
                             className: "sr-only",
-                            children: label
+                            children: heading
                         }),
                         /*#__PURE__*/ _jsx("input", {
                             id: "captcha-answer",
@@ -320,13 +322,13 @@ export function Captcha({ generateAction, config, onChallengeLoad, onAnswerChang
                                     iconRef: iconRef
                                 }),
                                 /*#__PURE__*/ _jsx("span", {
-                                    children: "New challenge"
+                                    children: labels.newChallenge
                                 })
                             ]
                         }),
                         timeRemaining !== null && /*#__PURE__*/ _jsx("span", {
                             className: isExpired ? theme.actions.timerExpired : theme.actions.timer,
-                            children: isExpired ? 'Expired' : `Expires in ${formatTime(timeRemaining)}`
+                            children: isExpired ? labels.expired : labels.expiresIn.replace('{time}', formatTime(timeRemaining))
                         })
                     ]
                 }),
@@ -334,7 +336,7 @@ export function Captcha({ generateAction, config, onChallengeLoad, onAnswerChang
                     className: theme.error.container,
                     children: /*#__PURE__*/ _jsx("p", {
                         className: theme.error.text,
-                        children: rateLimitError ? rateLimitError : isExpired ? 'Captcha expired. Please refresh.' : errorMessage
+                        children: rateLimitError ? rateLimitError : isExpired ? labels.expiredMessage : errorMessage
                     })
                 })
             ]

package/dist/fe/components/Captcha/index.d.ts

@@ -1,3 +1,4 @@
 export { Captcha } from './components/Captcha';
+export { type CaptchaLabels, DEFAULT_CAPTCHA_LABELS } from './labels';
 export { captchaTheme } from './theme';
 export type { CaptchaAction, CaptchaChallenge, CaptchaChallengeData, CaptchaConfig, CaptchaDifficulty, CaptchaProps, CaptchaState, CaptchaThemeOverride, CaptchaType, } from './types';

package/dist/fe/components/Captcha/index.js

@@ -1,2 +1,3 @@
 export { Captcha } from './components/Captcha';
+export { DEFAULT_CAPTCHA_LABELS } from './labels';
 export { captchaTheme } from './theme';

package/dist/fe/components/Captcha/labels.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Every word the security check says.
+ *
+ * This is the most-read component in the kit and the one nobody thought to
+ * translate: it sits on the sign-in form, so on an installation of 879 people
+ * it is shown several hundred times a morning. A portal could pass `label` and
+ * change the heading — and the box under the heading still said "Enter the
+ * result", "New challenge", "Expires in 1:30" and, when somebody was slow,
+ * "Captcha expired. Please refresh." Four sentences of English on the first
+ * screen of a portal that is otherwise entirely in its own language.
+ *
+ * The placeholders are per challenge type because the instruction is different
+ * for each: a sum wants its result, an image wants the letters in it, and the
+ * puzzle wants an order. `expiresIn` takes the formatted clock as `{time}` so a
+ * translation can put it where its own grammar wants it.
+ *
+ * Defaults stay English, so an installation that passes nothing is unchanged.
+ */
+export type CaptchaLabels = {
+    /** The heading over the box, and the input's screen-reader label. */
+    heading: string;
+    /** Before a challenge has been asked for. */
+    clickRefresh: string;
+    /** The answer box, by challenge type. */
+    enterAnswer: string;
+    enterResult: string;
+    enterTextShown: string;
+    enterPieceOrder: string;
+    /** The picture challenge's alternative text. */
+    imageAlt: string;
+    /** The puzzle: its instruction takes the highest piece number as `{last}`. */
+    puzzleInstruction: string;
+    clearOrder: string;
+    /** Asking for a different challenge. */
+    newChallenge: string;
+    /** The countdown. `expiresIn` takes the clock as `{time}`. */
+    expiresIn: string;
+    expired: string;
+    /** What the box says once the clock has run out. */
+    expiredMessage: string;
+    /** Asked for too many challenges too quickly. */
+    tooManyRequests: string;
+};
+export declare const DEFAULT_CAPTCHA_LABELS: CaptchaLabels;

package/dist/fe/components/Captcha/labels.js

@@ -0,0 +1,33 @@
+/**
+ * Every word the security check says.
+ *
+ * This is the most-read component in the kit and the one nobody thought to
+ * translate: it sits on the sign-in form, so on an installation of 879 people
+ * it is shown several hundred times a morning. A portal could pass `label` and
+ * change the heading — and the box under the heading still said "Enter the
+ * result", "New challenge", "Expires in 1:30" and, when somebody was slow,
+ * "Captcha expired. Please refresh." Four sentences of English on the first
+ * screen of a portal that is otherwise entirely in its own language.
+ *
+ * The placeholders are per challenge type because the instruction is different
+ * for each: a sum wants its result, an image wants the letters in it, and the
+ * puzzle wants an order. `expiresIn` takes the formatted clock as `{time}` so a
+ * translation can put it where its own grammar wants it.
+ *
+ * Defaults stay English, so an installation that passes nothing is unchanged.
+ */ export const DEFAULT_CAPTCHA_LABELS = {
+    heading: 'Security Check',
+    clickRefresh: 'Click refresh to load captcha',
+    enterAnswer: 'Enter answer',
+    enterResult: 'Enter the result',
+    enterTextShown: 'Enter the text shown',
+    enterPieceOrder: 'Enter piece order (e.g., 0,1,2,3)',
+    imageAlt: 'Captcha',
+    puzzleInstruction: 'Click the pieces in the correct order (0 to {last})',
+    clearOrder: 'Clear',
+    newChallenge: 'New challenge',
+    expiresIn: 'Expires in {time}',
+    expired: 'Expired',
+    expiredMessage: 'Captcha expired. Please refresh.',
+    tooManyRequests: 'Too many requests. Please try again later.'
+};

package/dist/fe/components/Captcha/types.d.ts

@@ -1,3 +1,4 @@
+import type { CaptchaLabels } from './labels';
 export type CaptchaType = 'math' | 'image' | 'puzzle' | 'text';
 export type CaptchaDifficulty = 'easy' | 'medium' | 'hard';
 export interface CaptchaChallengeData {
@@ -110,7 +111,10 @@ export interface CaptchaProps {
     disabled?: boolean;
     autoGenerate?: boolean;
     className?: string;
+    /** The heading only. Kept because installs already pass it; `labels` covers the rest. */
     label?: string;
+    /** Every other word the box says — see `../labels`. */
+    labels?: Partial<CaptchaLabels>;
     errorMessage?: string;
     themeOverride?: CaptchaThemeOverride;
 }

package/dist/fe/index.d.ts

@@ -4,8 +4,8 @@ export { LoginChecker, RoleChecker, useAuthGuardStore, usePermission } from './c
 export type { AuthorizationPageProps, AuthorizationPageTheme, ClaimListProps, RoleClaimEditorProps, RoleListProps, } from './components/AuthorizationPage';
 export { AuthorizationPage, authorizationPageTheme, ClaimList, extendAuthorizationPageTheme, RoleClaimEditor, RoleList, useAuthorizationStore, } from './components/AuthorizationPage';
 export { Button } from './components/Button';
-export type { CaptchaAction, CaptchaChallenge, CaptchaConfig, CaptchaDifficulty, CaptchaProps, CaptchaState, CaptchaThemeOverride, CaptchaType, } from './components/Captcha';
-export { Captcha, captchaTheme } from './components/Captcha';
+export type { CaptchaAction, CaptchaChallenge, CaptchaConfig, CaptchaDifficulty, CaptchaLabels, CaptchaProps, CaptchaState, CaptchaThemeOverride, CaptchaType, } from './components/Captcha';
+export { Captcha, captchaTheme, DEFAULT_CAPTCHA_LABELS } from './components/Captcha';
 export type { ChangePasswordAction, ChangePasswordFormProps, ChangePasswordHeaderProps, ChangePasswordPageConfig, ChangePasswordStep, } from './components/ChangePasswordPage';
 export { ChangePasswordPage, useChangePasswordStore, } from './components/ChangePasswordPage';
 export type { ChatDirectoryUser, ChatPanelActions, ChatPanelLabels, ChatPanelProps, ChatPanelState, ChatPanelTheme, TypingIndicator as ChatTypingIndicator, UseChatReturn, } from './components/ChatPanel';

package/dist/fe/index.js

@@ -4,7 +4,7 @@ export { AbstractAnimatedBackground } from './components/AbstractAnimatedBackgro
 export { LoginChecker, RoleChecker, useAuthGuardStore, usePermission } from './components/AuthGuard';
 export { AuthorizationPage, authorizationPageTheme, ClaimList, extendAuthorizationPageTheme, RoleClaimEditor, RoleList, useAuthorizationStore } from './components/AuthorizationPage';
 export { Button } from './components/Button';
-export { Captcha, captchaTheme } from './components/Captcha';
+export { Captcha, captchaTheme, DEFAULT_CAPTCHA_LABELS } from './components/Captcha';
 export { ChangePasswordPage, useChangePasswordStore } from './components/ChangePasswordPage';
 // Chat
 export { ChatPanel, chatPanelTheme, DEFAULT_CHAT_LABELS, extendChatPanelTheme, NewConversationModal, useChat, useChatStore } from './components/ChatPanel';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "nucleus-core-ts",
-	"version": "0.9.885",
+	"version": "0.9.886",
 	"description": "Production-ready, enterprise-grade TypeScript framework for building multi-tenant APIs",
 	"author": "Hidayet Can Özcan <hidayetcan@gmail.com>",
 	"license": "SEE LICENSE IN LICENSE",