@nice2dev/ui 1.0.28 → 1.0.30

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. package/CHANGELOG.md +36 -0
  2. package/dist/NiceAssessment.doc-BB1rXcVx.cjs +1 -0
  3. package/dist/NiceAssessment.doc-C3QQawiZ.js +23 -0
  4. package/dist/NiceBackupStatusBadge.doc-Bx2bFmBQ.cjs +1 -0
  5. package/dist/NiceBackupStatusBadge.doc-CdDxIQ-M.js +25 -0
  6. package/dist/NiceConfirmDialog-BiTJVR4-.js +81 -0
  7. package/dist/NiceConfirmDialog-Bjw_rN4o.cjs +1 -0
  8. package/dist/NiceConfirmDialog-DPfYwO2B.js +81 -0
  9. package/dist/NiceConfirmDialog-Dyh42OiK.cjs +1 -0
  10. package/dist/NiceErrorBoundary-1H751jK7.cjs +1 -0
  11. package/dist/NiceErrorBoundary-B-txoU3Y.js +709 -0
  12. package/dist/NiceErrorBoundary-BHCKA1h8.cjs +1 -0
  13. package/dist/NiceErrorBoundary-CBxXcleR.js +695 -0
  14. package/dist/NiceExam.doc-BpTJpwGb.js +23 -0
  15. package/dist/NiceExam.doc-Br8pEbQb.cjs +1 -0
  16. package/dist/NiceForm-C8yEx3VV.cjs +382 -0
  17. package/dist/NiceForm-Ci3XG7s7.js +5000 -0
  18. package/dist/NiceForm-DGUTmaZT.js +5014 -0
  19. package/dist/NiceForm-DmU-gmyv.cjs +382 -0
  20. package/dist/NiceModal-BClAtR5T.js +95 -0
  21. package/dist/NiceModal-Crbhc7GB.cjs +1 -0
  22. package/dist/NiceModal-XvEKVVLa.js +95 -0
  23. package/dist/NiceModal-iKwtagFB.cjs +1 -0
  24. package/dist/NiceModuleLifecyclePanel-BO8Hw_W9.js +7619 -0
  25. package/dist/NiceModuleLifecyclePanel-Ch7HRRoy.cjs +1 -0
  26. package/dist/NiceModuleLifecyclePanel-D3k8kAey.js +7582 -0
  27. package/dist/NiceModuleLifecyclePanel-MAyTh_s5.cjs +1 -0
  28. package/dist/NicePagination-BVo-4KAD.js +172 -0
  29. package/dist/NicePagination-CaohvQsY.cjs +1 -0
  30. package/dist/NicePagination-DUnMbROj.cjs +1 -0
  31. package/dist/NicePagination-DyC6dQ7_.js +171 -0
  32. package/dist/NicePinCodeInput-C43eB9h4.js +13102 -0
  33. package/dist/NicePinCodeInput-DsyLuc0b.cjs +696 -0
  34. package/dist/NicePinCodeInput-nuRCN-9R.js +13223 -0
  35. package/dist/NicePinCodeInput-p5IFVwfY.cjs +696 -0
  36. package/dist/NicePoll.doc-DCiXvOb0.js +23 -0
  37. package/dist/NicePoll.doc-IOgqVPhc.cjs +1 -0
  38. package/dist/NicePollLive.doc-CdUyiCyf.js +23 -0
  39. package/dist/NicePollLive.doc-xBMqHeyt.cjs +1 -0
  40. package/dist/NiceQuiz.doc-BhAeGrcP.cjs +1 -0
  41. package/dist/NiceQuiz.doc-BiZq8X1P.js +23 -0
  42. package/dist/NiceSavedQueryPanel-BBFV4qiF.js +6969 -0
  43. package/dist/NiceSavedQueryPanel-CsiVNkCT.cjs +596 -0
  44. package/dist/NiceSavedQueryPanel-DV4a4axz.cjs +596 -0
  45. package/dist/NiceSavedQueryPanel-Dgbn1ExK.js +6893 -0
  46. package/dist/NiceSurvey.doc-9UorYdXy.cjs +1 -0
  47. package/dist/NiceSurvey.doc-CPF1ZEHo.js +23 -0
  48. package/dist/NiceWindow-BehN3PKk.js +1592 -0
  49. package/dist/NiceWindow-Cm9E6EAi.cjs +1 -0
  50. package/dist/NiceWindow-Dqu9ik8A.cjs +1 -0
  51. package/dist/NiceWindow-FMrVS7zo.js +1603 -0
  52. package/dist/charts-B90sSFeJ.cjs +761 -0
  53. package/dist/charts-CJruxLRY.js +4657 -0
  54. package/dist/charts-D8oj6Nf5.cjs +761 -0
  55. package/dist/charts-DaLf19vS.js +4671 -0
  56. package/dist/charts.cjs +1 -1
  57. package/dist/charts.mjs +1 -1
  58. package/dist/core-BIdbG6p3.js +27212 -0
  59. package/dist/core-BUTtIHg0.js +27766 -0
  60. package/dist/core-CESNSRyS.cjs +122 -0
  61. package/dist/core-bzK0ZnUp.cjs +122 -0
  62. package/dist/data-branching-ByQdcjKO.cjs +1 -0
  63. package/dist/data-branching-BzRFsCJu.js +6133 -0
  64. package/dist/data-branching-DahoQa4M.cjs +1 -0
  65. package/dist/data-branching-psTzlcrT.js +6255 -0
  66. package/dist/data-branching.cjs +1 -1
  67. package/dist/data-branching.mjs +1 -1
  68. package/dist/data.cjs +1 -1
  69. package/dist/data.mjs +1 -1
  70. package/dist/devops-C9gdQxuU.cjs +17 -0
  71. package/dist/devops-CaO_4qGz.js +7684 -0
  72. package/dist/devops-D7bQ3rE4.cjs +17 -0
  73. package/dist/devops-jCmpD6O-.js +8165 -0
  74. package/dist/devops.cjs +1 -1
  75. package/dist/devops.mjs +3 -3
  76. package/dist/editors.cjs +1 -1
  77. package/dist/editors.d.ts +4 -0
  78. package/dist/editors.mjs +3 -3
  79. package/dist/feedback.cjs +1 -1
  80. package/dist/feedback.mjs +3 -3
  81. package/dist/index-BK_Uwmz0.js +67774 -0
  82. package/dist/index-BpixglWg.js +69337 -0
  83. package/dist/index-CTbp81RF.cjs +5517 -0
  84. package/dist/index-DLR-aWZR.cjs +5506 -0
  85. package/dist/index.cjs +1 -1
  86. package/dist/index.css +1 -1
  87. package/dist/index.d.ts +796 -545
  88. package/dist/index.mjs +992 -979
  89. package/dist/lazy.cjs +1 -1
  90. package/dist/lazy.mjs +24 -24
  91. package/dist/navigation.cjs +1 -1
  92. package/dist/navigation.mjs +146 -146
  93. package/dist/no-code-B0mG7OQc.cjs +332 -0
  94. package/dist/no-code-BHo5WrXr.js +7425 -0
  95. package/dist/no-code-CikRvKeJ.js +7133 -0
  96. package/dist/no-code-DyA_1_Th.cjs +332 -0
  97. package/dist/no-code.cjs +1 -1
  98. package/dist/no-code.mjs +1 -1
  99. package/dist/overlays.cjs +1 -1
  100. package/dist/overlays.d.ts +4 -0
  101. package/dist/overlays.mjs +66 -66
  102. package/dist/pickerCommons-BEc3pZ_s.js +2044 -0
  103. package/dist/pickerCommons-CqhXp4QL.js +2043 -0
  104. package/dist/pickerCommons-CrITwM88.cjs +1 -0
  105. package/dist/pickerCommons-OsYJhnFE.cjs +1 -0
  106. package/dist/style.css +1 -1
  107. package/package.json +3 -3
package/dist/index.d.ts CHANGED
@@ -51,6 +51,7 @@ import { createICUTranslator } from '@nice2dev/ui-core';
51
51
  import { createIndexedDBDataSource } from '@nice2dev/ui-core';
52
52
  import { createInfiniteScroll } from '@nice2dev/ui-core';
53
53
  import { createMockDataSource } from '@nice2dev/ui-core';
54
+ import { createNavigationActions } from '@nice2dev/ui-core';
54
55
  import { createNiceReduxMiddleware } from '@nice2dev/ui-core';
55
56
  import { createODataDataSource } from '@nice2dev/ui-core';
56
57
  import { createOfflineFirstDataSource } from '@nice2dev/ui-core';
@@ -88,6 +89,10 @@ import { FormFieldDef } from '@nice2dev/ui-core';
88
89
  import { FormPreferences } from '@nice2dev/ui-core';
89
90
  import { ForwardedRef } from 'react';
90
91
  import { ForwardRefExoticComponent } from 'react';
92
+ import { GamepadAction } from '@nice2dev/ui-core';
93
+ import { GamepadAxis } from '@nice2dev/ui-core';
94
+ import { GamepadButton as GamepadButton_2 } from '@nice2dev/ui-core';
95
+ import { GamepadState } from '@nice2dev/ui-core';
91
96
  import { generateBadgeStyles } from '@nice2dev/ui-core';
92
97
  import { generateButtonStyles } from '@nice2dev/ui-core';
93
98
  import { generateCardStyles } from '@nice2dev/ui-core';
@@ -216,6 +221,8 @@ import { NiceFieldValidationRule } from '@nice2dev/ui-core';
216
221
  import { NiceFilterCondition } from '@nice2dev/ui-core';
217
222
  import { NiceFilterGroup } from '@nice2dev/ui-core';
218
223
  import { NiceFilterOperator } from '@nice2dev/ui-core';
224
+ import { NiceFocusable } from '@nice2dev/ui-core';
225
+ import { NiceFocusableProps } from '@nice2dev/ui-core';
219
226
  import { NiceFormFieldProps } from '@nice2dev/ui-core';
220
227
  import { NiceGraphQLConfig } from '@nice2dev/ui-core';
221
228
  import { NiceHelpIcon } from '@nice2dev/ui-core';
@@ -282,6 +289,9 @@ import { NiceSkipLink } from '@nice2dev/ui-core';
282
289
  import { NiceSkipLinkProps } from '@nice2dev/ui-core';
283
290
  import { NiceSortDirection } from '@nice2dev/ui-core';
284
291
  import { NiceSortExpression } from '@nice2dev/ui-core';
292
+ import { NiceSpatialNavContextValue } from '@nice2dev/ui-core';
293
+ import { NiceSpatialNavProvider } from '@nice2dev/ui-core';
294
+ import { NiceSpatialNavProviderProps } from '@nice2dev/ui-core';
285
295
  import { NiceSqlWhere } from '@nice2dev/ui-core';
286
296
  import { NiceSSEConfig } from '@nice2dev/ui-core';
287
297
  import { NiceSSEDataSource } from '@nice2dev/ui-core';
@@ -391,6 +401,7 @@ import { ShadowVariant } from '@nice2dev/ui-core';
391
401
  import { simulateKeyboard } from '@nice2dev/ui-core';
392
402
  import { simulateType } from '@nice2dev/ui-core';
393
403
  import { sortModelToOrderBy } from '@nice2dev/ui-core';
404
+ import { SpatialFocusableMeta } from '@nice2dev/ui-core';
394
405
  import { startMark } from '@nice2dev/ui-core';
395
406
  import { StorageAdapter } from '@nice2dev/ui-core';
396
407
  import { StorageAuditResult } from '@nice2dev/ui-core';
@@ -549,6 +560,8 @@ import { useDisplayDensity } from '@nice2dev/ui-core';
549
560
  import { useFocusManagement } from '@nice2dev/ui-core';
