@fgv/ts-res-ui-components 5.0.0-21 → 5.0.0-23

package/lib/namespaces/GridTools.d.ts

@@ -0,0 +1,136 @@
+/**
+ * GridTools namespace for grid-based resource management components and utilities.
+ *
+ * Provides components and utilities for displaying and editing multiple resources
+ * simultaneously in grid/table format with configurable columns, validation,
+ * and batch operations.
+ *
+ * @example
+ * ```tsx
+ * import { GridTools, ResourceTools } from '@fgv/ts-res-ui-components';
+ *
+ * // Single grid usage
+ * function UserDataGrid() {
+ *   const { state, actions } = ResourceTools.useResourceData();
+ *
+ *   const gridConfig: GridTools.GridViewInitParams = {
+ *     id: 'users',
+ *     title: 'User Data',
+ *     resourceSelection: { type: 'prefix', prefix: 'user.' },
+ *     columnMapping: [{
+ *       resourceType: 'user-data',
+ *       columns: [
+ *         {
+ *           id: 'name',
+ *           title: 'Name',
+ *           dataPath: 'name',
+ *           editable: true,
+ *           cellType: 'string',
+ *           validation: { required: true, maxLength: 100 }
+ *         },
+ *         {
+ *           id: 'email',
+ *           title: 'Email',
+ *           dataPath: 'email',
+ *           editable: true,
+ *           cellType: 'string',
+ *           validation: {
+ *             required: true,
+ *             pattern: /^[^\s@]+@[^\s@]+\.[^\s@]+$/
+ *           }
+ *         },
+ *         {
+ *           id: 'active',
+ *           title: 'Active',
+ *           dataPath: 'active',
+ *           editable: true,
+ *           cellType: 'boolean'
+ *         }
+ *       ]
+ *     }]
+ *   };
+ *
+ *   return (
+ *     <GridTools.GridView
+ *       gridConfig={gridConfig}
+ *       resources={state.resources}
+ *       resolutionState={state.resolutionState}
+ *       resolutionActions={actions}
+ *       availableQualifiers={['language', 'territory']}
+ *     />
+ *   );
+ * }
+ *
+ * // Multi-grid usage for admin workflows
+ * function AdminPanel() {
+ *   const { state, actions } = ResourceTools.useResourceData();
+ *
+ *   const gridConfigs: GridTools.GridViewInitParams[] = [
+ *     {
+ *       id: 'languages',
+ *       title: 'Languages',
+ *       resourceSelection: { type: 'resourceTypes', types: ['language-config'] },
+ *       columnMapping: [{
+ *         resourceType: 'language-config',
+ *         columns: [
+ *           { id: 'code', title: 'Code', dataPath: 'code' },
+ *           {
+ *             id: 'name',
+ *             title: 'Display Name',
+ *             dataPath: 'displayName',
+ *             editable: true,
+ *             cellType: 'string'
+ *           }
+ *         ]
+ *       }]
+ *     },
+ *     {
+ *       id: 'payment-methods',
+ *       title: 'Payment Methods',
+ *       resourceSelection: { type: 'prefix', prefix: 'payment.' },
+ *       columnMapping: [{
+ *         resourceType: 'payment-config',
+ *         columns: [
+ *           {
+ *             id: 'status',
+ *             title: 'Status',
+ *             dataPath: 'status',
+ *             editable: true,
+ *             cellType: 'dropdown',
+ *             dropdownOptions: [
+ *               { value: 'active', label: 'Active' },
+ *               { value: 'inactive', label: 'Inactive' }
+ *             ]
+ *           }
+ *         ]
+ *       }]
+ *     }
+ *   ];
+ *
+ *   return (
+ *     <GridTools.MultiGridView
+ *       gridConfigurations={gridConfigs}
+ *       resources={state.resources}
+ *       resolutionState={state.resolutionState}
+ *       resolutionActions={actions}
+ *       availableQualifiers={['country', 'language', 'environment']}
+ *       tabsPresentation="tabs"
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * @public
+ */
+export { GridView } from '../components/views/GridView';
+export { MultiGridView } from '../components/views/GridView/MultiGridView';
+export { ResourceGrid } from '../components/views/GridView/ResourceGrid';
+export { EditableGridCell } from '../components/views/GridView/EditableGridCell';
+export { SharedContextControls } from '../components/views/GridView/SharedContextControls';
+export { GridSelector } from '../components/views/GridView/GridSelector';
+export { StringCell, BooleanCell, TriStateCell, DropdownCell } from '../components/views/GridView/cells';
+export { ResourceSelector, defaultResourceSelector, selectResources } from '../utils/resourceSelector';
+export { validateCellValue, ValidationPatterns, ValidationFunctions, GridValidationState } from '../utils/cellValidation';
+export { hasGridValidationErrors, getAllGridValidationErrors, clearAllGridValidationErrors } from '../components/views/GridView/EditableGridCell';
+export type { GridViewProps, MultiGridViewProps, GridViewInitParams, GridColumnDefinition, GridDropdownOption, GridCellValidation, GridResourceSelector, CustomResourceSelector, GridPresentationOptions, ResourceTypeColumnMapping, GridCellProps, GridCellEditorProps } from '../types';
+//# sourceMappingURL=GridTools.d.ts.map

