@strato-admin/core 0.1.0

package/dist/resource/SchemaRegistry.js

@@ -0,0 +1,145 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React, { createContext, useContext, useState, useCallback, useMemo, Fragment } from 'react';
+import { required } from '@strato-admin/ra-core';
+import { FieldSchema } from './FieldSchema';
+import { InputSchema } from './InputSchema';
+const SchemaRegistryContext = createContext(undefined);
+// Use a global store for schemas to ensure they are available even before 
+// components have finished their first render/useEffect cycle.
+const globalSchemaRegistry = {};
+let globalDefaultComponents = {};
+const globalFieldInputMapping = new Map();
+/**
+ * Registers default input components for given field components.
+ * This mapping is used by ResourceSchemaProvider to infer forms.
+ */
+export const registerFieldInputMapping = (mapping) => {
+    mapping.forEach((value, key) => {
+        globalFieldInputMapping.set(key, value);
+    });
+};
+/**
+ * Retrieves the registered default input component for a field.
+ */
+export const getDefaultInputForField = (fieldComponent) => {
+    return globalFieldInputMapping.get(fieldComponent);
+};
+/**
+ * Synchronously registers schemas for a resource.
+ * Can be called during render or outside of React.
+ */
+export const registerGlobalSchemas = (resource, schemas) => {
+    if (!resource)
+        return;
+    const existing = globalSchemaRegistry[resource];
+    // Only update if we actually have new schema content to avoid redundant re-renders
+    if (schemas.fieldSchema || schemas.inputSchema) {
+        globalSchemaRegistry[resource] = {
+            ...existing,
+            fieldSchema: schemas.fieldSchema || existing?.fieldSchema,
+            inputSchema: schemas.inputSchema || existing?.inputSchema,
+        };
+        return true;
+    }
+    return false;
+};
+/**
+ * Parses unified schema children (Field components) into separate
+ * fieldSchema and inputSchema arrays.
+ */
+export const parseUnifiedSchema = (children) => {
+    const fieldSchema = [];
+    const inputSchema = [];
+    const mergeValidation = (isRequired, validate) => {
+        if (!isRequired)
+            return validate;
+        const requiredValidator = required();
+        if (!validate)
+            return requiredValidator;
+        if (Array.isArray(validate)) {
+            return validate.some((v) => v.isRequired) ? validate : [requiredValidator, ...validate];
+        }
+        return validate.isRequired ? validate : [requiredValidator, validate];
+    };
+    const walk = (nodes) => {
+        React.Children.forEach(nodes, (child) => {
+            if (!React.isValidElement(child))
+                return;
+            // Handle Fragments and FieldSchema by recursing into their children
+            if (child.type === Fragment || child.type === FieldSchema) {
+                walk(child.props.children);
+                return;
+            }
+            // Handle explicit InputSchema by only adding to inputSchema
+            if (child.type === InputSchema) {
+                React.Children.forEach(child.props.children, (inputChild) => {
+                    if (React.isValidElement(inputChild)) {
+                        inputSchema.push(inputChild);
+                    }
+                });
+                return;
+            }
+            // The field component itself goes into the field schema
+            fieldSchema.push(child);
+            // Extract input configuration
+            const { source, input, isRequired, description, constraintText, ...rest } = child.props;
+            if (input === false) {
+                return; // Explicitly excluded from inputs
+            }
+            if (React.isValidElement(input)) {
+                // Escape hatch: explicit input component provided
+                const validate = mergeValidation(isRequired, input.props.validate);
+                inputSchema.push(React.cloneElement(input, { ...rest, source, isRequired, validate, description, constraintText }));
+                return;
+            }
+            // Infer default input component
+            const InputComponent = getDefaultInputForField(child.type);
+            if (InputComponent) {
+                const inputProps = input || {};
+                const validate = mergeValidation(isRequired, inputProps.validate);
+                inputSchema.push(_jsx(InputComponent, { ...rest, ...inputProps, source: source, isRequired: isRequired, validate: validate, description: description, constraintText: constraintText }, source));
+            }
+        });
+    };
+    walk(children);
+    return {
+        fieldSchema: fieldSchema.length > 0 ? fieldSchema : undefined,
+        inputSchema: inputSchema.length > 0 ? inputSchema : undefined
+    };
+};
+export const getGlobalSchemas = (resource) => globalSchemaRegistry[resource];
+/**
+ * Registers default components to be used by ResourceSchema when not explicitly provided.
+ */
+export const registerDefaultResourceComponents = (components) => {
+    globalDefaultComponents = { ...globalDefaultComponents, ...components };
+};
+export const getDefaultResourceComponents = () => globalDefaultComponents;
+export const SchemaRegistryProvider = ({ children }) => {
+    // We still use state to trigger re-renders when new schemas are registered dynamically
+    const [, setTick] = useState(0);
+    const registerSchemas = useCallback((resource, schemas) => {
+        const updated = registerGlobalSchemas(resource, schemas);
+        if (updated) {
+            setTick((t) => t + 1);
+        }
+    }, []);
+    const getSchemas = useCallback((resource) => globalSchemaRegistry[resource], []);
+    const value = useMemo(() => ({
+        registerSchemas,
+        getSchemas,
+        defaultComponents: globalDefaultComponents
+    }), [registerSchemas, getSchemas]);
+    return (_jsx(SchemaRegistryContext.Provider, { value: value, children: children }));
+};
+export const useSchemaRegistry = () => {
+    const context = useContext(SchemaRegistryContext);
+    if (!context) {
+        return {
+            registerSchemas: registerGlobalSchemas,
+            getSchemas: getGlobalSchemas,
+            defaultComponents: globalDefaultComponents,
+        };
+    }
+    return context;
+};