550
561
  import { useFocusTrap } from '@nice2dev/ui-core';
551
562
  import { useFormGeneration } from '@nice2dev/ui-core';
563
+ import { useGamepad } from '@nice2dev/ui-core';
564
+ import { UseGamepadOptions } from '@nice2dev/ui-core';
552
565
  import { useGridPreferences } from '@nice2dev/ui-core';
553
566
  import { useHaptic } from '@nice2dev/ui-core';
554
567
  import { useInputMode } from '@nice2dev/ui-core';
@@ -610,6 +623,10 @@ import { useSafeTimeout } from '@nice2dev/ui-core';
610
623
  import { useSafeWebSocket } from '@nice2dev/ui-core';
611
624
  import { useShowAt } from '@nice2dev/ui-core';
612
625
  import { UseShowAtOptions } from '@nice2dev/ui-core';
626
+ import { useSpatialFocusable } from '@nice2dev/ui-core';
627
+ import { UseSpatialFocusableOptions } from '@nice2dev/ui-core';
628
+ import { useSpatialNav } from '@nice2dev/ui-core';
629
+ import { useSpatialNavOptional } from '@nice2dev/ui-core';
613
630
  import { useSubmitOnEnter } from '@nice2dev/ui-core';
614
631
  import { UseSubmitOnEnterOptions } from '@nice2dev/ui-core';
615
632
  import { useSwipe } from '@nice2dev/ui-core';