package/lib/namespaces/GridTools.js

@@ -0,0 +1,138 @@
+/**
+ * GridTools namespace for grid-based resource management components and utilities.
+ *
+ * Provides components and utilities for displaying and editing multiple resources
+ * simultaneously in grid/table format with configurable columns, validation,
+ * and batch operations.
+ *
+ * @example
+ * ```tsx
+ * import { GridTools, ResourceTools } from '@fgv/ts-res-ui-components';
+ *
+ * // Single grid usage
+ * function UserDataGrid() {
+ *   const { state, actions } = ResourceTools.useResourceData();
+ *
+ *   const gridConfig: GridTools.GridViewInitParams = {
+ *     id: 'users',
+ *     title: 'User Data',
+ *     resourceSelection: { type: 'prefix', prefix: 'user.' },
+ *     columnMapping: [{
+ *       resourceType: 'user-data',
+ *       columns: [
+ *         {
+ *           id: 'name',
+ *           title: 'Name',
+ *           dataPath: 'name',
+ *           editable: true,
+ *           cellType: 'string',
+ *           validation: { required: true, maxLength: 100 }
+ *         },
+ *         {
+ *           id: 'email',
+ *           title: 'Email',
+ *           dataPath: 'email',
+ *           editable: true,
+ *           cellType: 'string',
+ *           validation: {
+ *             required: true,
+ *             pattern: /^[^\s@]+@[^\s@]+\.[^\s@]+$/
+ *           }
+ *         },
+ *         {
+ *           id: 'active',
+ *           title: 'Active',
+ *           dataPath: 'active',
+ *           editable: true,
+ *           cellType: 'boolean'
+ *         }
+ *       ]
+ *     }]
+ *   };
+ *
+ *   return (
+ *     <GridTools.GridView
+ *       gridConfig={gridConfig}
+ *       resources={state.resources}
+ *       resolutionState={state.resolutionState}
+ *       resolutionActions={actions}
+ *       availableQualifiers={['language', 'territory']}
+ *     />
+ *   );
+ * }
+ *
+ * // Multi-grid usage for admin workflows
+ * function AdminPanel() {
+ *   const { state, actions } = ResourceTools.useResourceData();
+ *
+ *   const gridConfigs: GridTools.GridViewInitParams[] = [
+ *     {
+ *       id: 'languages',
+ *       title: 'Languages',
+ *       resourceSelection: { type: 'resourceTypes', types: ['language-config'] },
+ *       columnMapping: [{
+ *         resourceType: 'language-config',
+ *         columns: [
+ *           { id: 'code', title: 'Code', dataPath: 'code' },
+ *           {
+ *             id: 'name',
+ *             title: 'Display Name',
+ *             dataPath: 'displayName',
+ *             editable: true,
+ *             cellType: 'string'
+ *           }
+ *         ]
+ *       }]
+ *     },
+ *     {
+ *       id: 'payment-methods',
+ *       title: 'Payment Methods',
+ *       resourceSelection: { type: 'prefix', prefix: 'payment.' },
+ *       columnMapping: [{
+ *         resourceType: 'payment-config',
+ *         columns: [
+ *           {
+ *             id: 'status',
+ *             title: 'Status',
+ *             dataPath: 'status',
+ *             editable: true,
+ *             cellType: 'dropdown',
+ *             dropdownOptions: [
+ *               { value: 'active', label: 'Active' },
+ *               { value: 'inactive', label: 'Inactive' }
+ *             ]
+ *           }
+ *         ]
+ *       }]
+ *     }
+ *   ];
+ *
+ *   return (
+ *     <GridTools.MultiGridView
+ *       gridConfigurations={gridConfigs}
+ *       resources={state.resources}
+ *       resolutionState={state.resolutionState}
+ *       resolutionActions={actions}
+ *       availableQualifiers={['country', 'language', 'environment']}
+ *       tabsPresentation="tabs"
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * @public
+ */
+// Export grid view components
+export { GridView } from '../components/views/GridView';
+export { MultiGridView } from '../components/views/GridView/MultiGridView';
+export { ResourceGrid } from '../components/views/GridView/ResourceGrid';
+export { EditableGridCell } from '../components/views/GridView/EditableGridCell';
+export { SharedContextControls } from '../components/views/GridView/SharedContextControls';
+export { GridSelector } from '../components/views/GridView/GridSelector';
+// Export specialized cell components
+export { StringCell, BooleanCell, TriStateCell, DropdownCell } from '../components/views/GridView/cells';
+// Export grid utilities
+export { ResourceSelector, defaultResourceSelector, selectResources } from '../utils/resourceSelector';
+export { validateCellValue, ValidationPatterns, ValidationFunctions, GridValidationState } from '../utils/cellValidation';
+export { hasGridValidationErrors, getAllGridValidationErrors, clearAllGridValidationErrors } from '../components/views/GridView/EditableGridCell';
+//# sourceMappingURL=GridTools.js.map