package/dist/resource/index.d.ts

@@ -0,0 +1,6 @@
+export * from './FieldSchema';
+export * from './InputSchema';
+export * from './ResourceSchema';
+export * from './ResourceSchemaProvider';
+export * from './SchemaRegistry';
+export * from './ResourceContext';

package/dist/resource/index.js

@@ -0,0 +1,6 @@
+export * from './FieldSchema';
+export * from './InputSchema';
+export * from './ResourceSchema';
+export * from './ResourceSchemaProvider';
+export * from './SchemaRegistry';
+export * from './ResourceContext';

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@strato-admin/core",
+  "version": "0.1.0",
+  "description": "Strato Admin Core Framework",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "strato",
+    "admin",
+    "react-admin",
+    "cloudscape"
+  ],
+  "author": "Vadim Gubergrits <vadim.gubergrits@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vgrits/strato-admin.git",
+    "directory": "packages/strato-core"
+  },
+  "dependencies": {
+    "react-intl": "^8.1.3",
+    "@strato-admin/ra-core": "0.1.0"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.1.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  }
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+export * from '@strato-admin/ra-core';
+export * from './resource';
+
+// Resolve ambiguity between ra-core and strato-core resource exports.
+export { ResourceContext } from './resource';

package/src/ra-messages.ts

