@knkcs/mediahub-ui 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import { JSX } from 'react';
 import { PersistOptions } from 'zustand/middleware';
 import { QueryClient } from '@tanstack/react-query';
 import { ReactNode } from 'react';
+import { Schema } from '@knkcs/fieldkit/schema';
 import { StatusInfo } from '@knkcs/statushub-ui';
 import { StoreApi } from 'zustand';
 import { TFunction } from 'i18next';
@@ -365,6 +366,97 @@ export declare interface AssetTypeClient {
     delete(id: string): Promise<void>;
 }
 
+/**
+ * Create an asset type. The screen the package owns, replacing the
+ * standalone's create dialog and core's create page (knkCS/mediahub#137/#140).
+ *
+ * The slug follows the name until it is edited by hand and then stops — the
+ * unconditional overwrite the standalone had silently discarded a slug someone
+ * typed on purpose. The server's rule (lowercase alphanumeric with hyphens, at
+ * least two characters) is stated on the form and enforced before submit,
+ * because without both a name like `Bild Anhang` produced a bare 400
+ * (knkcms/core#861).
+ */
+export declare function AssetTypeCreate({ assetTypesPath, onCreated, onCancel, }: AssetTypeCreateProps): default_2.JSX.Element;
+
+export declare namespace AssetTypeCreate {
+    var displayName: string;
+}
+
+export declare interface AssetTypeCreateProps {
+    /**
+     * The host's asset-type index path — used as the breadcrumb's target. A
+     * path, not a route: the screen never navigates, it only says where the
+     * list it belongs to lives (core's `docs/service-integration.md`).
+     */
+    assetTypesPath: string;
+    /** Called with the created asset type; the host decides where to go. */
+    onCreated?: (assetType: AssetTypeInfo) => void;
+    /** Called when the administrator abandons the form. */
+    onCancel?: () => void;
+}
+
+/**
+ * The packaged asset-type detail screen: view, edit and delete one asset type,
+ * with its fieldkit metadata schema on a second tab.
+ *
+ * **Correct against the wire, not against the declared type.** Connect omits
+ * empty repeated fields and empty strings from its JSON, and a host client that
+ * returns the wire object unmapped therefore delivers `undefined` where
+ * `AssetTypeInfo` promises `string` or `string[]`. Reading one of those
+ * unguarded is what took core's detail page down (knkcms/core#862, #863).
+ * Every field below is defaulted at the one place it is read, so an absent
+ * value renders as empty rather than throwing — and never flips a controlled
+ * input to uncontrolled, which is the quieter version of the same bug.
+ */
+export declare function AssetTypeDetail({ typeId, assetTypesPath, onBack, onDeleted, }: AssetTypeDetailProps): default_2.JSX.Element;
+
+export declare namespace AssetTypeDetail {
+    var displayName: string;
+}
+
+export declare interface AssetTypeDetailProps {
+    /** The asset type to show. */
+    typeId: string;
+    /**
+     * Typed path of the host's asset-type index, used for the breadcrumb back
+     * link. The screen never routes itself — the host owns its URLs
+     * (core's `docs/service-integration.md`).
+     */
+    assetTypesPath?: string;
+    /**
+     * Navigate back to the asset-type index. Given one, the screen renders a
+     * back affordance that confirms before discarding unsaved edits — the
+     * breadcrumb link above is the host's own navigation and the screen cannot
+     * intercept it.
+     */
+    onBack?: () => void;
+    /** Called after a successful delete; the host decides where to go next. */
+    onDeleted?: () => void;
+}
+
+/**
+ * The workspace's asset types, listed. The package owns the screen; both hosts
+ * compose it and keep their own routing to themselves (#142, parent #138).
+ */
+export declare function AssetTypeIndex(props: AssetTypeIndexProps): React.JSX.Element;
+
+export declare namespace AssetTypeIndex {
+    var displayName: string;
+}
+
+export declare interface AssetTypeIndexProps {
+    /**
+     * An asset type was opened. The host decides what that means — it receives
+     * the id and nothing else, because this package must not know either host's
+     * URL structure (core's `docs/service-integration.md`; spec #138). Screens,
+     * not routes: nothing here navigates and nothing here builds a path.
+     */
+    onOpen?: (assetTypeId: string) => void;
+    /** The reader asked for a new asset type. Same contract as `onOpen`. */
+    onCreate?: () => void;
+}
+
 export declare interface AssetTypeInfo {
     id: string;
     workspaceId: string;
@@ -840,6 +932,19 @@ declare interface FolderTreeProps {
     onFolderSelect: (folderId: string) => void;
 }
 
+/**
+ * Takes `string[] | undefined` although `AssetTypeInfo.allowedMimeTypes` is
+ * declared `string[]`, because a host client may return the wire object
+ * unmapped under that type. Connect omits an empty repeated field from the
+ * JSON, so an asset type with no MIME types arrives without the key at all and
+ * the declared type is a lie. The package's own client maps through
+ * `mapAssetType`, which defaults it; core's did not, and the detail page went
+ * down on "Cannot read properties of undefined (reading 'join')"
+ * (knkcms/core#863). Tolerating the absent list here is the fix, kept in one
+ * place for every host.
+ */
+export declare const formatMimeTypeList: (value: string[] | undefined) => string;
+
 export declare interface GetUploadUrlParams {
     assetId: string;
     filename: string;
@@ -945,6 +1050,38 @@ export declare const i18nResources: {
                     unknownValue: string;
                 };
             };
+            assetTypeDetail: {
+                breadcrumbAssetTypes: string;
+                notFound: string;
+                untitled: string;
+                backButtonAria: string;
+                generalTab: string;
+                metadataTab: string;
+                nameLabel: string;
+                nameRequired: string;
+                slugLabel: string;
+                descriptionLabel: string;
+                descriptionPlaceholder: string;
+                allowedMimeTypesLabel: string;
+                allowedMimeTypesDescription: string;
+                activeLabel: string;
+                save: string;
+                delete: string;
+                saveSuccessToast: string;
+                saveFailedToast: string;
+                schemaSavedToast: string;
+                deleteConfirmTitle: string;
+                deleteConfirmMessage: string;
+                deleteConfirmLabel: string;
+                deleteSuccessToast: string;
+                deleteFailedToast: string;
+                discardSchemaConfirmTitle: string;
+                discardSchemaConfirmMessage: string;
+                discardSchemaConfirmLabel: string;
+                discardConfirmTitle: string;
+                discardConfirmMessage: string;
+                discardConfirmLabel: string;
+            };
             assetLibrary: {
                 pageTitle: string;
                 uploadButton: string;
@@ -1176,6 +1313,52 @@ export declare const i18nResources: {
                 closeLabel: string;
                 resolveHint: string;
             };
+            assetTypeCreate: {
+                title: string;
+                breadcrumbAssetTypes: string;
+                nameLabel: string;
+                namePlaceholder: string;
+                nameRequired: string;
+                slugLabel: string;
+                slugHint: string;
+                slugInvalid: string;
+                descriptionLabel: string;
+                descriptionPlaceholder: string;
+                allowedMimeTypesLabel: string;
+                allowedMimeTypesHint: string;
+                allowedMimeTypesPlaceholder: string;
+                metadataSchemaLabel: string;
+                metadataSchemaHint: string;
+                submit: string;
+                cancel: string;
+                createdToast: string;
+                createFailedToast: string;
+            };
+            assetTypeIndex: {
+                pageTitle: string;
+                pageSubtitle: string;
+                newButton: string;
+                searchPlaceholder: string;
+                typesCount: string;
+                columnName: string;
+                columnSlug: string;
+                columnMimeTypes: string;
+                columnFields: string;
+                columnStatus: string;
+                statusActive: string;
+                statusInactive: string;
+                actionDelete: string;
+                deleteConfirmTitle: string;
+                deleteConfirmMessage: string;
+                deleteConfirmLabel: string;
+                deleteSuccessToast: string;
+                deleteFailedToast: string;
+                noAssetTypesHeader: string;
+                noAssetTypesDescription: string;
+                noMatchesHeader: string;
+                noMatchesDescription: string;
+                loadFailedHeader: string;
+            };
         };
     };
     de: {
@@ -1238,6 +1421,38 @@ export declare const i18nResources: {
                     unknownValue: string;
                 };
             };