package/lib/namespaces/ObservabilityTools.d.ts

@@ -0,0 +1,3 @@
+export type { IUserLogger, IObservabilityContext } from '../utils/observability';
+export { ConsoleUserLogger, NoOpUserLogger, ObservabilityContext, createConsoleObservabilityContext, createNoOpObservabilityContext, DefaultObservabilityContext, TestObservabilityContext } from '../utils/observability';
+//# sourceMappingURL=ObservabilityTools.d.ts.map

package/lib/namespaces/ObservabilityTools.js

@@ -0,0 +1,23 @@
+/*
+ * Copyright (c) 2025 Erik Fortune
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+export { ConsoleUserLogger, NoOpUserLogger, ObservabilityContext, createConsoleObservabilityContext, createNoOpObservabilityContext, DefaultObservabilityContext, TestObservabilityContext } from '../utils/observability';
+//# sourceMappingURL=ObservabilityTools.js.map

package/lib/namespaces/ResolutionTools.d.ts

@@ -34,7 +34,8 @@ export { QualifierContextControl } from '../components/common/QualifierContextCo
 export { ResolutionContextOptionsControl } from '../components/common/ResolutionContextOptionsControl';
 export { useResolutionState } from '../hooks/useResolutionState';
 export { createResolverWithContext, evaluateConditionsForCandidate, resolveResourceDetailed, getAvailableQualifiers, hasPendingContextChanges, type ResolutionOptions } from '../utils/resolutionUtils';
-export type { ResolutionState, ResolutionActions, ResolutionViewProps, ResolutionResult, CandidateInfo, ConditionEvaluationResult, EditedResourceInfo, ResolutionContextOptions, QualifierControlOptions } from '../types';
+export { getPendingAdditionsByType, isPendingAddition, deriveLeafId, deriveFullId, getPendingResourceTypes, getPendingResourceStats, validatePendingResourceKeys } from '../utils/resourceSelectors';
+export type { ResolutionState, ResolutionActions, ResolutionViewProps, ResolutionResult, CandidateInfo, ConditionEvaluationResult, EditedResourceInfo, ResolutionContextOptions, QualifierControlOptions, CreatePendingResourceParams } from '../types';
 export type { EditableJsonViewProps } from '../components/views/ResolutionView/EditableJsonView';
 export type { ResolutionContextOptionsControlProps } from '../components/common/ResolutionContextOptionsControl';
 //# sourceMappingURL=ResolutionTools.d.ts.map

package/lib/namespaces/ResolutionTools.js

@@ -38,4 +38,6 @@ export { ResolutionContextOptionsControl } from '../components/common/Resolution
 export { useResolutionState } from '../hooks/useResolutionState';
 // Export utility functions
 export { createResolverWithContext, evaluateConditionsForCandidate, resolveResourceDetailed, getAvailableQualifiers, hasPendingContextChanges } from '../utils/resolutionUtils';
+// Export resource selector utility functions for pending resource management
+export { getPendingAdditionsByType, isPendingAddition, deriveLeafId, deriveFullId, getPendingResourceTypes, getPendingResourceStats, validatePendingResourceKeys } from '../utils/resourceSelectors';
 //# sourceMappingURL=ResolutionTools.js.map

package/lib/namespaces/index.d.ts

@@ -46,4 +46,6 @@ export * as TsResTools from './TsResTools';
 export * as ViewStateTools from './ViewStateTools';
 export * as ZipTools from './ZipTools';
 export * as PickerTools from './PickerTools';
+export * as GridTools from './GridTools';
+export * as ObservabilityTools from './ObservabilityTools';
 //# sourceMappingURL=index.d.ts.map

package/lib/namespaces/index.js

@@ -46,4 +46,6 @@ export * as TsResTools from './TsResTools';
 export * as ViewStateTools from './ViewStateTools';
 export * as ZipTools from './ZipTools';
 export * as PickerTools from './PickerTools';
+export * as GridTools from './GridTools';
+export * as ObservabilityTools from './ObservabilityTools';
 //# sourceMappingURL=index.js.map

package/lib/test/integration/observability.integration.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=observability.integration.test.d.ts.map

package/lib/test/unit/hooks/useResourceData.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=useResourceData.test.d.ts.map

package/lib/test/unit/utils/downloadHelper.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=downloadHelper.test.d.ts.map

package/lib/test/unit/workflows/resolutionWorkflows.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=resolutionWorkflows.test.d.ts.map

package/lib/test/unit/workflows/resourceCreation.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=resourceCreation.test.d.ts.map

package/lib/test/unit/workflows/resultPatternExtensions.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=resultPatternExtensions.test.d.ts.map

package/lib/test/unit/workflows/validation.test.d.ts

@@ -0,0 +1,2 @@
+import '@fgv/ts-utils-jest';
+//# sourceMappingURL=validation.test.d.ts.map