@@ -0,0 +1,352 @@
+/*
+This file contains a subset of react-admin messages used by ra-core directly.
+
+Some translations have issues in languages with gender and case. There's no easy
+fix for this. We cannot interpolate the resource name in a message like "Delete
+{name}" and expect it to be grammatically correct in all languages.
+
+A workaround requires the translator to torture the phrase in order to place the
+interpolated variable in nominative case. Message with translation issues are
+marked with a comment starting with "Translation issue".
+*/
+import { defineMessage } from 'react-intl';
+
+defineMessage({
+  id: 'ra.action.add',
+  defaultMessage: 'Add',
+  description: 'Label for the button to add a new record',
+});
+
+defineMessage({
+  id: 'ra.action.cancel',
+  defaultMessage: 'Cancel',
+  description: 'Label for the button to cancel an action',
+});
+
+defineMessage({
+  id: 'ra.action.clear_array_input',
+  defaultMessage: 'Clear the list',
+  description: 'Label for the button to clear an array input',
+});
+
+defineMessage({
+  id: 'ra.action.close',
+  defaultMessage: 'Close',
+  description: 'Label for the button to close a dialog or panel',
+});
+
+defineMessage({
+  id: 'ra.action.confirm',
+  defaultMessage: 'Confirm',
+  description: 'Label for the button to confirm an action',
+});
+
+defineMessage({
+  id: 'ra.action.create',
+  defaultMessage: 'Create',
+  description: 'Label for the button to create a new record',
+});
+
+defineMessage({
+  id: 'ra.action.delete',
+  defaultMessage: 'Delete',
+  description: 'Label for the button to delete one or more records',
+});
+
+defineMessage({
+  id: 'ra.action.edit',
+  defaultMessage: 'Edit',
+  description: 'Label for the button to edit a record',
+});
+
+defineMessage({
+  id: 'ra.action.move_down',
+  defaultMessage: 'Move down',
+  description: 'Label for the button to move an item down in a list',
+});
+
+defineMessage({
+  id: 'ra.action.move_up',
+  defaultMessage: 'Move up',
+  description: 'Label for the button to move an item up in a list',
+});
+
+defineMessage({
+  id: 'ra.action.refresh',
+  defaultMessage: 'Refresh',
+  description: 'Label for the button to refresh the current view',
+});
+
+defineMessage({
+  id: 'ra.action.remove',
+  defaultMessage: 'Remove',
+  description: 'Label for the button to remove an item',
+});
+
+defineMessage({
+  id: 'ra.action.save',
+  defaultMessage: 'Save',
+  description: 'Label for the button to save changes',
+});
+
+defineMessage({
+  id: 'ra.action.undo',
+  defaultMessage: 'Undo',
+  description: 'Label for the button to undo the last action',
+});
+
+defineMessage({
+  id: 'ra.action.update',
+  defaultMessage: 'Update',
+  description: 'Label for the button to update a record',
+});
+
+defineMessage({
+  id: 'ra.auth.auth_check_error',
+  defaultMessage: 'Please login to continue',
+  description: 'Message shown when the user needs to login',
+});
+
+defineMessage({
+  id: 'ra.boolean.true',
+  defaultMessage: 'Yes',
+  description: 'Label for the true boolean value',
+});
+
+defineMessage({
+  id: 'ra.boolean.false',
+  defaultMessage: 'No',
+  description: 'Label for the false boolean value',
+});
+
+defineMessage({
+  id: 'ra.input.references.all_missing',
+  defaultMessage: 'Unable to find references data.',
+  description: 'Error message when all references are missing',
+});
+
+defineMessage({
+  id: 'ra.input.references.many_missing',
+  defaultMessage: 'At least one of the associated references no longer appears to be available.',
+  description: 'Error message when many references are missing',
+});
+
+defineMessage({
+  id: 'ra.input.references.single_missing',
+  defaultMessage: 'Associated reference no longer appears to be available.',
+  description: 'Error message when a single reference is missing',
+});
+
+defineMessage({
+  id: 'ra.message.clear_array_input',
+  defaultMessage: 'Are you sure you want to clear the whole list?',
+  description: 'Confirmation message when clearing an array input',
+});
+
+// Translation issue: {name} gender must agree with "this" (e.g., ce/cette, этот/эту).
+defineMessage({
+  id: 'ra.message.delete_content',
+  defaultMessage: 'Are you sure you want to delete this {name}?',
+  description: 'Confirmation message when deleting a record',
+});
+
+// Translation issue: {name} might require the Accusative case (e.g., Delete "Usera").
+defineMessage({
+  id: 'ra.message.delete_title',
+  defaultMessage: 'Delete {name} {recordRepresentation}',
+  description: 'Title for the delete confirmation dialog',
+});
+
+defineMessage({
+  id: 'ra.message.invalid_form',
+  defaultMessage: 'The form is not valid. Please check for errors',
+  description: 'Error message shown when a form is invalid',
+});
+
+defineMessage({
+  id: 'ra.message.select_all_limit_reached',
+  defaultMessage: `
+    {max, plural,
+        one {There are too many elements to select them all. Only the first element was selected.}
+        other {There are too many elements to select them all. Only the first # elements were selected.}
+    }`,
+  description: 'Message shown when select all reaches its limit',
+});
+
+defineMessage({
+  id: 'ra.message.unsaved_changes',
+  defaultMessage: "Some of your changes weren't saved. Are you sure you want to ignore them?",
+  description: 'Confirmation message when leaving a page with unsaved changes',
+});
+
+// Translation issue: "update {name}" may require Accusative case; "these" must agree with gender of "items".
+defineMessage({
+  id: 'ra.message.update_content',
+  defaultMessage:
+    '{smart_count, plural, one {Are you sure you want to update {name} {recordRepresentation}?} other {Are you sure you want to update these # items?}}',
+  description: 'Confirmation message when updating one or more records',
+});
+
+// Translation issue: {name} might require the Accusative case (e.g., Update "Usera").
+defineMessage({
+  id: 'ra.message.update_title',
+  defaultMessage: '{smart_count, plural, one {Update {name} {recordRepresentation}} other {Update # {name}}}',
+  description: 'Title for the update confirmation dialog',
+});
+
+defineMessage({
+  id: 'ra.navigation.next',
+  defaultMessage: 'Go to next page',
+  description: 'Label for the button to go to the next page',
+});
+
+defineMessage({
+  id: 'ra.navigation.page',
+  defaultMessage: 'Go to page {page}',
+  description: 'Label for the button to go to a specific page',
+});
+
+defineMessage({
+  id: 'ra.navigation.page_range_info',
+  defaultMessage: '{offsetBegin}-{offsetEnd} of {total}',
+  description: 'Message showing the current page range and total number of records',
+});
+
+defineMessage({
+  id: 'ra.navigation.previous',
+  defaultMessage: 'Go to previous page',
+  description: 'Label for the button to go to the previous page',
+});
+
+defineMessage({
+  id: 'ra.notification.created',
+  defaultMessage: 'Element created',
+  description: 'Notification shown when a record is successfully created',
+});
+
+defineMessage({
+  id: 'ra.notification.data_provider_error',
+  defaultMessage: 'dataProvider error. Check the console for details.',
+  description: 'Notification shown when a dataProvider error occurs',
+});
+
+defineMessage({
+  id: 'ra.notification.deleted',
+  defaultMessage: '{smart_count, plural, one {Element deleted} other {# elements deleted}}',
+  description: 'Notification shown when one or more records are successfully deleted',
+});
+
+defineMessage({
+  id: 'ra.notification.http_error',
+  defaultMessage: 'Server communication error',
+  description: 'Notification shown when an HTTP error occurs',
+});
+
+defineMessage({
+  id: 'ra.notification.item_doesnt_exist',
+  defaultMessage: 'Element does not exist',
+  description: 'Notification shown when a record does not exist',
+});
+
+defineMessage({
+  id: 'ra.notification.logged_out',
+  defaultMessage: 'Your session has ended, please reconnect.',
+  description: 'Notification shown when the user is logged out',
+});
+
+defineMessage({
+  id: 'ra.notification.not_authorized',
+  defaultMessage: "You're not authorized to access this resource.",
+  description: 'Notification shown when the user is not authorized',
+});
+
+defineMessage({
+  id: 'ra.notification.updated',
+  defaultMessage: '{smart_count, plural, one {Element updated} other {# elements updated}}',
+  description: 'Notification shown when one or more records are successfully updated',
+});
+
+// Translation issue: {name} might require the Accusative case (e.g., Create "Usera").
+defineMessage({
+  id: 'ra.page.create',
+  defaultMessage: 'Create {name}',
+  description: 'Title for the record creation page',
+});
+
+defineMessage({
+  id: 'ra.page.edit',
+  defaultMessage: '{name} {recordRepresentation}',
+  description: 'Title for the record edition page',
+});
+
+defineMessage({
+  id: 'ra.page.list',
+  defaultMessage: '{name}',
+  description: 'Title for the record list page',
+});
+
+defineMessage({
+  id: 'ra.page.show',
+  defaultMessage: '{name} {recordRepresentation}',
+  description: 'Title for the record show page',
+});
+
+defineMessage({
+  id: 'ra.validation.email',
+  defaultMessage: 'Must be a valid email',
+  description: 'Validation error message for email inputs',
+});
+
+defineMessage({
+  id: 'ra.validation.maxLength',
+  defaultMessage: '{max, plural, one {Must be # character or less} other {Must be # characters or less}}',
+  description: 'Validation error message for maxLength',
+});
+
+defineMessage({
+  id: 'ra.validation.maxValue',
+  defaultMessage: '{max, plural, other {Must be # or less}}',
+  description: 'Validation error message for maxValue',
+});
+
+defineMessage({
+  id: 'ra.validation.minLength',
+  defaultMessage: '{min, plural, one {Must be # character at least} other {Must be # characters at least}}',
+  description: 'Validation error message for minLength',
+});
+
+defineMessage({
+  id: 'ra.validation.minValue',
+  defaultMessage: '{min, plural, other {Must be at least #}}',
+  description: 'Validation error message for minValue',
+});
+
+defineMessage({
+  id: 'ra.validation.number',
+  defaultMessage: 'Must be a number',
+  description: 'Validation error message for number inputs',
+});
+
+defineMessage({
+  id: 'ra.validation.oneOf',
+  defaultMessage: 'Must be one of: {options}',
+  description: 'Validation error message for oneOf',
+});
+
+defineMessage({
+  id: 'ra.validation.regex',
+  defaultMessage: 'Must match a specific format (regexp): {pattern}',
+  description: 'Validation error message for regex',
+});
+
+defineMessage({
+  id: 'ra.validation.required',
+  defaultMessage: 'Required',
+  description: 'Validation error message for required inputs',
+});
+
+defineMessage({
+  id: 'ra.validation.unique',
+  defaultMessage: 'Must be unique',
+  description: 'Validation error message for unique inputs',
+});