@@ -1087,6 +1104,275 @@ declare interface Assertion {
1087
1104
 
1088
1105
  declare type AssertionMatcher = 'toEqual' | 'toBe' | 'toBeTruthy' | 'toBeFalsy' | 'toBeNull' | 'toBeUndefined' | 'toContain' | 'toHaveLength' | 'toBeInTheDocument' | 'toHaveTextContent' | 'toHaveAttribute' | 'toHaveClass' | 'toHaveStyle' | 'toHaveBeenCalled' | 'toHaveBeenCalledWith' | 'toHaveBeenCalledTimes' | 'toThrow' | 'toMatchSnapshot';
1089
1106
 
1107
+ /** Aggregate (global) results — survey/poll. Display-only; supplied by the host. */
1108
+ export declare interface AssessmentAggregateResults {
1109
+ totalResponses: number;
1110
+ /** Keyed by question id. */
1111
+ perQuestion: Record<string, {
1112
+ responses: number;
1113
+ /** Counts keyed by option id (choice questions). */
1114
+ optionCounts?: Record<string, number>;
1115
+ /** Mean for numeric/rating/scale/nps. */
1116
+ average?: number;
1117
+ /** Collected free-text answers. */
1118
+ textResponses?: string[];
1119
+ }>;
1120
+ }
1121
+
1122
+ export declare interface AssessmentAnswer {
1123
+ questionId: string;
1124
+ value: AssessmentAnswerValue;
1125
+ /** Scored modes: whether the value matched `correctAnswer`. */
1126
+ correct?: boolean;
1127
+ /** Points earned (after partial credit / negative marking). */
1128
+ pointsEarned?: number;
1129
+ /** Seconds spent on the question. */
1130
+ timeSpent?: number;
1131
+ hintsUsed?: number;
1132
+ }
1133
+
1134
+ /** The value a user supplies for a question. */
1135
+ export declare type AssessmentAnswerValue = string | string[] | number | boolean | Record<string, string> | null;
1136
+
1137
+ export declare interface AssessmentContext {
1138
+ mode: AssessmentMode;
1139
+ /** All answers so far, keyed by question id. */
1140
+ answers: Record<string, AssessmentAnswerValue>;
1141
+ setAnswer: (questionId: string, value: AssessmentAnswerValue) => void;
1142
+ getAnswer: (questionId: string) => AssessmentAnswerValue;
1143
+ currentPage: AssessmentPage;
1144
+ currentIndex: number;
1145
+ totalPages: number;
1146
+ isFirst: boolean;
1147
+ isLast: boolean;
1148
+ /** 0–100 progress. */
1149
+ progress: number;
1150
+ goNext: () => void;
1151
+ goPrev: () => void;
1152
+ goTo: (pageId: string) => void;
1153
+ skip: () => void;
1154
+ submit: () => void;
1155
+ /** Running score (scored modes). */
1156
+ result: AssessmentResult | null;
1157
+ /** Remaining seconds for the active timer, or `null`. */
1158
+ timeLeft: number | null;
1159
+ t: (key: string, defaultValue: string) => string;
1160
+ }
1161
+
1162
+ /** When correctness/explanations are revealed. */
1163
+ declare type AssessmentFeedback = 'none' | 'immediate' | 'after-page' | 'at-end';
1164
+
1165
+ /** Keys for {@link NiceAssessmentProps.labels}. */
1166
+ declare type AssessmentLabelKey = 'next' | 'prev' | 'skip' | 'submit' | 'finish' | 'retry' | 'review' | 'exit' | 'start' | 'correct' | 'incorrect' | 'passed' | 'failed' | 'score' | 'timeUp' | 'questionOf' | 'results' | 'hint';
1167
+
1168
+ /** Page rendering layout. */
1169
+ declare type AssessmentLayout = 'one-per-page' | 'all-at-once' | 'paginated';
1170
+
1171
+ /** Quiz gamification lifelines. */
1172
+ declare type AssessmentLifeline = 'fiftyFifty' | 'hint' | 'skipQuestion' | 'extraTime';
1173
+
1174
+ /**
1175
+ * Behaviour profile.
1176
+ * - `quiz` — correct answers + scoring, optional immediate feedback / gamification.
1177
+ * - `exam` — timed, locked navigation, feedback withheld until the end, pass threshold.
1178
+ * - `survey` — no scoring; collects responses and can display aggregate results.
1179
+ * - `poll` — one / few questions; live aggregate.
1180
+ */
1181
+ export declare type AssessmentMode = 'quiz' | 'exam' | 'survey' | 'poll';
1182
+
1183
+ /** A selectable option for choice-style questions. */
1184
+ export declare interface AssessmentOption {
1185
+ id: string;
1186
+ /** Option label — any node (text, image, formula, …). */
1187
+ label: ReactNode;
1188
+ /** Optional leading media/icon. */
1189
+ media?: ReactNode;
1190
+ /** Per-option weight for partial-credit / weighted multi-select scoring. */
1191
+ weight?: number;
1192
+ /** For `matching` / `dragMatch`: the id of the target this option pairs with. */
1193
+ matchTargetId?: string;
1194
+ }
1195
+
1196
+ /**
1197
+ * A page in the flow. Mirrors {@link SetupWizardStep}: it may render **arbitrary
1198
+ * content** and/or carry one or more questions. With `layout="one-per-page"` a page
1199
+ * is typically one question; `all-at-once` renders every page's questions together.
1200
+ */
1201
+ export declare interface AssessmentPage {
1202
+ id: string;
1203
+ title?: string;
1204
+ subtitle?: string;
1205
+ /** Section/group this page belongs to (for sectioned scoring + steppers). */
1206
+ section?: string;
1207
+ /** Free-form content — any node, or a render fn given the live context. */
1208
+ content?: ReactNode | ((ctx: AssessmentContext) => ReactNode);
1209
+ /** Questions on this page. */
1210
+ questions?: AssessmentQuestion[];
1211
+ /** Per-page time limit (seconds). */
1212
+ timeLimit?: number;
1213
+ /** Adaptive branching: resolve the next page id from current answers/score. */
1214
+ nextPage?: string | ((ctx: AssessmentContext) => string | undefined);
1215
+ /** Show this page only when the predicate holds (against current answers). */
1216
+ showWhen?: (answers: Record<string, AssessmentAnswerValue>) => boolean;
1217
+ }
1218
+
1219
+ /** Random pool selection (question bank): pick `count` of the available questions. */
1220
+ declare interface AssessmentPool {
1221
+ count: number;
1222
+ /** Limit the draw to a section id. */
1223
+ section?: string;
1224
+ }
1225
+
1226
+ /** Props for a preset: everything except `mode` (fixed by the preset). */
1227
+ export declare type AssessmentPresetProps = Omit<NiceAssessmentProps, 'mode'>;
1228
+
1229
+ /** A question. `correctAnswer` is omitted in survey/poll mode. */
1230
+ export declare interface AssessmentQuestion {
1231
+ id: string;
1232
+ type: AssessmentQuestionType;
1233
+ /** The question prompt — any node. */
1234
+ prompt: ReactNode;
1235
+ /** Optional media shown with the prompt (image/video/formula/presentation/…). */
1236
+ media?: ReactNode;
1237
+ /** Help text shown under the prompt. */
1238
+ description?: ReactNode;
1239
+ /** Options for choice / ordering / matching questions. */
1240
+ options?: AssessmentOption[];
1241
+ /** Targets for matching / dragMatch / hotspot / fillBlank. */
1242
+ targets?: AssessmentTarget[];
1243
+ /**
1244
+ * Correct answer (scored modes only). Shape depends on `type`:
1245
+ * option id | id[] | boolean | string | number | ordered id[] |
1246
+ * `Record<targetId, optionId>` (matching/dragMatch) | `string[]` (fillBlank).
1247
+ */
1248
+ correctAnswer?: AssessmentAnswerValue;
1249
+ /** Points awarded for a fully-correct answer. Default `1`. */
1250
+ points?: number;
1251
+ /** Award proportional credit for partially-correct multi answers. Default `false`. */
1252
+ partialCredit?: boolean;
1253
+ /** Subtract points for wrong answers (guards against guessing). Default `false`. */
1254
+ negativeMarking?: boolean;
1255
+ /** Whether the question must be answered to advance. */
1256
+ required?: boolean;
1257
+ /** Shown after answering (immediate feedback) or in review. */
1258
+ explanation?: ReactNode;
1259
+ /** A hint, revealable via the `hint` lifeline (quiz). */
1260
+ hint?: ReactNode;
1261
+ /** Shuffle this question's options (overrides the assessment-level flag). */
1262
+ shuffleOptions?: boolean;
1263
+ /** Difficulty tag (quiz gamification / analytics). */
1264
+ difficulty?: 'easy' | 'medium' | 'hard';
1265
+ /** Per-question time limit (seconds). */
1266
+ timeLimit?: number;
1267
+ /** Min/max for `number` / `scale` / `nps`. */
1268
+ min?: number;
1269
+ max?: number;
1270
+ /** Free-form metadata (category, tags, …); not interpreted by the engine. */
1271
+ meta?: Record<string, unknown>;
1272
+ }
1273
+
1274
+ /** Per-question outcome in the result breakdown. */
1275
+ declare interface AssessmentQuestionResult {
1276
+ questionId: string;
1277
+ correct: boolean;
1278
+ pointsEarned: number;
1279
+ pointsMax: number;
1280
+ value: AssessmentAnswerValue;
1281
+ }
1282
+
1283
+ /** All built-in question types. Custom types resolve via `questionRenderers`. */
1284
+ export declare type AssessmentQuestionType = 'single' | 'multiple' | 'trueFalse' | 'text' | 'longText' | 'number' | 'rating' | 'scale' | 'likert' | 'nps' | 'ordering' | 'matching' | 'fillBlank' | 'hotspot' | 'dragMatch' | 'date' | 'time';
1285
+
1286
+ /** Final result for scored modes (quiz/exam). */
1287
+ export declare interface AssessmentResult {
1288
+ totalQuestions: number;
1289
+ answered: number;
1290
+ correct: number;
1291
+ pointsEarned: number;
1292
+ pointsMax: number;
1293
+ /** 0–100. */
1294
+ percentage: number;
1295
+ passed: boolean;
1296
+ timeTaken: number;
1297
+ /** Subscore per section id. */
1298
+ perSection: Record<string, {
1299
+ pointsEarned: number;
1300
+ pointsMax: number;
1301
+ percentage: number;
1302
+ }>;
1303
+ perQuestion: AssessmentQuestionResult[];
1304
+ }
1305
+
1306
+ export declare interface AssessmentScoringConfig {
1307
+ /** Pass threshold as a percentage 0–100. Default `60`. */
1308
+ passThreshold?: number;
1309
+ /** Honour per-question/per-option `weight`. Default `true`. */
1310
+ weighted?: boolean;
1311
+ /** Default partial-credit for multi-answer questions (per-question prop wins). */
1312
+ partialCredit?: boolean;
1313
+ /** Default negative marking (per-question prop wins). */
1314
+ negativeMarking?: boolean;
1315
+ /** Clamp the total to ≥ 0 when negative marking is on. Default `true`. */
1316
+ clampToZero?: boolean;
1317
+ }
1318
+
1319
+ /** A section groups pages for subscores + stepper labels. */
1320
+ export declare interface AssessmentSection {
1321
+ id: string;
1322
+ title: string;
1323
+ timeLimit?: number;
1324
+ }
1325
+
1326
+ /** A submission payload (survey/poll, or any mode's raw answers). */
1327
+ export declare interface AssessmentSubmission {
1328
+ assessmentId: string;
1329
+ participantId?: string;
1330
+ answers: AssessmentAnswer[];
1331
+ submittedAt: string;
1332
+ totalTime: number;
1333
+ completed: boolean;
1334
+ /** Present for scored modes. */
1335
+ result?: AssessmentResult;
1336
+ }
1337
+
1338
+ /** A drop target / blank id for `matching`, `dragMatch`, `fillBlank`, `hotspot`. */
1339
+ export declare interface AssessmentTarget {
1340
+ id: string;
1341
+ label?: ReactNode;
1342
+ /** Hotspot bounding box (percent of image), e.g. `{ x: 10, y: 20, w: 15, h: 10 }`. */
1343
+ rect?: {
1344
+ x: number;
1345
+ y: number;
1346
+ w: number;
1347
+ h: number;
1348
+ };
1349
+ }
1350
+
1351
+ export declare interface AssessmentTimerConfig {
1352
+ /** Whole-assessment limit (seconds). */
1353
+ total?: number;
1354
+ /** Default per-question limit (seconds) — `question.timeLimit` overrides. */
1355
+ perQuestion?: number;
1356
+ /** Auto-advance when a per-question timer expires. Default `false`. */
1357
+ autoAdvance?: boolean;
1358
+ }
1359
+
1360
+ export declare type AssessmentWidget = (props: AssessmentWidgetProps) => ReactNode;
1361
+
1362
+ declare interface AssessmentWidgetProps {
1363
+ question: AssessmentQuestion;
1364
+ value: AssessmentAnswerValue;
1365
+ onChange: (value: AssessmentAnswerValue) => void;
1366
+ /** Reveal correctness (immediate feedback / review). */
1367
+ revealed?: boolean;
1368
+ disabled?: boolean;
1369
+ size?: NiceSize;
1370
+ t: (key: string, defaultValue: string) => string;
1371
+ }
1372
+
1373
+ /** Map of question type → renderer; merged over the built-ins. */
1374
+ export declare type AssessmentWidgetRegistry = Partial<Record<AssessmentQuestionType, AssessmentWidget>>;
1375
+
1090
1376
  /** Collection */
1091
1377
  export declare interface AssetCollection {
1092
1378
  id: string;
@@ -2817,6 +3103,8 @@ export { createMockDataSource }
2817
3103
 
2818
3104
  export declare function createMockLiveChartSource(config: MockLiveChartSourceConfig): LiveChartDataSource;
2819
3105
 
3106
+ export { createNavigationActions }
3107
+
2820
3108
  export { createNiceReduxMiddleware }
2821
3109
 
2822
3110
  export { createODataDataSource }
@@ -4951,6 +5239,14 @@ export declare interface FuzzyMatch {
4951
5239
 
4952
5240
  export declare function fuzzyMatch(query: string, text: string): FuzzyMatch | null;
4953
5241
 
5242
+ export { GamepadAction }
5243
+
5244
+ export { GamepadAxis }
5245
+
5246
+ export { GamepadButton_2 as GamepadButton }
5247
+
5248
+ export { GamepadState }
5249
+
4954
5250
  /**
4955
5251
  * Gap analysis item.
4956
5252
  */
@@ -5561,9 +5857,10 @@ declare interface InboxComposeData {
5561
5857
  }
5562
5858
 
5563
5859
  /** A folder/label in the inbox. */
5564
- declare interface InboxFolder {
5860
+ export declare interface InboxFolder {
5565
5861
  id: string;
5566
5862
  name: string;
5863
+ /** NiceIcon name (from the built-in @nice2dev/ui-core icon set), e.g. `'mail'`, `'star'`, `'trash'`. */
5567
5864
  icon?: string;
5568
5865
  count?: number;
5569
5866
  }
@@ -7381,6 +7678,51 @@ export declare interface NiceAppManifest {
7381
7678
  tenantId?: string;
7382
7679
  }
7383
7680
 
7681
+ /**
7682
+ * {@link NiceAppShell} — reusable app chrome for richer, IDE/DAW-style tools:
7683
+ * a menubar, a tools toolbar, an optional sidebar, the content area and a status
7684
+ * bar. Built to be composed with `NiceMenu`, `NiceToolbar` and the content of
7685
+ * your choice (e.g. `NiceAudioStudio` builds on it).
7686
+ */
7687
+ export declare const NiceAppShell: default_2.ForwardRefExoticComponent<NiceAppShellProps & default_2.RefAttributes<HTMLDivElement>>;
7688
+
7689
+ /**
7690
+ * Props for {@link NiceAppShell} — a generic desktop-application frame
7691
+ * (menubar → toolbar → [sidebar | content] → status bar). Each region is an
7692
+ * optional slot; compose the menubar from a horizontal `NiceMenu` and the
7693
+ * toolbar from `NiceToolbar`. Theme-tokened and responsive.
7694
+ */
7695
+ export declare interface NiceAppShellProps extends NiceBaseProps {
7696
+ /** Top menubar row — typically a horizontal `NiceMenu` (File / Edit / View / Help). */
7697
+ menubar?: default_2.ReactNode;
7698
+ /** Tools toolbar row, below the menubar — typically a `NiceToolbar`. */
7699
+ toolbar?: default_2.ReactNode;
7700
+ /** Optional left sidebar (panels, track list, tool palette / tool rail). */
7701
+ sidebar?: default_2.ReactNode;
7702
+ /** Sidebar width in px. Default 220. */
7703
+ sidebarWidth?: number;
7704
+ /** Optional right panel (properties / inspector). */
7705
+ rightSidebar?: default_2.ReactNode;
7706
+ /** Right-panel width in px. Default 280. */
7707
+ rightSidebarWidth?: number;
7708
+ /** Main content area. */
7709
+ children?: default_2.ReactNode;
7710
+ /** Optional bottom panel between the content and the status bar (timeline, console, output). */
7711
+ bottomPanel?: default_2.ReactNode;
7712
+ /** Bottom-panel height in px. When omitted, the panel's own content drives its height. */
7713
+ bottomPanelHeight?: number;
7714
+ /** Bottom status bar. */
7715
+ statusBar?: default_2.ReactNode;
7716
+ /** Overall height (px or CSS value). Default `'100%'`. */
7717
+ height?: number | string;
7718
+ /**
7719
+ * Render the side panels "flush" — no shell padding/background/border and no
7720
+ * forced width, so a self-styled panel (e.g. an editor tool-rail / inspector)
7721
+ * controls its own look and size. Default false.
7722
+ */
7723
+ flush?: boolean;
7724
+ }
7725
+
7384
7726
  export { NiceAriaProps }
7385
7727
 
7386
7728
  export { NiceArrayDataSourceConfig }
@@ -7405,6 +7747,101 @@ export declare interface NiceAspectRatioProps extends NiceStandardProps {
7405
7747
  maxWidth?: number | string;
7406
7748
  }
7407
7749
 
7750
+ export declare const NiceAssessment: default_2.ForwardRefExoticComponent<NiceAssessmentProps & default_2.RefAttributes<HTMLDivElement>>;
7751
+
7752
+ export declare interface NiceAssessmentProps {
7753
+ /** Behaviour profile. Presets (`NiceQuiz`/`NiceExam`/`NiceSurvey`/`NicePoll`) set this. */
7754
+ mode?: AssessmentMode;
7755
+ /** Stable id (persistence, submissions, aria). */
7756
+ id?: string;
7757
+ /** Title / description shown on the intro/header. */
7758
+ title?: ReactNode;
7759
+ description?: ReactNode;
7760
+ /** Pages (preferred) — full control over content + questions per page. */
7761
+ pages?: AssessmentPage[];
7762
+ /** Shorthand: a flat question list (each becomes a one-question page). */
7763
+ questions?: AssessmentQuestion[];
7764
+ /** Section definitions (for subscores + steppers). */
7765
+ sections?: AssessmentSection[];
7766
+ /** Page layout. Default `one-per-page`. */
7767
+ layout?: AssessmentLayout;
7768
+ size?: NiceSize;
7769
+ /**
7770
+ * Self-applied theme (preset name or {@link NiceTheme}) — wraps in a scoped
7771
+ * `NiceThemeProvider` so it themes correctly outside an app provider. Omit when
7772
+ * already inside one.
7773
+ */
7774
+ theme?: NiceTheme | string;
7775
+ /** Scoring config (quiz/exam). */
7776
+ scoring?: AssessmentScoringConfig;
7777
+ /** Timer config. */
7778
+ timer?: AssessmentTimerConfig;
7779
+ /** When feedback (correctness/explanations) is shown. Mode-dependent default. */
7780
+ feedback?: AssessmentFeedback;
7781
+ /** Lock navigation to forward-only (exam). Default depends on mode. */
7782
+ lockNavigation?: boolean;
7783
+ /** Allow going back. Default `true` (except exam). */
7784
+ allowBack?: boolean;
7785
+ /** Allow skipping non-required questions. Default `true` (except exam). */
7786
+ allowSkip?: boolean;
7787
+ /** Allow retrying a wrong answer (quiz). Default `false`. */
7788
+ allowRetry?: boolean;
7789
+ /** Lives — quiz gamification (0/undefined = unlimited). */
7790
+ lives?: number;
7791
+ /** Available lifelines (quiz). */
7792
+ lifelines?: AssessmentLifeline[];
7793
+ /** Show a review screen with explanations after completion. Default `true` (scored). */
7794
+ review?: boolean;
7795
+ /** Reveal the correct answer in review/feedback. Default `true` (quiz), `false` (exam until released). */
7796
+ revealCorrect?: boolean;
7797
+ /** Shuffle questions / options. */
7798
+ shuffleQuestions?: boolean;
7799
+ shuffleOptions?: boolean;
7800
+ /** Deterministic shuffle/pool seed (reproducible). */
7801
+ randomizeSeed?: string | number;
7802
+ /** Random pool selection (question bank). */
7803
+ pool?: AssessmentPool;
7804
+ /** Show the progress bar. Default `true`. */
7805
+ showProgress?: boolean;
7806
+ /** Show question numbers. Default `true`. */
7807
+ showNumbers?: boolean;
7808
+ /** Persist answers/progress to localStorage under this key (resume). */
7809
+ persistKey?: string;
7810
+ /** Aggregate results to display (survey/poll). */
7811
+ results?: AssessmentAggregateResults;
7812
+ /** Async fetch of aggregate results (survey/poll) — called after submit. */
7813
+ fetchAggregateResults?: (submission: AssessmentSubmission) => Promise<AssessmentAggregateResults>;
7814
+ /** Show aggregate charts after submitting (survey/poll). Default `true` when results available. */
7815
+ showAggregate?: boolean;
7816
+ /** Certificate config (exam pass) — `onExport`/built-in. */
7817
+ certificate?: {
7818
+ enabled?: boolean;
7819
+ title?: string;
7820
+ recipient?: string;
7821
+ };
7822
+ /** Custom export hook for result/certificate (PDF/CSV/… by the host). */
7823
+ onExport?: (result: AssessmentResult, submission: AssessmentSubmission) => void;
7824
+ /** Override / add question-type renderers. */
7825
+ questionRenderers?: AssessmentWidgetRegistry;
7826
+ /** Branding / header / footer slots. */
7827
+ branding?: ReactNode;
7828
+ header?: ReactNode;
7829
+ footer?: ReactNode;
7830
+ /** Callbacks. */
7831
+ onAnswer?: (answer: AssessmentAnswer) => void;
7832
+ onPageChange?: (pageId: string, index: number) => void;
7833
+ onComplete?: (result: AssessmentResult) => void | Promise<void>;
7834
+ onSubmit?: (submission: AssessmentSubmission) => void | Promise<void>;
7835
+ onTimeout?: (scope: 'total' | 'page' | 'question') => void;
7836
+ onExit?: () => void;
7837
+ /** Custom labels (i18n-overridable). */
7838
+ labels?: Partial<Record<AssessmentLabelKey, string>>;
7839
+ accessMode?: NiceAccessMode;
7840
+ className?: string;
7841
+ style?: React.CSSProperties;
7842
+ 'data-testid'?: string;
7843
+ }
7844
+
7408
7845
  export declare type NiceAuditAction = 'create' | 'update' | 'delete' | 'view' | 'export' | 'import' | 'login' | 'logout' | 'custom';
7409
7846
 
7410
7847
  export declare interface NiceAuditEntry {
@@ -7625,13 +8062,30 @@ export declare const NiceAvatar: default_2.FC<NiceAvatarProps>;
7625
8062
 
7626
8063
  export declare const NiceAvatarGroup: default_2.FC<NiceAvatarGroupProps>;
7627
8064
 
7628
- /** Props for the {@link NiceAvatarGroup} component — stacks multiple {@link NiceAvatar} elements with a "+N" overflow indicator. */
8065
+ /** A single data-driven avatar in a {@link NiceAvatarGroup}. */
8066
+ declare interface NiceAvatarGroupItem {
8067
+ /** Image URL. When omitted, initials from `name` are shown. */
8068
+ src?: string;
8069
+ /** Display name (used for initials, alt text and the title tooltip). */
8070
+ name?: string;
8071
+ /** Makes the avatar a link to this URL. */
8072
+ href?: string;
8073
+ /** Click handler (makes the avatar a button when there is no `href`). */
8074
+ onClick?: () => void;
8075
+ }
8076
+
8077
+ /** Props for the {@link NiceAvatarGroup} component — stacks multiple avatars with a "+N" overflow indicator. */
7629
8078
  export declare interface NiceAvatarGroupProps extends NiceStandardProps {
7630
- /** Avatar group size. */
8079
+ /** Avatar group size — propagated to every avatar (and the +N chip). */
7631
8080
  size?: NiceSize;
7632
- /** NiceAvatar elements to display. */
7633
- children: default_2.ReactNode;
7634
- /** Maximum visible avatars before the overflow counter appears. */
8081
+ /** NiceAvatar elements to display (alternative to `items`). */
8082
+ children?: default_2.ReactNode;
8083
+ /**
8084
+ * Data-driven avatars (alternative to `children`). Each entry can be made
8085
+ * clickable via `href` (link) or `onClick` (button).
8086
+ */
8087
+ items?: NiceAvatarGroupItem[];
8088
+ /** Maximum visible avatars before the "+N" overflow counter appears. */
7635
8089
  max?: number;
7636
8090
  }
7637
8091
 
@@ -7817,19 +8271,31 @@ export declare interface NiceBadgeProps extends NiceStandardProps {
7817
8271
  dot?: boolean;
7818
8272
  /** Render with an outlined border instead of a filled background. */
7819
8273
  outline?: boolean;
8274
+ /** Soft tinted background with accent-coloured text (instead of a solid fill). */
8275
+ subtle?: boolean;
8276
+ /** Gently pulse to draw attention (e.g. live status). Respects prefers-reduced-motion. */
8277
+ pulse?: boolean;
8278
+ /** Optional icon rendered before the content. */
8279
+ icon?: default_2.ReactNode;
7820
8280
  /** Show a remove ("x") button inside the badge. */
7821
8281
  removable?: boolean;
7822
8282
  /** Called when the remove button is clicked. */
7823
8283
  onRemove?: () => void;
7824
8284
  }
7825
8285
 
8286
+ export declare const NiceBarcode: ForwardRefExoticComponent<NiceBarcodeProps & RefAttributes<HTMLCanvasElement>>;
8287
+
7826
8288
  /** Supported barcode symbologies. */
7827
8289
  export declare type NiceBarcodeFormat = 'CODE128' | 'CODE39' | 'EAN13' | 'EAN8' | 'UPC' | 'ITF14' | 'MSI' | 'codabar';
7828
8290
 
7829
- export declare const NiceBarcodeGenerator: ForwardRefExoticComponent<NiceBarcodeGeneratorProps & RefAttributes<HTMLCanvasElement>>;
8291
+ /** @deprecated Renamed to {@link NiceBarcode}. Kept as an alias for backward compatibility. */
8292
+ export declare const NiceBarcodeGenerator: ForwardRefExoticComponent<NiceBarcodeProps & RefAttributes<HTMLCanvasElement>>;
7830
8293
 
7831
- /** Props for the {@link NiceBarcodeGenerator} component — renders a barcode on a `<canvas>`. */
7832
- export declare interface NiceBarcodeGeneratorProps extends NiceStandardProps {
8294
+ /** @deprecated Renamed to {@link NiceBarcodeProps}. */
8295
+ export declare type NiceBarcodeGeneratorProps = NiceBarcodeProps;
8296
+
8297
+ /** Props for the {@link NiceBarcode} component — renders a barcode on a `<canvas>`. */
8298
+ export declare interface NiceBarcodeProps extends NiceStandardProps {
7833
8299
  /** Text value to encode. */
7834
8300
  value: string;
7835
8301
  /** Barcode symbology (default CODE128). */
@@ -7850,6 +8316,15 @@ export declare interface NiceBarcodeGeneratorProps extends NiceStandardProps {
7850
8316
  fontSize?: number;
7851
8317
  /** Component size preset. */
7852
8318
  size?: NiceSize;
8319
+ /**
8320
+ * Render an editable {@link NiceTextInput} above the barcode that live-encodes
8321
+ * what the user types. Off by default — pass `showInput` to enable.
8322
+ */
8323
+ showInput?: boolean;
8324
+ /** Label for the built-in input (only when `showInput`). */
8325
+ inputLabel?: string;
8326
+ /** Placeholder for the built-in input (only when `showInput`). */
8327
+ inputPlaceholder?: string;
7853
8328
  }
7854
8329
 
7855
8330
  export declare const NiceBarGauge: default_2.FC<NiceBarGaugeProps>;
@@ -7923,6 +8398,10 @@ export declare interface NiceBlockUIProps extends NiceBaseProps {
7923
8398
  blocked: boolean;
7924
8399
  /** Custom overlay message or spinner. */
7925
8400
  message?: default_2.ReactNode;
8401
+ /** Show a built-in loading spinner above the message. */
8402
+ spinner?: boolean;
8403
+ /** Blur the blocked content beneath the overlay. */
8404
+ blur?: boolean;
7926
8405
  /** Content to be blocked. */
7927
8406
  children: default_2.ReactNode;
7928
8407
  }
@@ -8106,8 +8585,15 @@ declare type NiceBulletState = 'normal' | 'loading' | 'error';
8106
8585
  */
8107
8586
  export declare const NiceBusinessCard: default_2.ForwardRefExoticComponent<NiceBusinessCardProps & default_2.RefAttributes<HTMLDivElement>>;
8108
8587
 
8109
- /** Props for the {@link NiceBusinessCard} component. */
8110
- export declare interface NiceBusinessCardProps extends NiceFormFieldProps {
8588
+ /**
8589
+ * Props for the {@link NiceBusinessCard} component.
8590
+ *
8591
+ * NiceBusinessCard is a display component, not a form input — it deliberately
8592
+ * does NOT extend `NiceFormFieldProps` so the showcase catalog does not surface
8593
+ * input-only STATE toggles (disabled/readOnly/loading/error) for it. The few
8594
+ * state-ish props below exist only for the optional inline-edit mode.
8595
+ */
8596
+ export declare interface NiceBusinessCardProps {
8111
8597
  /** Business entity data. */
8112
8598
  data: BusinessCardData;
8113
8599
  /** Whether to render in edit mode. */
@@ -8124,6 +8610,22 @@ export declare interface NiceBusinessCardProps extends NiceFormFieldProps {
8124
8610
  showLogo?: boolean;
8125
8611
  /** Whether to show bank details. */
8126
8612
  showBankDetails?: boolean;
8613
+ /** Card size (scales fonts and spacing). */
8614
+ size?: NiceSize;
8615
+ /** Optional caption rendered by a consuming form layout. */
8616
+ label?: default_2.ReactNode;
8617
+ /** Helper text rendered under the card. */
8618
+ helperText?: default_2.ReactNode;
8619
+ /** Error message rendered under the card. */
8620
+ error?: string | boolean;
8621
+ /** Dim the card and disable inputs while in edit mode. */
8622
+ disabled?: boolean;
8623
+ /** Read-only — hides the edit toggle. */
8624
+ readOnly?: boolean;
8625
+ className?: string;
8626
+ style?: default_2.CSSProperties;
8627
+ accessMode?: NiceAccessMode;
8628
+ id?: string;
8127
8629
  }
8128
8630
 
8129
8631
  export declare const NiceButton: default_2.ForwardRefExoticComponent<NiceButtonProps & default_2.RefAttributes<HTMLButtonElement>>;
@@ -8185,6 +8687,8 @@ export declare interface NiceButtonProps extends NiceBaseProps {
8185
8687
  error?: default_2.ReactNode;
8186
8688
  /** Where to display the error: 'bottom' (default) or 'right'. */
8187
8689
  errorPlacement?: 'bottom' | 'right';
8690
+ /** Accessible label — applied as `aria-label` (use for icon-only buttons). */
8691
+ ariaLabel?: string;
8188
8692
  }
8189
8693
 
8190
8694
  export { NiceCacheConfig }
@@ -8279,6 +8783,29 @@ export declare interface NiceCardGridProps extends NiceStandardProps {
8279
8783
  hoverable?: boolean;
8280
8784
  }
8281
8785
 
8786
+ /**
8787
+ * {@link NiceCardGroup} — themed, responsive CSS-grid layout for a set of cards.
8788
+ */
8789
+ export declare const NiceCardGroup: default_2.ForwardRefExoticComponent<NiceCardGroupProps & default_2.RefAttributes<HTMLDivElement>>;
8790
+
8791
+ /**
8792
+ * Props for {@link NiceCardGroup} — a responsive grid container for cards (or any
8793
+ * tiles). By default it auto-fills as many `minColumnWidth`-wide columns as fit
8794
+ * and wraps responsively; pass `columns` to pin an exact column count.
8795
+ */
8796
+ export declare interface NiceCardGroupProps extends NiceStandardProps {
8797
+ /** Cards / tiles to lay out. */
8798
+ children: default_2.ReactNode;
8799
+ /** Minimum column width (px) for the auto-fill grid. Default 240. */
8800
+ minColumnWidth?: number;
8801
+ /** Fixed column count — overrides `minColumnWidth` auto-fill when set. */
8802
+ columns?: number;
8803
+ /** Gap between cards (px). Default 12. */
8804
+ gap?: number;
8805
+ /** Vertical alignment of items within a row. */
8806
+ align?: 'stretch' | 'start' | 'center' | 'end';
8807
+ }
8808
+
8282
8809
  /** Props for the {@link NiceCard} component — a bordered content container with optional header and footer. */
8283
8810
  export declare interface NiceCardProps extends NiceBaseProps {
8284
8811
  /** Card size. */
@@ -9261,6 +9788,10 @@ export declare interface NiceColorPickerProps extends NiceFormFieldProps {
9261
9788
  /** When true, the popup includes an alpha (transparency) slider and the
9262
9789
  * emitted value uses 8-character hex `#RRGGBBAA`. Default: `false`. */
9263
9790
  withAlpha?: boolean;
9791
+ /** Compact inline layout: swatch + hex on a single tight row and the
9792
+ * "Random" button hidden, so many fields can sit side-by-side in a grid.
9793
+ * Default: `false`. */
9794
+ compact?: boolean;
9264
9795
  }
9265
9796
 
9266
9797
  export declare type NiceColorPreset = 'lightest-pastel' | 'bright-pastel' | 'shiny' | 'pastel' | 'full' | 'dark' | 'deep' | 'muted' | 'earth';
@@ -11060,6 +11591,82 @@ export declare interface NiceDeviceControlCardProps extends NiceBaseProps {
11060
11591
  controlLayout?: ControlLayout;
11061
11592
  }
11062
11593
 
11594
+ export declare type NiceDeviceKind = 'microphone' | 'gamepad';
11595
+
11596
+ export declare type NiceDeviceLabelPlacement = 'top' | 'bottom' | 'left' | 'right';
11597
+
11598
+ export declare const NiceDeviceManager: default_2.FC<NiceDeviceManagerProps>;
11599
+
11600
+ export declare interface NiceDeviceManagerProps extends NiceBaseProps {
11601
+ devices?: NiceManagedDevice[];
11602
+ defaultDevices?: NiceManagedDevice[];
11603
+ onDevicesChange?: (devices: NiceManagedDevice[]) => void;
11604
+ /** Auto-detect connected mics + gamepads (default true). */
11605
+ autoDetect?: boolean;
11606
+ /** Which device kinds to manage (default both). */
11607
+ kinds?: NiceDeviceKind[];
11608
+ /** Slots (players/roles) devices can be assigned to. */
11609
+ slots?: NiceDeviceSlot[];
11610
+ onAssign?: (deviceId: string, slotId: string | null) => void;
11611
+ onOpenConfig?: (device: NiceManagedDevice) => void;
11612
+ columns?: number;
11613
+ minColumnWidth?: number;
11614
+ }
11615
+
11616
+ export declare interface NiceDeviceSlot {
11617
+ id: string;
11618
+ label: string;
11619
+ color?: string;
11620
+ }
11621
+
11622
+ export declare const NiceDeviceTile: default_2.ForwardRefExoticComponent<NiceDeviceTileProps & default_2.RefAttributes<HTMLDivElement>>;
11623
+
11624
+ export declare interface NiceDeviceTileProps extends NiceBaseProps {
11625
+ /** The device SVG (microphone / gamepad). */
11626
+ children: default_2.ReactNode;
11627
+ /** Primary label (line 1, small). */
11628
+ name?: string;
11629
+ /** Secondary label (line 2, very small) — also editable from the popover. */
11630
+ description?: string;
11631
+ defaultDescription?: string;
11632
+ onDescriptionChange?: (text: string) => void;
11633
+ /** Caption placement relative to the device (default 'bottom', centered). */
11634
+ labelPlacement?: NiceDeviceLabelPlacement;
11635
+ /** Index/number badge shown on the tile. */
11636
+ number?: number | string;
11637
+ /** Device tint. Default `'transparent'` → only the device outline shows. */
11638
+ color?: string;
11639
+ onColorChange?: (color: string) => void;
11640
+ volume?: number;
11641
+ defaultVolume?: number;
11642
+ onVolumeChange?: (v: number) => void;
11643
+ gain?: number;
11644
+ defaultGain?: number;
11645
+ onGainChange?: (v: number) => void;
11646
+ /** Enable the right-click quick-settings popover (default true). */
11647
+ contextMenu?: boolean;
11648
+ /** Which quick controls appear in the popover. */
11649
+ quickControls?: NiceDeviceTileQuickControls;
11650
+ /** "Full configuration" button handler (omit to hide the button). */
11651
+ onOpenConfig?: () => void;
11652
+ fullConfigLabel?: string;
11653
+ selected?: boolean;
11654
+ onClick?: () => void;
11655
+ /** Register with a surrounding NiceSpatialNavProvider under this id. */
11656
+ focusId?: string;
11657
+ }
11658
+
11659
+ export declare interface NiceDeviceTileQuickControls {
11660
+ /** Show the color picker row (default true). */
11661
+ color?: boolean;
11662
+ /** Show the description field (default true). */
11663
+ description?: boolean;
11664
+ /** Show the volume slider (default true). */
11665
+ volume?: boolean;
11666
+ /** Show the gain slider (default true). */
11667
+ gain?: boolean;
11668
+ }
11669
+
11063
11670
  export declare function NiceDiagramDesigner({ initialSchema, onChange, onExport, className, style, tutorial, }: NiceDiagramDesignerProps): JSX.Element;
11064
11671
 
11065
11672
  export declare interface NiceDiagramDesignerProps {
@@ -11885,6 +12492,13 @@ export declare interface NiceEventOrchestratorProps extends NiceBaseProps {
11885
12492
  onTest?: (flowId: string) => void;
11886
12493
  }
11887
12494
 
12495
+ /**
12496
+ * {@link NiceExam} — timed, forward-locked assessment; correctness withheld until the
12497
+ * end, pass threshold, optional certificate. (Named `NiceExam`, not `NiceTest`, to
12498
+ * avoid colliding with the unrelated software `NiceTestBuilder`.)
12499
+ */
12500
+ export declare const NiceExam: default_2.ForwardRefExoticComponent<AssessmentPresetProps & default_2.RefAttributes<HTMLDivElement>>;
12501
+
11888
12502
  /**
11889
12503
  * Unified export function.
11890
12504
  */
@@ -12499,6 +13113,10 @@ export declare interface NiceFloorPlanCanvasProps extends NiceBaseProps {
12499
13113
  animateStateChanges?: boolean;
12500
13114
  }
12501
13115
 
13116
+ export { NiceFocusable }
13117
+
13118
+ export { NiceFocusableProps }
13119
+
12502
13120
  /**
12503
13121
  * Cycles Tab / Shift+Tab between the first and last focusable
12504
13122
  * descendants. Use inside modals, dialogs, drawers — anywhere
@@ -12838,6 +13456,30 @@ export declare interface NiceGalleryProps extends NiceStandardProps {
12838
13456
  thumbnailWindow?: number;
12839
13457
  }
12840
13458
 
13459
+ export declare const NiceGamepad: default_2.FC<NiceGamepadProps>;
13460
+
13461
+ export declare interface NiceGamepadProps extends Omit<NiceDeviceTileProps, 'children'> {
13462
+ /** 'compact' = micro silhouette icon (default); 'full' = labeled layout. */
13463
+ view?: 'full' | 'compact';
13464
+ /** Icon size: px or a NiceSize preset (default 'md'). */
13465
+ size?: number | NiceSize;
13466
+ /** Fired when a button is pressed (click or live). */
13467
+ onButtonPress?: (button: GamepadButton_2) => void;
13468
+ /** Controlled momentary-press highlight. */
13469
+ pressedButtons?: GamepadButton_2[];
13470
+ /** Persistent highlight (e.g. to point out a button). */
13471
+ highlightedButtons?: GamepadButton_2[];
13472
+ /** Reflect a live physical controller via ui-core useGamepad. */
13473
+ live?: boolean;
13474
+ gamepadIndex?: number;
13475
+ /** Per-button text labels (full view). */
13476
+ buttonLabels?: Partial<Record<GamepadButton_2, string>>;
13477
+ /** Optional action tree to assign to buttons (full view). */
13478
+ actionTree?: NiceTreeNode[];
13479
+ assignments?: Partial<Record<GamepadButton_2, string>>;
13480
+ onAssign?: (button: GamepadButton_2, node: NiceTreeNode) => void;
13481
+ }
13482
+
12841
13483
  export declare const NiceGantt: default_2.FC<NiceGanttProps>;
12842
13484
 
12843
13485
  /** A table column shown in the {@link NiceGantt} left panel. */
@@ -13642,7 +14284,7 @@ export declare interface NiceImageViewerProps extends NiceStandardProps {
13642
14284
  }
13643
14285
 
13644
14286
  /**
13645
- * {@link NiceInbox} � Full-featured email inbox with reading pane, compose, folders,
14287
+ * {@link NiceInbox} — Full-featured email inbox with reading pane, compose, folders,
13646
14288
  * batch actions, sorting, search, and keyboard navigation.
13647
14289
  */
13648
14290
  export declare const NiceInbox: default_2.ForwardRefExoticComponent<NiceInboxProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -15030,6 +15672,23 @@ export declare interface NiceMAMProps extends NiceBaseProps {
15030
15672
  children?: ReactNode;
15031
15673
  }
15032
15674
 
15675
+ export declare interface NiceManagedDevice {
15676
+ id: string;
15677
+ kind: NiceDeviceKind;
15678
+ name?: string;
15679
+ description?: string;
15680
+ number?: number;
15681
+ /** Device tint; default transparent (outline only). */
15682
+ color?: string;
15683
+ /** mediaDevices deviceId (mic) or gamepad index id. */
15684
+ deviceId?: string;
15685
+ volume?: number;
15686
+ gain?: number;
15687
+ /** Live mic level 0..1 (fed by the consumer). */
15688
+ level?: number;
15689
+ assignedTo?: string | null;
15690
+ }
15691
+
15033
15692
  export declare const NiceMap: default_2.ForwardRefExoticComponent<NiceMapProps & default_2.RefAttributes<HTMLDivElement>>;
15034
15693
 
15035
15694
  export declare const NiceMapChart: default_2.FC<NiceMapChartProps>;
@@ -15503,6 +16162,17 @@ export declare interface NiceMergeRequestBuilderProps extends NiceBaseProps {
15503
16162
  tutorial?: NiceComponentTutorial;
15504
16163
  }
15505
16164
 
16165
+ export declare const NiceMicrophone: default_2.FC<NiceMicrophoneProps>;
16166
+
16167
+ export declare interface NiceMicrophoneProps extends Omit<NiceDeviceTileProps, 'children'> {
16168
+ /** Audio level 0..1 — fills the mic head from the bottom. */
16169
+ level?: number;
16170
+ /** Icon size: px or a NiceSize preset (default 'md'). */
16171
+ size?: number | NiceSize;
16172
+ /** Muted: dims the fill and shows a slash. */
16173
+ muted?: boolean;
16174
+ }
16175
+
15506
16176
  export declare const NiceModal: default_2.FC<NiceModalProps>;
15507
16177
 
15508
16178
  /** Props for the {@link NiceModal} component — a dialog overlay with focus trapping. */
@@ -16350,6 +17020,14 @@ export declare interface NiceNavShellProps {
16350
17020
  className?: string;
16351
17021
  contentClassName?: string;
16352
17022
  'data-testid'?: string;
17023
+ /**
17024
+ * Opt-in: wrap the shell in a {@link NiceSpatialNavProvider} so keyboard
17025
+ * arrows / a gamepad d-pad can navigate focusable controls (registered via
17026
+ * `useSpatialFocusable` / `<NiceFocusable>`). Default false.
17027
+ */
17028
+ spatialNavigation?: boolean;
17029
+ /** Options forwarded to NiceSpatialNavProvider when `spatialNavigation` is on. */
17030
+ spatialNavigationProps?: Omit<NiceSpatialNavProviderProps, 'children'>;
16353
17031
  }
16354
17032
 
16355
17033
  export declare interface NiceNavShellTab {
@@ -16425,36 +17103,6 @@ export declare interface NiceNotificationCategory {
16425
17103
  examples?: string[];
16426
17104
  }
16427
17105
 
16428
- /**
16429
- * {@link NiceNotificationCenter} — Notification dropdown/panel with read/unread state,
16430
- * filtering, grouping, dismiss, and bulk actions.
16431
- */
16432
- export declare const NiceNotificationCenter: default_2.ForwardRefExoticComponent<NiceNotificationCenterProps & default_2.RefAttributes<HTMLDivElement>>;
16433
-
16434
- /** Props for the {@link NiceNotificationCenter} component. */
16435
- export declare interface NiceNotificationCenterProps extends NiceFormFieldProps {
16436
- /** Notifications. */
16437
- notifications: NotificationEntry[];
16438
- /** Fires when a notification is clicked. */
16439
- onClick?: (notification: NotificationEntry) => void;
16440
- /** Fires when a notification is dismissed. */
16441
- onDismiss?: (id: string | number) => void;
16442
- /** Fires when all are marked as read. */
16443
- onMarkAllRead?: () => void;
16444
- /** Fires when all are cleared. */
16445
- onClearAll?: () => void;
16446
- /** Whether the dropdown is open. */
16447
- open?: boolean;
16448
- /** Fires on toggle. */
16449
- onOpenChange?: (open: boolean) => void;
16450
- /** Maximum notifications to show before "more". */
16451
- maxVisible?: number;
16452
- /** Locale for date formatting. */
16453
- locale?: string;
16454
- /** Whether to group by notification group key. */
16455
- groupByCategory?: boolean;
16456
- }
16457
-
16458
17106
  export declare interface NiceNotificationChannel {
16459
17107
  id: string;
16460
17108
  name: string;
@@ -16534,10 +17182,14 @@ export declare interface NiceNotificationsProps {
16534
17182
  maxHeight?: number;
16535
17183
  /** Show "Mark all as read" link in panel header. Default: true. */
16536
17184
  showMarkAllRead?: boolean;
17185
+ /** Show a "Clear all" (bulk-dismiss) link in the panel header. Default: false. */
17186
+ showClearAll?: boolean;
16537
17187
  /** Show "View all" link at panel footer. Default: false. */
16538
17188
  showViewAll?: boolean;
16539
17189
  /** Mark-all-as-read handler. */
16540
17190
  onMarkAllRead?: () => void;
17191
+ /** Bulk-dismiss handler — fires when "Clear all" is clicked. */
17192
+ onClearAll?: () => void;
16541
17193
  /** View-all handler. */
16542
17194
  onViewAll?: () => void;
16543
17195
  /** Per-item read-toggle handler (called when user marks an item read). */
@@ -16648,6 +17300,8 @@ export declare interface NiceNumericInputProps extends NiceStandardProps {
16648
17300
  format?: string | ((value: number) => string);
16649
17301
  /** Render the +/- step buttons. */
16650
17302
  showButtons?: boolean;
17303
+ /** Visual size. `'xs'` is the most compact (for dense rows); default `'md'`. */
17304
+ size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl';
16651
17305
  /** Placeholder shown when the value is empty (uncontrolled / undefined). */
16652
17306
  placeholder?: string;
16653
17307
  /** Disable input + buttons. */
@@ -16957,7 +17611,7 @@ export declare interface NiceParagraphProps extends Omit<NiceStandardProps, 'siz
16957
17611
  muted?: boolean;
16958
17612
  }
16959
17613
 
16960
- export declare type NiceParagraphSize = 'sm' | 'md' | 'lg';
17614
+ export declare type NiceParagraphSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
16961
17615
 
16962
17616
  export declare const NicePasswordInput: default_2.ForwardRefExoticComponent<NicePasswordInputProps & default_2.RefAttributes<HTMLInputElement>>;
16963
17617
 
@@ -17472,93 +18126,17 @@ declare interface NicePolarChartSeries {
17472
18126
  }
17473
18127
 
17474
18128
  /**
17475
- * NicePoll — Real-time voting/polling component
17476
- *
17477
- * @example
17478
- * ```tsx
17479
- * <NicePoll
17480
- * question="Which feature should we build next?"
17481
- * options={[
17482
- * { id: '1', text: 'Dark mode' },
17483
- * { id: '2', text: 'Mobile app' },
17484
- * { id: '3', text: 'API v2' },
17485
- * ]}
17486
- * results={pollResults}
17487
- * onVote={(ids) => submitVote(ids)}
17488
- * />
17489
- * ```
18129
+ * {@link NicePoll} — one / few questions with live aggregate results.
17490
18130
  */
17491
- export declare const NicePoll: ForwardRefExoticComponent<NicePollProps & RefAttributes<HTMLDivElement>>;
18131
+ export declare const NicePoll: default_2.ForwardRefExoticComponent<AssessmentPresetProps & default_2.RefAttributes<HTMLDivElement>>;
17492
18132
 
17493
18133
  export { NicePollingConfig }
17494
18134
 
17495
18135
  /**
17496
- * NicePollLive — Poll with automatic real-time result updates
17497
- *
17498
- * @example
17499
- * ```tsx
17500
- * <NicePollLive
17501
- * question="Best framework?"
17502
- * options={options}
17503
- * fetchResults={() => api.getPollResults(pollId)}
17504
- * pollInterval={5000}
17505
- * />
17506
- * ```
18136
+ * {@link NicePollLive} — alias of {@link NicePoll} with aggregate results shown by
18137
+ * default (kept for ergonomics / backward-compatible naming).
17507
18138
  */
17508
- export declare const NicePollLive: ForwardRefExoticComponent<NicePollLiveProps & RefAttributes<HTMLDivElement>>;
17509
-
17510
- export declare interface NicePollLiveProps extends Omit<NicePollProps, 'results'> {
17511
- /** Initial results */
17512
- initialResults?: PollResults;
17513
- /** WebSocket URL for live updates */
17514
- wsUrl?: string;
17515
- /** Polling interval in ms (fallback) */
17516
- pollInterval?: number;
17517
- /** Fetch results function */
17518
- fetchResults?: () => Promise<PollResults>;
17519
- }
17520
-
17521
- /**
17522
- * NicePoll props
17523
- */
17524
- export declare interface NicePollProps {
17525
- /** Poll question */
17526
- question: string;
17527
- /** Poll description */
17528
- description?: string;
17529
- /** Poll options */
17530
- options: PollOption[];
17531
- /** Current results (for real-time updates) */
17532
- results?: PollResults;
17533
- /** User's current vote(s) */
17534
- userVotes?: string[];
17535
- /** Poll configuration */
17536
- config?: PollConfig;
17537
- /** Theme variant */
17538
- theme?: 'light' | 'dark';
17539
- /** Size variant */
17540
- size?: 'sm' | 'md' | 'lg';
17541
- /** Custom labels */
17542
- labels?: {
17543
- vote?: string;
17544
- votes?: string;
17545
- voted?: string;
17546
- changeVote?: string;
17547
- closed?: string;
17548
- closesIn?: string;
17549
- totalVotes?: string;
17550
- noVotes?: string;
17551
- selectUpTo?: string;
17552
- };
17553
- /** Called when user votes */
17554
- onVote?: (optionIds: string[]) => void;
17555
- /** Called when user changes vote */
17556
- onChangeVote?: () => void;
17557
- /** Custom class name */
17558
- className?: string;
17559
- /** Children for custom content */
17560
- children?: ReactNode;
17561
- }
18139
+ export declare const NicePollLive: default_2.ForwardRefExoticComponent<AssessmentPresetProps & default_2.RefAttributes<HTMLDivElement>>;
17562
18140
 
17563
18141
  export declare const NicePopover: default_2.FC<NicePopoverProps>;
17564
18142
 
@@ -17856,6 +18434,15 @@ export declare interface NiceQRCodeProps extends NiceStandardProps {
17856
18434
  logo?: string;
17857
18435
  /** Logo dimensions in pixels. */
17858
18436
  logoSize?: number;
18437
+ /**
18438
+ * Render an editable {@link NiceTextInput} above the code that live-encodes
18439
+ * what the user types. Off by default — pass `showInput` to enable.
18440
+ */
18441
+ showInput?: boolean;
18442
+ /** Label for the built-in input (only when `showInput`). */
18443
+ inputLabel?: string;
18444
+ /** Placeholder for the built-in input (only when `showInput`). */
18445
+ inputPlaceholder?: string;
17859
18446
  }
17860
18447
 
17861
18448
  /** Reed-Solomon error correction level for QR codes. */
@@ -17925,85 +18512,10 @@ export { NiceQuickHelp }
17925
18512
  export { NiceQuickHelpProps }
17926
18513
 
17927
18514
  /**
17928
- * NiceQuiz — Interactive quiz component with gamification features
17929
- *
17930
- * @example
17931
- * ```tsx
17932
- * <NiceQuiz
17933
- * title="JavaScript Basics"
17934
- * questions={questions}
17935
- * timeLimit={300}
17936
- * lives={3}
17937
- * lifelines={['fiftyFifty', 'hint']}
17938
- * passingScore={70}
17939
- * onComplete={(result) => console.log(result)}
17940
- * />
17941
- * ```
17942
- */
17943
- export declare const NiceQuiz: ForwardRefExoticComponent<NiceQuizProps & RefAttributes<HTMLDivElement>>;
17944
-
17945
- /**
17946
- * NiceQuiz props
18515
+ * {@link NiceQuiz} — correct answers + scoring with immediate feedback and optional
18516
+ * gamification (lives, lifelines, difficulty). Pages can hold any content.
17947
18517
  */
17948
- export declare interface NiceQuizProps {
17949
- /** Quiz title */
17950
- title?: string;
17951
- /** Quiz description */
17952
- description?: string;
17953
- /** Questions array */
17954
- questions: QuizQuestion[];
17955
- /** Theme variant */
17956
- theme?: 'light' | 'dark';
17957
- /** Total time limit in seconds (0 = unlimited) */
17958
- timeLimit?: number;
17959
- /** Time limit per question in seconds (0 = unlimited) */
17960
- timePerQuestion?: number;
17961
- /** Initial lives (0 = unlimited) */
17962
- lives?: number;
17963
- /** Passing score percentage (0-100) */
17964
- passingScore?: number;
17965
- /** Show correct answer after each question */
17966
- showCorrectAnswerImmediately?: boolean;
17967
- /** Allow retry on wrong answer */
17968
- allowRetry?: boolean;
17969
- /** Show progress indicator */
17970
- showProgress?: boolean;
17971
- /** Available lifelines */
17972
- lifelines?: QuizLifeline[];
17973
- /** Shuffle questions */
17974
- shuffleQuestions?: boolean;
17975
- /** Shuffle options within questions */
17976
- shuffleOptions?: boolean;
17977
- /** Custom labels */
17978
- labels?: {
17979
- next?: string;
17980
- submit?: string;
17981
- skip?: string;
17982
- hint?: string;
17983
- fiftyFifty?: string;
17984
- extraTime?: string;
17985
- correct?: string;
17986
- incorrect?: string;
17987
- passed?: string;
17988
- failed?: string;
17989
- score?: string;
17990
- timeUp?: string;
17991
- noLives?: string;
17992
- retry?: string;
17993
- review?: string;
17994
- exit?: string;
17995
- };
17996
- /** Called when answer is submitted */
17997
- onAnswerSubmit?: (answer: QuizAnswer) => void;
17998
- /** Called when quiz is completed */
17999
- onComplete?: (result: QuizResult) => void;
18000
- /** Called when quiz is exited early */
18001
- onExit?: () => void;
18002
- /** Custom class name */
18003
- className?: string;
18004
- /** Children for custom content */
18005
- children?: ReactNode;
18006
- }
18518
+ export declare const NiceQuiz: default_2.ForwardRefExoticComponent<AssessmentPresetProps & default_2.RefAttributes<HTMLDivElement>>;
18007
18519
 
18008
18520
  export declare const NiceRadioGroup: default_2.FC<NiceRadioGroupProps>;
18009
18521
 
@@ -20233,6 +20745,12 @@ export declare interface NiceSparklineProps extends NiceStandardProps {
20233
20745
  showLastPoint?: boolean;
20234
20746
  }
20235
20747
 
20748
+ export { NiceSpatialNavContextValue }
20749
+
20750
+ export { NiceSpatialNavProvider }
20751
+
20752
+ export { NiceSpatialNavProviderProps }
20753
+
20236
20754
  export declare const NiceSpeechToText: default_2.ForwardRefExoticComponent<NiceSpeechToTextProps & default_2.RefAttributes<HTMLDivElement>>;
20237
20755
 
20238
20756
  /** Props for the {@link NiceSpeechToText} component — a browser Speech Recognition toggle button. */
@@ -20251,6 +20769,8 @@ export declare interface NiceSpeechToTextProps extends NiceBaseProps {
20251
20769
  label?: string;
20252
20770
  /** Button label when actively listening. */
20253
20771
  activeLabel?: string;
20772
+ /** Show the visible text label next to the icon. Defaults to `false` (icon-only). The aria-label is always present. */
20773
+ showLabel?: boolean;
20254
20774
  }
20255
20775
 
20256
20776
  export declare const NiceSpeedDialAction: default_2.FC<NiceSpeedDialProps>;
@@ -20544,39 +21064,6 @@ export declare interface NiceStatisticTrend {
20544
21064
  direction: 'up' | 'down';
20545
21065
  }
20546
21066
 
20547
- /**
20548
- * {@link NiceStatusBadge} — Workflow status badge with semantic coloring and optional pulse animation.
20549
- */
20550
- export declare const NiceStatusBadge: default_2.ForwardRefExoticComponent<NiceStatusBadgeProps & default_2.RefAttributes<HTMLSpanElement>>;
20551
-
20552
- /** Props for the {@link NiceStatusBadge} component. */
20553
- export declare interface NiceStatusBadgeProps {
20554
- /** Status label text. */
20555
- label: string;
20556
- /** Semantic category (maps to color). */
20557
- category?: StatusCategory;
20558
- /** Custom color (overrides category). CSS value. */
20559
- color?: string;
20560
- /** Custom background color. */
20561
- backgroundColor?: string;
20562
- /** Icon or emoji. */
20563
- icon?: default_2.ReactNode;
20564
- /** Whether to pulse/animate the badge. */
20565
- pulse?: boolean;
20566
- /** Whether to show a dot indicator instead of text. */
20567
- dot?: boolean;
20568
- /** Size variant. */
20569
- size?: NiceSize;
20570
- /** Visual variant. */
20571
- variant?: 'filled' | 'outlined' | 'subtle';
20572
- /** Custom class name. */
20573
- className?: string;
20574
- /** Custom style. */
20575
- style?: default_2.CSSProperties;
20576
- accessMode?: NiceAccessMode;
20577
- id?: string;
20578
- }
20579
-
20580
21067
  export declare const NiceStepper: default_2.FC<NiceStepperProps>;
20581
21068
 
20582
21069
  /** Props for the {@link NiceStepper} component — a step indicator / wizard with horizontal or vertical orientation. */
@@ -20726,58 +21213,11 @@ declare interface NiceSuffixOption {
20726
21213
  weight?: number;
20727
21214
  }
20728
21215
 
20729
- export declare const NiceSurvey: default_2.ForwardRefExoticComponent<NiceSurveyProps & default_2.RefAttributes<HTMLDivElement>>;
20730
-
20731
- export declare interface NiceSurveyProps {
20732
- /** Unique survey ID. */
20733
- id: string;
20734
- /** Survey title. */
20735
- title: string;
20736
- /** Survey description. */
20737
- description?: string;
20738
- /** List of questions. */
20739
- questions: SurveyQuestion[];
20740
- /** Display mode. */
20741
- mode?: SurveyDisplayMode;
20742
- /** Allow going back to previous questions (question-by-question mode). */
20743
- allowBack?: boolean;
20744
- /** Show progress indicator. */
20745
- showProgress?: boolean;
20746
- /** Show question numbers. */
20747
- showNumbers?: boolean;
20748
- /** Time limit for entire survey (seconds). */
20749
- timeLimit?: number;
20750
- /** Called when survey is submitted. */
20751
- onSubmit?: (submission: SurveySubmission) => void;
20752
- /** Called when an answer changes. */
20753
- onAnswerChange?: (questionId: string, value: SurveyAnswer['value']) => void;
20754
- /** Called when time runs out. */
20755
- onTimeOut?: () => void;
20756
- /** Initial answers (for resuming). */
20757
- initialAnswers?: SurveyAnswer[];
20758
- /** Whether survey is read-only (for review). */
20759
- readOnly?: boolean;
20760
- /** Show results after submission. */
20761
- showResultsAfterSubmit?: boolean;
20762
- /** Existing results to display. */
20763
- results?: SurveyResults;
20764
- /** Custom submit button text. */
20765
- submitText?: string;
20766
- /** Custom next button text. */
20767
- nextText?: string;
20768
- /** Custom back button text. */
20769
- backText?: string;
20770
- /** Custom skip button text. */
20771
- skipText?: string;
20772
- /** Participant ID (for tracking). */
20773
- participantId?: string;
20774
- /** Participant name (for display). */
20775
- participantName?: string;
20776
- /** Theme. */
20777
- theme?: 'light' | 'dark';
20778
- /** Custom class name. */
20779
- className?: string;
20780
- }
21216
+ /**
21217
+ * {@link NiceSurvey} — no scoring; collects responses and can display aggregate
21218
+ * (global) results via `results` / `fetchAggregateResults`.
21219
+ */
21220
+ export declare const NiceSurvey: default_2.ForwardRefExoticComponent<AssessmentPresetProps & default_2.RefAttributes<HTMLDivElement>>;
20781
21221
 
20782
21222
  /**
20783
21223
  * Drop-in replacement for `<React.Suspense>` with a `delay` knob to
@@ -21325,10 +21765,8 @@ export { niceThemeBootstrap }
21325
21765
 
21326
21766
  export { NiceThemeBorders }
21327
21767
 
21328
- export declare const NiceThemeBuilder: default_2.ForwardRefExoticComponent<NiceThemeBuilderProps & default_2.RefAttributes<HTMLDivElement>>;
21329
-
21330
21768
  /** Props for the {@link NiceThemeBuilder} component — an advanced visual theme editor with section pickers, presets, live preview, and export. */
21331
- export declare interface NiceThemeBuilderProps extends NiceBaseProps {
21769
+ declare interface NiceThemeBuilderProps extends NiceBaseProps {
21332
21770
  /** Initial theme to edit (defaults to Light) */
21333
21771
  theme?: NiceTheme;
21334
21772
  /** Preset themes to offer in the picker */
@@ -21354,7 +21792,7 @@ export declare interface NiceThemeBuilderProps extends NiceBaseProps {
21354
21792
  }
21355
21793
 
21356
21794
  /** Editable sections in the {@link NiceThemeBuilder}. */
21357
- export declare type NiceThemeBuilderSection = 'general' | 'colors' | 'backgrounds' | 'background-image' | 'text' | 'borders' | 'spacing' | 'typography' | 'shadows' | 'transitions' | 'nesting';
21795
+ declare type NiceThemeBuilderSection = 'general' | 'colors' | 'backgrounds' | 'background-image' | 'text' | 'borders' | 'spacing' | 'typography' | 'shadows' | 'transitions' | 'nesting';
21358
21796
 
21359
21797
  export { NiceThemeColors }
21360
21798
 
@@ -24130,45 +24568,6 @@ declare interface NiceXLSXOptions extends NiceExportOptions {
24130
24568
  }>;
24131
24569
  }
24132
24570
 
24133
- /**
24134
- * {@link NiceXPBar} — Experience points progress bar with level display and level-up animation.
24135
- */
24136
- export declare const NiceXPBar: default_2.ForwardRefExoticComponent<NiceXPBarProps & default_2.RefAttributes<HTMLDivElement>>;
24137
-
24138
- /** Props for the {@link NiceXPBar} component. */
24139
- export declare interface NiceXPBarProps {
24140
- /** Current XP points. */
24141
- currentXP: number;
24142
- /** XP required for next level. */
24143
- maxXP: number;
24144
- /** Current level number. */
24145
- level: number;
24146
- /** Label shown on the bar (optional, defaults to "Level X"). */
24147
- levelLabel?: string;
24148
- /** Previous XP value for animated transition. */
24149
- previousXP?: number;
24150
- /** Whether to animate XP changes. */
24151
- animated?: boolean;
24152
- /** Duration of fill animation in ms (default 800). */
24153
- animationDuration?: number;
24154
- /** Whether to show level-up celebration effect. */
24155
- showLevelUp?: boolean;
24156
- /** Fires when level-up animation completes. */
24157
- onLevelUpComplete?: () => void;
24158
- /** Color of the XP fill bar (CSS value). */
24159
- fillColor?: string;
24160
- /** Whether to show the XP numbers. */
24161
- showNumbers?: boolean;
24162
- /** Size variant. */
24163
- size?: NiceSize;
24164
- /** Custom class name. */
24165
- className?: string;
24166
- /** Custom style. */
24167
- style?: default_2.CSSProperties;
24168
- accessMode?: NiceAccessMode;
24169
- id?: string;
24170
- }
24171
-
24172
24571
  /**
24173
24572
  * Node shape types
24174
24573
  */
@@ -24177,26 +24576,6 @@ export declare type NodeShape = 'rectangle' | 'rounded-rectangle' | 'circle' | '
24177
24576
  /** Prevent importing entire library — enforce tree-shaking. */
24178
24577
  export declare const noFullImport: ESLintRule;
24179
24578
 
24180
- /** A single notification entry. */
24181
- export declare interface NotificationEntry {
24182
- id: string | number;
24183
- type: NotificationType;
24184
- /** Notification title. */
24185
- title: string;
24186
- /** Body text or description. */
24187
- body?: string;
24188
- /** ISO date string. */
24189
- createdAt: string;
24190
- /** Whether the notification has been read. */
24191
- isRead?: boolean;
24192
- /** Icon override (emoji or URL). */
24193
- icon?: string;
24194
- /** Action URL or route path to navigate to when clicked. */
24195
- actionUrl?: string;
24196
- /** Group key for categorization. */
24197
- group?: string;
24198
- }
24199
-
24200
24579
  /**
24201
24580
  * usePushNotifications — Push notification subscription management
24202
24581
  *
@@ -24235,9 +24614,6 @@ export declare interface NotificationEntry {
24235
24614
  */
24236
24615
  declare type NotificationPermission_2 = 'default' | 'granted' | 'denied';
24237
24616
 
24238
- /** Type of notification. */
24239
- export declare type NotificationType = 'info' | 'success' | 'warning' | 'error' | 'task' | 'mention' | 'system';
24240
-
24241
24617
  export declare interface OAuthConfigTemplate {
24242
24618
  authorizationUrl: string;
24243
24619
  tokenUrl: string;
@@ -24746,72 +25122,6 @@ export declare interface PlatformConnection {
24746
25122
  error?: string;
24747
25123
  }
24748
25124
 
24749
- /**
24750
- * Poll configuration
24751
- */
24752
- export declare interface PollConfig {
24753
- /** Allow multiple selection */
24754
- multiSelect?: boolean;
24755
- /** Maximum selections when multiSelect is true */
24756
- maxSelections?: number;
24757
- /** Allow changing vote */
24758
- allowChangeVote?: boolean;
24759
- /** Show results before voting */
24760
- showResultsBeforeVote?: boolean;
24761
- /** Show results after voting */
24762
- showResultsAfterVote?: boolean;
24763
- /** Show vote count */
24764
- showVoteCount?: boolean;
24765
- /** Show percentages */
24766
- showPercentages?: boolean;
24767
- /** Animate results */
24768
- animateResults?: boolean;
24769
- /** Poll closes at this date */
24770
- closesAt?: Date;
24771
- /** Poll is closed */
24772
- isClosed?: boolean;
24773
- /** Allow anonymous voting */
24774
- anonymous?: boolean;
24775
- }
24776
-
24777
- /**
24778
- * Poll option
24779
- */
24780
- export declare interface PollOption {
24781
- id: string;
24782
- text: string;
24783
- icon?: string;
24784
- image?: string;
24785
- color?: string;
24786
- }
24787
-
24788
- /**
24789
- * Poll results for an option
24790
- */
24791
- export declare interface PollOptionResult {
24792
- optionId: string;
24793
- votes: number;
24794
- percentage: number;
24795
- }
24796
-
24797
- /**
24798
- * Poll results
24799
- */
24800
- export declare interface PollResults {
24801
- totalVotes: number;
24802
- options: PollOptionResult[];
24803
- lastUpdated: Date;
24804
- }
24805
-
24806
- /**
24807
- * Poll vote
24808
- */
24809
- export declare interface PollVote {
24810
- optionId: string;
24811
- voterId?: string;
24812
- timestamp: Date;
24813
- }
24814
-
24815
25125
  /**
24816
25126
  * Port position
24817
25127
  */
@@ -25103,75 +25413,6 @@ declare interface QuickFilter<T = any> {
25103
25413
  color?: 'primary' | 'success' | 'warning' | 'danger' | 'info' | 'secondary';
25104
25414
  }
25105
25415
 
25106
- /**
25107
- * Quiz answer
25108
- */
25109
- export declare interface QuizAnswer {
25110
- questionId: string;
25111
- value: string | string[];
25112
- isCorrect: boolean;
25113
- timeTaken: number;
25114
- pointsEarned: number;
25115
- hintsUsed?: number;
25116
- }
25117
-
25118
- /**
25119
- * Quiz difficulty level
25120
- */
25121
- export declare type QuizDifficulty = 'easy' | 'medium' | 'hard';
25122
-
25123
- /**
25124
- * Quiz lifeline type
25125
- */
25126
- export declare type QuizLifeline = 'fiftyFifty' | 'hint' | 'skipQuestion' | 'extraTime';
25127
-
25128
- /**
25129
- * Quiz option
25130
- */
25131
- export declare interface QuizOption {
25132
- id: string;
25133
- text: string;
25134
- icon?: string;
25135
- image?: string;
25136
- }
25137
-
25138
- /**
25139
- * Quiz question
25140
- */
25141
- export declare interface QuizQuestion {
25142
- id: string;
25143
- type: QuizQuestionType;
25144
- text: string;
25145
- description?: string;
25146
- image?: string;
25147
- options?: QuizOption[];
25148
- correctAnswer: string | string[];
25149
- points?: number;
25150
- timeLimit?: number;
25151
- difficulty?: QuizDifficulty;
25152
- explanation?: string;
25153
- hint?: string;
25154
- }
25155
-
25156
- /**
25157
- * Quiz question type
25158
- */
25159
- export declare type QuizQuestionType = 'single' | 'multiple' | 'text' | 'trueFalse' | 'ordering';
25160
-
25161
- /**
25162
- * Quiz result
25163
- */
25164
- export declare interface QuizResult {
25165
- totalQuestions: number;
25166
- answeredCorrectly: number;
25167
- totalPoints: number;
25168
- maxPoints: number;
25169
- percentageScore: number;
25170
- timeTaken: number;
25171
- answers: QuizAnswer[];
25172
- passed: boolean;
25173
- }
25174
-
25175
25416
  export { RADIUS_VALUES }
25176
25417
 
25177
25418
  export { RadiusVariant }
@@ -26645,6 +26886,8 @@ export declare interface SpatialAnnotation {
26645
26886
  createdBy?: string;
26646
26887
  }
26647
26888
 
26889
+ export { SpatialFocusableMeta }
26890
+
26648
26891
  /** Speaker definition */
26649
26892
  export declare interface Speaker {
26650
26893
  id: string;
@@ -26725,9 +26968,6 @@ declare interface StateSlice {
26725
26968
  computed?: ComputedField[];
26726
26969
  }
26727
26970
 
26728
- /** Predefined status semantic categories. */
26729
- export declare type StatusCategory = 'success' | 'warning' | 'error' | 'info' | 'neutral' | 'custom';
26730
-
26731
26971
  export { StorageAdapter }
26732
26972
 
26733
26973
  export { StorageAuditResult }
@@ -26937,60 +27177,6 @@ declare interface SuggestionFactor {
26937
27177
  entryValue?: string;
26938
27178
  }
26939
27179
 
26940
- export declare interface SurveyAnswer {
26941
- questionId: string;
26942
- value: string | string[] | number | null;
26943
- answeredAt?: string;
26944
- timeSpent?: number;
26945
- }
26946
-
26947
- export declare type SurveyDisplayMode = 'all-at-once' | 'question-by-question' | 'timed';
26948
-
26949
- export declare interface SurveyOption {
26950
- id: string;
26951
- text: string;
26952
- icon?: default_2.ReactNode;
26953
- imageUrl?: string;
26954
- }
26955
-
26956
- export declare interface SurveyQuestion {
26957
- id: string;
26958
- text: string;
26959
- description?: string;
26960
- type: SurveyQuestionType;
26961
- options?: SurveyOption[];
26962
- required?: boolean;
26963
- minValue?: number;
26964
- maxValue?: number;
26965
- placeholder?: string;
26966
- timeLimit?: number;
26967
- imageUrl?: string;
26968
- category?: string;
26969
- }
26970
-
26971
- export declare type SurveyQuestionType = 'single' | 'multiple' | 'text' | 'rating' | 'scale' | 'date' | 'time';
26972
-
26973
- export declare interface SurveyResults {
26974
- totalResponses: number;
26975
- questionStats: Record<string, {
26976
- responses: number;
26977
- optionCounts: Record<string, number>;
26978
- averageRating?: number;
26979
- textResponses?: string[];
26980
- }>;
26981
- }
26982
-
26983
- export declare interface SurveySubmission {
26984
- id: string;
26985
- surveyId: string;
26986
- participantId?: string;
26987
- participantName?: string;
26988
- answers: SurveyAnswer[];
26989
- submittedAt: string;
26990
- totalTime: number;
26991
- completed: boolean;
26992
- }
26993
-
26994
27180
  /** Swap event types. */
26995
27181
  export declare type SwapEventType = 'swap-start' | 'swap-success' | 'swap-error' | 'swap-rollback';
26996
27182
 
@@ -28155,6 +28341,59 @@ export { useAICompletion }
28155
28341
  */
28156
28342
  export declare function useAnalytics(): AnalyticsContextValue;
28157
28343
 
28344
+ export declare function useAssessment(opts: UseAssessmentOptions): UseAssessmentReturn;
28345
+
28346
+ declare interface UseAssessmentOptions {
28347
+ id?: string;
28348
+ mode: AssessmentMode;
28349
+ pages?: AssessmentPage[];
28350
+ questions?: AssessmentQuestion[];
28351
+ sections?: AssessmentSection[];
28352
+ scoring?: AssessmentScoringConfig;
28353
+ timer?: AssessmentTimerConfig;
28354
+ shuffleQuestions?: boolean;
28355
+ shuffleOptions?: boolean;
28356
+ randomizeSeed?: string | number;
28357
+ pool?: {
28358
+ count: number;
28359
+ section?: string;
28360
+ };
28361
+ lockNavigation?: boolean;
28362
+ allowBack?: boolean;
28363
+ persistKey?: string;
28364
+ /** Translator (injected by the shell). Defaults to the fallback string. */
28365
+ t?: (key: string, defaultValue: string) => string;
28366
+ onAnswer?: (answer: AssessmentAnswer) => void;
28367
+ onPageChange?: (pageId: string, index: number) => void;
28368
+ onComplete?: (result: AssessmentResult) => void | Promise<void>;
28369
+ onSubmit?: (submission: AssessmentSubmission) => void | Promise<void>;
28370
+ onTimeout?: (scope: 'total' | 'page' | 'question') => void;
28371
+ }
28372
+
28373
+ declare interface UseAssessmentReturn {
28374
+ ctx: AssessmentContext;
28375
+ pages: AssessmentPage[];
28376
+ currentPage: AssessmentPage | undefined;
28377
+ currentIndex: number;
28378
+ totalPages: number;
28379
+ isFirst: boolean;
28380
+ isLast: boolean;
28381
+ progress: number;
28382
+ answers: Record<string, AssessmentAnswerValue>;
28383
+ setAnswer: (questionId: string, value: AssessmentAnswerValue) => void;
28384
+ getAnswer: (questionId: string) => AssessmentAnswerValue;
28385
+ goNext: () => void;
28386
+ goPrev: () => void;
28387
+ goTo: (pageId: string) => void;
28388
+ skip: () => void;
28389
+ submit: () => void;
28390
+ restart: () => void;
28391
+ completed: boolean;
28392
+ result: AssessmentResult | null;
28393
+ submission: AssessmentSubmission | null;
28394
+ timeLeft: number | null;
28395
+ }
28396
+
28158
28397
  export declare function useAuditLog(options?: UseAuditLogOptions): UseAuditLogResult;
28159
28398
 
28160
28399
  export declare interface UseAuditLogOptions {
@@ -28326,6 +28565,10 @@ export { useFocusTrap }
28326
28565
 
28327
28566
  export { useFormGeneration }
28328
28567
 
28568
+ export { useGamepad }
28569
+
28570
+ export { UseGamepadOptions }
28571
+
28329
28572
  export { useGridPreferences }
28330
28573
 
28331
28574
  /**
@@ -28760,6 +29003,14 @@ export declare function useSidebarPrefsScope(overrides?: SidebarPrefsScopeValue)
28760
29003
  /** Shortcut for pages that only need the userId. */
28761
29004
  export declare function useSidebarUserId(override?: string): string | undefined;
28762
29005
 
29006
+ export { useSpatialFocusable }
29007
+
29008
+ export { UseSpatialFocusableOptions }
29009
+
29010
+ export { useSpatialNav }
29011
+
29012
+ export { useSpatialNavOptional }
29013
+
28763
29014
  /**
28764
29015
  * Hook to get a namespaced storage adapter.
28765
29016
  */