+            assetTypeDetail: {
+                breadcrumbAssetTypes: string;
+                notFound: string;
+                untitled: string;
+                backButtonAria: string;
+                generalTab: string;
+                metadataTab: string;
+                nameLabel: string;
+                nameRequired: string;
+                slugLabel: string;
+                descriptionLabel: string;
+                descriptionPlaceholder: string;
+                allowedMimeTypesLabel: string;
+                allowedMimeTypesDescription: string;
+                activeLabel: string;
+                save: string;
+                delete: string;
+                saveSuccessToast: string;
+                saveFailedToast: string;
+                schemaSavedToast: string;
+                deleteConfirmTitle: string;
+                deleteConfirmMessage: string;
+                deleteConfirmLabel: string;
+                deleteSuccessToast: string;
+                deleteFailedToast: string;
+                discardSchemaConfirmTitle: string;
+                discardSchemaConfirmMessage: string;
+                discardSchemaConfirmLabel: string;
+                discardConfirmTitle: string;
+                discardConfirmMessage: string;
+                discardConfirmLabel: string;
+            };
             assetLibrary: {
                 pageTitle: string;
                 uploadButton: string;
@@ -1469,6 +1684,52 @@ export declare const i18nResources: {
                 closeLabel: string;
                 resolveHint: string;
             };
+            assetTypeCreate: {
+                title: string;
+                breadcrumbAssetTypes: string;
+                nameLabel: string;
+                namePlaceholder: string;
+                nameRequired: string;
+                slugLabel: string;
+                slugHint: string;
+                slugInvalid: string;
+                descriptionLabel: string;
+                descriptionPlaceholder: string;
+                allowedMimeTypesLabel: string;
+                allowedMimeTypesHint: string;
+                allowedMimeTypesPlaceholder: string;
+                metadataSchemaLabel: string;
+                metadataSchemaHint: string;
+                submit: string;
+                cancel: string;
+                createdToast: string;
+                createFailedToast: string;
+            };
+            assetTypeIndex: {
+                pageTitle: string;
+                pageSubtitle: string;
+                newButton: string;
+                searchPlaceholder: string;
+                typesCount: string;
+                columnName: string;
+                columnSlug: string;
+                columnMimeTypes: string;
+                columnFields: string;
+                columnStatus: string;
+                statusActive: string;
+                statusInactive: string;
+                actionDelete: string;
+                deleteConfirmTitle: string;
+                deleteConfirmMessage: string;
+                deleteConfirmLabel: string;
+                deleteSuccessToast: string;
+                deleteFailedToast: string;
+                noAssetTypesHeader: string;
+                noAssetTypesDescription: string;
+                noMatchesHeader: string;
+                noMatchesDescription: string;
+                loadFailedHeader: string;
+            };
         };
     };
 };