package/src/resource/FieldSchema.tsx

@@ -0,0 +1,26 @@
+import { createContext, useContext, ReactNode } from 'react';
+
+/**
+ * Context for the field schema.
+ * Stores an array of React elements (fields) defined in the FieldSchema.
+ */
+export const FieldSchemaContext = createContext<ReactNode[]>([]);
+
+/**
+ * Hook to access the field schema elements.
+ */
+export const useFieldSchema = () => {
+  return useContext(FieldSchemaContext);
+};
+
+export interface FieldSchemaProps {
+  children: ReactNode;
+}
+
+/**
+ * A marker component to define the fields of a resource.
+ * It doesn't render anything by itself, it's used by StratoResource to capture the schema.
+ */
+export const FieldSchema = (_props: FieldSchemaProps) => {
+  return null;
+};

package/src/resource/InputSchema.tsx

@@ -0,0 +1,26 @@
+import { createContext, useContext, ReactNode } from 'react';
+
+/**
+ * Context for the input schema.
+ * Stores an array of React elements (inputs) defined in the InputSchema.
+ */
+export const InputSchemaContext = createContext<ReactNode[]>([]);
+
+/**
+ * Hook to access the input schema elements.
+ */
+export const useInputSchema = () => {
+  return useContext(InputSchemaContext);
+};
+
+export interface InputSchemaProps {
+  children: ReactNode;
+}
+
+/**
+ * A marker component to define the form inputs of a resource.
+ * It doesn't render anything by itself, it's used by StratoResource to capture the schema.
+ */
+export const InputSchema = (_props: InputSchemaProps) => {
+  return null;
+};

package/src/resource/ResourceContext.tsx

@@ -0,0 +1,5 @@
+import { createContext, useContext } from 'react';
+
+export const ResourceContext = createContext<string | undefined>(undefined);
+
+export const useResource = () => useContext(ResourceContext);