@@ -1623,6 +1884,23 @@ export declare interface MediahubProviderProps {
     children: ReactNode;
 }
 
+/**
+ * The asset type's fieldkit metadata schema, edited on a page with room for it
+ * (spec knkCS/mediahub#138, story 7) rather than as a JSON textarea.
+ */
+export declare const MetadataSchemaEditor: default_2.FC<MetadataSchemaEditorProps>;
+
+export declare interface MetadataSchemaEditorProps {
+    typeId: string;
+    /**
+     * The committed schema — SpecEditor's baseline. Content-equal re-parses on
+     * background refetches are ignored by the editor's stability contract.
+     */
+    initialSchema: Schema;
+    /** Wire into the screen's unsaved-changes tab guard. */
+    onDirtyChange?: (dirty: boolean) => void;
+}
+
 /**
  * Destination folder picker for moving a folder or an asset. Destinations
  * that would trip the server's leak guard (moving exposed content into a
@@ -1662,6 +1940,14 @@ export declare interface Page<T> {
     totalPages: number;
 }
 
+/**
+ * A comma-separated MIME type field, both directions: the asset-type create and
+ * detail screens edit `AssetTypeInfo.allowedMimeTypes` (a `string[]`) as one
+ * plain-text input, so both parse the same way back into the array the mutation
+ * sends.
+ */
+export declare const parseMimeTypeList: (value: string) => string[];
+
 declare interface PreferencesActions {
     toggleSidebar: () => void;
     setViewMode: (mode: "list" | "grid") => void;
@@ -1749,6 +2035,19 @@ declare type SelectionStore = SelectionState & SelectionActions;
  */
 export declare function showRpcErrorToast(err: unknown, fallbackTitle: string): void;
 
+/**
+ * Convert a display name into a slug mediahub accepts: lowercase alphanumeric
+ * with hyphens.
+ *
+ * Non-ASCII is a separator, not transliterated — "Bürgerdaten" becomes
+ * "b-rgerdaten" — because the server's rule is the ASCII one and a
+ * transliteration would produce a slug the user never saw derived.
+ *
+ * Both hosts carried their own copy of this (knkCS/mediahub#137); the package
+ * owns it now so the asset-type screens share one derivation.
+ */
+export declare function slugify(name: string): string;
+
 export declare interface StatusCountInfo {
     statusSlug: string;
     name: string;