@strapi/upload 5.51.0 → 5.51.2

package/dist/admin/future/pages/Assets/hooks/useListFilters.js

@@ -0,0 +1,168 @@
+'use strict';
+
+var strapiAdmin = require('@strapi/admin/strapi-admin');
+
+/**
+ * Filter state for the assets list, backed by a single `?filters=` query param
+ * so the applied filters are shareable and survive Back/refresh.
+ *
+ * Serialized grammar — badges separated by `;`, one badge is
+ * `<field>:<condition>:<value>`:
+ *
+ * - `type:is:picture,audio` / `type:not:folder`
+ * - `created:within:1week` / `updated:notwithin:3months` / `created:exact:1day`
+ * - `created:rangeis:2024-01-01..2024-04-07` / `created:rangenot:...`
+ *
+ * Relative presets stay relative in the URL on purpose: the badge label
+ * ("1 week ago") remains truthful forever and a shared link means "within the
+ * last week from whenever it is opened". Resolution to absolute timestamps
+ * happens at query-build time (see utils/buildAssetFilters.ts).
+ *
+ * Several badges for the same field are allowed, even contradictory ones —
+ * everything is combined with AND; contradictions simply produce the filtered
+ * empty state.
+ */ const TYPE_VALUES = [
+    'folder',
+    'picture',
+    'audio',
+    'video',
+    'document'
+];
+const DATE_PRESETS = [
+    '1day',
+    '3days',
+    '1week',
+    '1month',
+    '3months',
+    '6months',
+    '1year'
+];
+const FIELD_TOKENS = {
+    created: 'createdAt',
+    updated: 'updatedAt'
+};
+const FIELD_TOKEN_BY_FIELD = {
+    createdAt: 'created',
+    updatedAt: 'updated'
+};
+const PRESET_CONDITION_TOKENS = {
+    exact: 'isExactly',
+    within: 'withinLast',
+    notwithin: 'notWithinLast'
+};
+const PRESET_TOKEN_BY_CONDITION = {
+    isExactly: 'exact',
+    withinLast: 'within',
+    notWithinLast: 'notwithin'
+};
+const RANGE_CONDITION_TOKENS = {
+    rangeis: 'is',
+    rangenot: 'isNot'
+};
+const RANGE_TOKEN_BY_CONDITION = {
+    is: 'rangeis',
+    isNot: 'rangenot'
+};
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+const isTypeValue = (value)=>TYPE_VALUES.includes(value);
+const isDatePreset = (value)=>DATE_PRESETS.includes(value);
+const parseBadge = (raw)=>{
+    const [field, condition, value] = raw.split(':');
+    if (!field || !condition || !value) {
+        return null;
+    }
+    if (field === 'type') {
+        if (condition !== 'is' && condition !== 'not') {
+            return null;
+        }
+        const values = value.split(',').filter(isTypeValue);
+        return values.length > 0 ? {
+            kind: 'type',
+            condition: condition === 'is' ? 'is' : 'isNot',
+            values
+        } : null;
+    }
+    const dateField = FIELD_TOKENS[field];
+    if (!dateField) {
+        return null;
+    }
+    if (condition in PRESET_CONDITION_TOKENS) {
+        return isDatePreset(value) ? {
+            kind: 'date',
+            field: dateField,
+            mode: 'preset',
+            condition: PRESET_CONDITION_TOKENS[condition],
+            preset: value
+        } : null;
+    }
+    if (condition in RANGE_CONDITION_TOKENS) {
+        const [from, to] = value.split('..');
+        return DATE_RE.test(from ?? '') && DATE_RE.test(to ?? '') ? {
+            kind: 'date',
+            field: dateField,
+            mode: 'range',
+            condition: RANGE_CONDITION_TOKENS[condition],
+            from,
+            to
+        } : null;
+    }
+    return null;
+};
+/**
+ * `unknown` on purpose: the query string is user-editable, and qs parses
+ * shapes like `?filters[]=a&filters[]=b` into arrays — the guard is what
+ * makes the caller's `?filters=` type an assertion rather than a crash.
+ */ const parseFiltersParam = (raw)=>{
+    if (typeof raw !== 'string' || raw === '') {
+        return [];
+    }
+    return raw.split(';').map(parseBadge).filter((filter)=>filter !== null);
+};
+const serializeBadge = (filter)=>{
+    if (filter.kind === 'type') {
+        return `type:${filter.condition === 'is' ? 'is' : 'not'}:${filter.values.join(',')}`;
+    }
+    const field = FIELD_TOKEN_BY_FIELD[filter.field];
+    if (filter.mode === 'preset') {
+        return `${field}:${PRESET_TOKEN_BY_CONDITION[filter.condition]}:${filter.preset}`;
+    }
+    return `${field}:${RANGE_TOKEN_BY_CONDITION[filter.condition]}:${filter.from}..${filter.to}`;
+};
+const serializeFilters = (filters)=>filters.map(serializeBadge).join(';');
+const useListFilters = ()=>{
+    const [{ query }, setQuery] = strapiAdmin.useQueryParams();
+    const filters = parseFiltersParam(query?.filters);
+    // `replace: true` on every write: filters are edited in rapid micro-steps
+    // (each checkbox of the keep-open Type submenu, each badge segment edit), so
+    // pushing would turn one logical change into a stack of Back entries. The
+    // URL stays shareable and refresh-safe either way.
+    const writeFilters = (next)=>{
+        if (next.length === 0) {
+            setQuery({
+                filters: ''
+            }, 'remove', true);
+        } else {
+            setQuery({
+                filters: serializeFilters(next)
+            }, 'push', true);
+        }
+    };
+    return {
+        filters,
+        serialized: serializeFilters(filters),
+        addFilter: (filter)=>writeFilters([
+                ...filters,
+                filter
+            ]),
+        updateFilter: (index, filter)=>writeFilters(filters.map((f, i)=>i === index ? filter : f)),
+        removeFilter: (index)=>writeFilters(filters.filter((_, i)=>i !== index)),
+        clearFilters: ()=>writeFilters([])
+    };
+};
+
+exports.DATE_PRESETS = DATE_PRESETS;
+exports.TYPE_VALUES = TYPE_VALUES;
+exports.parseFiltersParam = parseFiltersParam;
+exports.serializeFilters = serializeFilters;
+exports.useListFilters = useListFilters;
+//# sourceMappingURL=useListFilters.js.map

package/dist/admin/future/pages/Assets/hooks/useListFilters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useListFilters.js","sources":["../../../../../../admin/src/future/pages/Assets/hooks/useListFilters.ts"],"sourcesContent":["import { useQueryParams } from '@strapi/admin/strapi-admin';\n\n/**\n * Filter state for the assets list, backed by a single `?filters=` query param\n * so the applied filters are shareable and survive Back/refresh.\n *\n * Serialized grammar — badges separated by `;`, one badge is\n * `<field>:<condition>:<value>`:\n *\n * - `type:is:picture,audio` / `type:not:folder`\n * - `created:within:1week` / `updated:notwithin:3months` / `created:exact:1day`\n * - `created:rangeis:2024-01-01..2024-04-07` / `created:rangenot:...`\n *\n * Relative presets stay relative in the URL on purpose: the badge label\n * (\"1 week ago\") remains truthful forever and a shared link means \"within the\n * last week from whenever it is opened\". Resolution to absolute timestamps\n * happens at query-build time (see utils/buildAssetFilters.ts).\n *\n * Several badges for the same field are allowed, even contradictory ones —\n * everything is combined with AND; contradictions simply produce the filtered\n * empty state.\n */\n\nexport const TYPE_VALUES = ['folder', 'picture', 'audio', 'video', 'document'] as const;\nexport type TypeValue = (typeof TYPE_VALUES)[number];\n\nexport const DATE_PRESETS = [\n  '1day',\n  '3days',\n  '1week',\n  '1month',\n  '3months',\n  '6months',\n  '1year',\n] as const;\nexport type DatePreset = (typeof DATE_PRESETS)[number];\n\nexport type TypeCondition = 'is' | 'isNot';\nexport type PresetCondition = 'isExactly' | 'withinLast' | 'notWithinLast';\nexport type RangeCondition = 'is' | 'isNot';\n\nexport type DateField = 'createdAt' | 'updatedAt';\n\nexport interface TypeFilter {\n  kind: 'type';\n  condition: TypeCondition;\n  values: TypeValue[];\n}\n\nexport interface DatePresetFilter {\n  kind: 'date';\n  field: DateField;\n  mode: 'preset';\n  condition: PresetCondition;\n  preset: DatePreset;\n}\n\nexport interface DateRangeFilter {\n  kind: 'date';\n  field: DateField;\n  mode: 'range';\n  condition: RangeCondition;\n  /** Calendar dates, `YYYY-MM-DD`, inclusive on both ends. */\n  from: string;\n  to: string;\n}\n\nexport type DateFilter = DatePresetFilter | DateRangeFilter;\nexport type ListFilter = TypeFilter | DateFilter;\n\nconst FIELD_TOKENS: Record<string, DateField> = {\n  created: 'createdAt',\n  updated: 'updatedAt',\n};\nconst FIELD_TOKEN_BY_FIELD: Record<DateField, string> = {\n  createdAt: 'created',\n  updatedAt: 'updated',\n};\n\nconst PRESET_CONDITION_TOKENS: Record<string, PresetCondition> = {\n  exact: 'isExactly',\n  within: 'withinLast',\n  notwithin: 'notWithinLast',\n};\nconst PRESET_TOKEN_BY_CONDITION: Record<PresetCondition, string> = {\n  isExactly: 'exact',\n  withinLast: 'within',\n  notWithinLast: 'notwithin',\n};\n\nconst RANGE_CONDITION_TOKENS: Record<string, RangeCondition> = {\n  rangeis: 'is',\n  rangenot: 'isNot',\n};\nconst RANGE_TOKEN_BY_CONDITION: Record<RangeCondition, string> = {\n  is: 'rangeis',\n  isNot: 'rangenot',\n};\n\nconst DATE_RE = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nconst isTypeValue = (value: string): value is TypeValue =>\n  (TYPE_VALUES as readonly string[]).includes(value);\n\nconst isDatePreset = (value: string): value is DatePreset =>\n  (DATE_PRESETS as readonly string[]).includes(value);\n\nconst parseBadge = (raw: string): ListFilter | null => {\n  const [field, condition, value] = raw.split(':');\n\n  if (!field || !condition || !value) {\n    return null;\n  }\n\n  if (field === 'type') {\n    if (condition !== 'is' && condition !== 'not') {\n      return null;\n    }\n    const values = value.split(',').filter(isTypeValue);\n\n    return values.length > 0\n      ? { kind: 'type', condition: condition === 'is' ? 'is' : 'isNot', values }\n      : null;\n  }\n\n  const dateField = FIELD_TOKENS[field];\n  if (!dateField) {\n    return null;\n  }\n\n  if (condition in PRESET_CONDITION_TOKENS) {\n    return isDatePreset(value)\n      ? {\n          kind: 'date',\n          field: dateField,\n          mode: 'preset',\n          condition: PRESET_CONDITION_TOKENS[condition],\n          preset: value,\n        }\n      : null;\n  }\n\n  if (condition in RANGE_CONDITION_TOKENS) {\n    const [from, to] = value.split('..');\n\n    return DATE_RE.test(from ?? '') && DATE_RE.test(to ?? '')\n      ? {\n          kind: 'date',\n          field: dateField,\n          mode: 'range',\n          condition: RANGE_CONDITION_TOKENS[condition],\n          from,\n          to,\n        }\n      : null;\n  }\n\n  return null;\n};\n\n/**\n * `unknown` on purpose: the query string is user-editable, and qs parses\n * shapes like `?filters[]=a&filters[]=b` into arrays — the guard is what\n * makes the caller's `?filters=` type an assertion rather than a crash.\n */\nexport const parseFiltersParam = (raw: unknown): ListFilter[] => {\n  if (typeof raw !== 'string' || raw === '') {\n    return [];\n  }\n\n  return raw\n    .split(';')\n    .map(parseBadge)\n    .filter((filter): filter is ListFilter => filter !== null);\n};\n\nconst serializeBadge = (filter: ListFilter): string => {\n  if (filter.kind === 'type') {\n    return `type:${filter.condition === 'is' ? 'is' : 'not'}:${filter.values.join(',')}`;\n  }\n\n  const field = FIELD_TOKEN_BY_FIELD[filter.field];\n\n  if (filter.mode === 'preset') {\n    return `${field}:${PRESET_TOKEN_BY_CONDITION[filter.condition]}:${filter.preset}`;\n  }\n\n  return `${field}:${RANGE_TOKEN_BY_CONDITION[filter.condition]}:${filter.from}..${filter.to}`;\n};\n\nexport const serializeFilters = (filters: ListFilter[]): string =>\n  filters.map(serializeBadge).join(';');\n\nexport interface ListFilters {\n  filters: ListFilter[];\n  /** Serialized form — stable fingerprint for list-identity (selection reset). */\n  serialized: string;\n  addFilter: (filter: ListFilter) => void;\n  /** Replaces the badge at `index` (condition or value edited in place). */\n  updateFilter: (index: number, filter: ListFilter) => void;\n  removeFilter: (index: number) => void;\n  clearFilters: () => void;\n}\n\nexport const useListFilters = (): ListFilters => {\n  const [{ query }, setQuery] = useQueryParams<{ filters?: string }>();\n\n  const filters = parseFiltersParam(query?.filters);\n\n  // `replace: true` on every write: filters are edited in rapid micro-steps\n  // (each checkbox of the keep-open Type submenu, each badge segment edit), so\n  // pushing would turn one logical change into a stack of Back entries. The\n  // URL stays shareable and refresh-safe either way.\n  const writeFilters = (next: ListFilter[]) => {\n    if (next.length === 0) {\n      setQuery({ filters: '' }, 'remove', true);\n    } else {\n      setQuery({ filters: serializeFilters(next) }, 'push', true);\n    }\n  };\n\n  return {\n    filters,\n    serialized: serializeFilters(filters),\n    addFilter: (filter) => writeFilters([...filters, filter]),\n    updateFilter: (index, filter) =>\n      writeFilters(filters.map((f, i) => (i === index ? filter : f))),\n    removeFilter: (index) => writeFilters(filters.filter((_, i) => i !== index)),\n    clearFilters: () => writeFilters([]),\n  };\n};\n"],"names":["TYPE_VALUES","DATE_PRESETS","FIELD_TOKENS","created","updated","FIELD_TOKEN_BY_FIELD","createdAt","updatedAt","PRESET_CONDITION_TOKENS","exact","within","notwithin","PRESET_TOKEN_BY_CONDITION","isExactly","withinLast","notWithinLast","RANGE_CONDITION_TOKENS","rangeis","rangenot","RANGE_TOKEN_BY_CONDITION","is","isNot","DATE_RE","isTypeValue","value","includes","isDatePreset","parseBadge","raw","field","condition","split","values","filter","length","kind","dateField","mode","preset","from","to","test","parseFiltersParam","map","serializeBadge","join","serializeFilters","filters","useListFilters","query","setQuery","useQueryParams","writeFilters","next","serialized","addFilter","updateFilter","index","f","i","removeFilter","_","clearFilters"],"mappings":"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"}

package/dist/admin/future/pages/Assets/hooks/useListFilters.mjs

@@ -0,0 +1,162 @@
+import { useQueryParams } from '@strapi/admin/strapi-admin';
+
+/**
+ * Filter state for the assets list, backed by a single `?filters=` query param
+ * so the applied filters are shareable and survive Back/refresh.
+ *
+ * Serialized grammar — badges separated by `;`, one badge is
+ * `<field>:<condition>:<value>`:
+ *
+ * - `type:is:picture,audio` / `type:not:folder`
+ * - `created:within:1week` / `updated:notwithin:3months` / `created:exact:1day`
+ * - `created:rangeis:2024-01-01..2024-04-07` / `created:rangenot:...`
+ *
+ * Relative presets stay relative in the URL on purpose: the badge label
+ * ("1 week ago") remains truthful forever and a shared link means "within the
+ * last week from whenever it is opened". Resolution to absolute timestamps
+ * happens at query-build time (see utils/buildAssetFilters.ts).
+ *
+ * Several badges for the same field are allowed, even contradictory ones —
+ * everything is combined with AND; contradictions simply produce the filtered
+ * empty state.
+ */ const TYPE_VALUES = [
+    'folder',
+    'picture',
+    'audio',
+    'video',
+    'document'
+];
+const DATE_PRESETS = [
+    '1day',
+    '3days',
+    '1week',
+    '1month',
+    '3months',
+    '6months',
+    '1year'
+];
+const FIELD_TOKENS = {
+    created: 'createdAt',
+    updated: 'updatedAt'
+};
+const FIELD_TOKEN_BY_FIELD = {
+    createdAt: 'created',
+    updatedAt: 'updated'
+};
+const PRESET_CONDITION_TOKENS = {
+    exact: 'isExactly',
+    within: 'withinLast',
+    notwithin: 'notWithinLast'
+};
+const PRESET_TOKEN_BY_CONDITION = {
+    isExactly: 'exact',
+    withinLast: 'within',
+    notWithinLast: 'notwithin'
+};
+const RANGE_CONDITION_TOKENS = {
+    rangeis: 'is',
+    rangenot: 'isNot'
+};
+const RANGE_TOKEN_BY_CONDITION = {
+    is: 'rangeis',
+    isNot: 'rangenot'
+};
+const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+const isTypeValue = (value)=>TYPE_VALUES.includes(value);
+const isDatePreset = (value)=>DATE_PRESETS.includes(value);
+const parseBadge = (raw)=>{
+    const [field, condition, value] = raw.split(':');
+    if (!field || !condition || !value) {
+        return null;
+    }
+    if (field === 'type') {
+        if (condition !== 'is' && condition !== 'not') {
+            return null;
+        }
+        const values = value.split(',').filter(isTypeValue);
+        return values.length > 0 ? {
+            kind: 'type',
+            condition: condition === 'is' ? 'is' : 'isNot',
+            values
+        } : null;
+    }
+    const dateField = FIELD_TOKENS[field];
+    if (!dateField) {
+        return null;
+    }
+    if (condition in PRESET_CONDITION_TOKENS) {
+        return isDatePreset(value) ? {
+            kind: 'date',
+            field: dateField,
+            mode: 'preset',
+            condition: PRESET_CONDITION_TOKENS[condition],
+            preset: value
+        } : null;
+    }
+    if (condition in RANGE_CONDITION_TOKENS) {
+        const [from, to] = value.split('..');
+        return DATE_RE.test(from ?? '') && DATE_RE.test(to ?? '') ? {
+            kind: 'date',
+            field: dateField,
+            mode: 'range',
+            condition: RANGE_CONDITION_TOKENS[condition],
+            from,
+            to
+        } : null;
+    }
+    return null;
+};
+/**
+ * `unknown` on purpose: the query string is user-editable, and qs parses
+ * shapes like `?filters[]=a&filters[]=b` into arrays — the guard is what
+ * makes the caller's `?filters=` type an assertion rather than a crash.
+ */ const parseFiltersParam = (raw)=>{
+    if (typeof raw !== 'string' || raw === '') {
+        return [];
+    }
+    return raw.split(';').map(parseBadge).filter((filter)=>filter !== null);
+};
+const serializeBadge = (filter)=>{
+    if (filter.kind === 'type') {
+        return `type:${filter.condition === 'is' ? 'is' : 'not'}:${filter.values.join(',')}`;
+    }
+    const field = FIELD_TOKEN_BY_FIELD[filter.field];
+    if (filter.mode === 'preset') {
+        return `${field}:${PRESET_TOKEN_BY_CONDITION[filter.condition]}:${filter.preset}`;
+    }
+    return `${field}:${RANGE_TOKEN_BY_CONDITION[filter.condition]}:${filter.from}..${filter.to}`;
+};
+const serializeFilters = (filters)=>filters.map(serializeBadge).join(';');
+const useListFilters = ()=>{
+    const [{ query }, setQuery] = useQueryParams();
+    const filters = parseFiltersParam(query?.filters);
+    // `replace: true` on every write: filters are edited in rapid micro-steps
+    // (each checkbox of the keep-open Type submenu, each badge segment edit), so
+    // pushing would turn one logical change into a stack of Back entries. The
+    // URL stays shareable and refresh-safe either way.
+    const writeFilters = (next)=>{
+        if (next.length === 0) {
+            setQuery({
+                filters: ''
+            }, 'remove', true);
+        } else {
+            setQuery({
+                filters: serializeFilters(next)
+            }, 'push', true);
+        }
+    };
+    return {
+        filters,
+        serialized: serializeFilters(filters),
+        addFilter: (filter)=>writeFilters([
+                ...filters,
+                filter
+            ]),
+        updateFilter: (index, filter)=>writeFilters(filters.map((f, i)=>i === index ? filter : f)),
+        removeFilter: (index)=>writeFilters(filters.filter((_, i)=>i !== index)),
+        clearFilters: ()=>writeFilters([])
+    };
+};
+
+export { DATE_PRESETS, TYPE_VALUES, parseFiltersParam, serializeFilters, useListFilters };
+//# sourceMappingURL=useListFilters.mjs.map

package/dist/admin/future/pages/Assets/hooks/useListFilters.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useListFilters.mjs","sources":["../../../../../../admin/src/future/pages/Assets/hooks/useListFilters.ts"],"sourcesContent":["import { useQueryParams } from '@strapi/admin/strapi-admin';\n\n/**\n * Filter state for the assets list, backed by a single `?filters=` query param\n * so the applied filters are shareable and survive Back/refresh.\n *\n * Serialized grammar — badges separated by `;`, one badge is\n * `<field>:<condition>:<value>`:\n *\n * - `type:is:picture,audio` / `type:not:folder`\n * - `created:within:1week` / `updated:notwithin:3months` / `created:exact:1day`\n * - `created:rangeis:2024-01-01..2024-04-07` / `created:rangenot:...`\n *\n * Relative presets stay relative in the URL on purpose: the badge label\n * (\"1 week ago\") remains truthful forever and a shared link means \"within the\n * last week from whenever it is opened\". Resolution to absolute timestamps\n * happens at query-build time (see utils/buildAssetFilters.ts).\n *\n * Several badges for the same field are allowed, even contradictory ones —\n * everything is combined with AND; contradictions simply produce the filtered\n * empty state.\n */\n\nexport const TYPE_VALUES = ['folder', 'picture', 'audio', 'video', 'document'] as const;\nexport type TypeValue = (typeof TYPE_VALUES)[number];\n\nexport const DATE_PRESETS = [\n  '1day',\n  '3days',\n  '1week',\n  '1month',\n  '3months',\n  '6months',\n  '1year',\n] as const;\nexport type DatePreset = (typeof DATE_PRESETS)[number];\n\nexport type TypeCondition = 'is' | 'isNot';\nexport type PresetCondition = 'isExactly' | 'withinLast' | 'notWithinLast';\nexport type RangeCondition = 'is' | 'isNot';\n\nexport type DateField = 'createdAt' | 'updatedAt';\n\nexport interface TypeFilter {\n  kind: 'type';\n  condition: TypeCondition;\n  values: TypeValue[];\n}\n\nexport interface DatePresetFilter {\n  kind: 'date';\n  field: DateField;\n  mode: 'preset';\n  condition: PresetCondition;\n  preset: DatePreset;\n}\n\nexport interface DateRangeFilter {\n  kind: 'date';\n  field: DateField;\n  mode: 'range';\n  condition: RangeCondition;\n  /** Calendar dates, `YYYY-MM-DD`, inclusive on both ends. */\n  from: string;\n  to: string;\n}\n\nexport type DateFilter = DatePresetFilter | DateRangeFilter;\nexport type ListFilter = TypeFilter | DateFilter;\n\nconst FIELD_TOKENS: Record<string, DateField> = {\n  created: 'createdAt',\n  updated: 'updatedAt',\n};\nconst FIELD_TOKEN_BY_FIELD: Record<DateField, string> = {\n  createdAt: 'created',\n  updatedAt: 'updated',\n};\n\nconst PRESET_CONDITION_TOKENS: Record<string, PresetCondition> = {\n  exact: 'isExactly',\n  within: 'withinLast',\n  notwithin: 'notWithinLast',\n};\nconst PRESET_TOKEN_BY_CONDITION: Record<PresetCondition, string> = {\n  isExactly: 'exact',\n  withinLast: 'within',\n  notWithinLast: 'notwithin',\n};\n\nconst RANGE_CONDITION_TOKENS: Record<string, RangeCondition> = {\n  rangeis: 'is',\n  rangenot: 'isNot',\n};\nconst RANGE_TOKEN_BY_CONDITION: Record<RangeCondition, string> = {\n  is: 'rangeis',\n  isNot: 'rangenot',\n};\n\nconst DATE_RE = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nconst isTypeValue = (value: string): value is TypeValue =>\n  (TYPE_VALUES as readonly string[]).includes(value);\n\nconst isDatePreset = (value: string): value is DatePreset =>\n  (DATE_PRESETS as readonly string[]).includes(value);\n\nconst parseBadge = (raw: string): ListFilter | null => {\n  const [field, condition, value] = raw.split(':');\n\n  if (!field || !condition || !value) {\n    return null;\n  }\n\n  if (field === 'type') {\n    if (condition !== 'is' && condition !== 'not') {\n      return null;\n    }\n    const values = value.split(',').filter(isTypeValue);\n\n    return values.length > 0\n      ? { kind: 'type', condition: condition === 'is' ? 'is' : 'isNot', values }\n      : null;\n  }\n\n  const dateField = FIELD_TOKENS[field];\n  if (!dateField) {\n    return null;\n  }\n\n  if (condition in PRESET_CONDITION_TOKENS) {\n    return isDatePreset(value)\n      ? {\n          kind: 'date',\n          field: dateField,\n          mode: 'preset',\n          condition: PRESET_CONDITION_TOKENS[condition],\n          preset: value,\n        }\n      : null;\n  }\n\n  if (condition in RANGE_CONDITION_TOKENS) {\n    const [from, to] = value.split('..');\n\n    return DATE_RE.test(from ?? '') && DATE_RE.test(to ?? '')\n      ? {\n          kind: 'date',\n          field: dateField,\n          mode: 'range',\n          condition: RANGE_CONDITION_TOKENS[condition],\n          from,\n          to,\n        }\n      : null;\n  }\n\n  return null;\n};\n\n/**\n * `unknown` on purpose: the query string is user-editable, and qs parses\n * shapes like `?filters[]=a&filters[]=b` into arrays — the guard is what\n * makes the caller's `?filters=` type an assertion rather than a crash.\n */\nexport const parseFiltersParam = (raw: unknown): ListFilter[] => {\n  if (typeof raw !== 'string' || raw === '') {\n    return [];\n  }\n\n  return raw\n    .split(';')\n    .map(parseBadge)\n    .filter((filter): filter is ListFilter => filter !== null);\n};\n\nconst serializeBadge = (filter: ListFilter): string => {\n  if (filter.kind === 'type') {\n    return `type:${filter.condition === 'is' ? 'is' : 'not'}:${filter.values.join(',')}`;\n  }\n\n  const field = FIELD_TOKEN_BY_FIELD[filter.field];\n\n  if (filter.mode === 'preset') {\n    return `${field}:${PRESET_TOKEN_BY_CONDITION[filter.condition]}:${filter.preset}`;\n  }\n\n  return `${field}:${RANGE_TOKEN_BY_CONDITION[filter.condition]}:${filter.from}..${filter.to}`;\n};\n\nexport const serializeFilters = (filters: ListFilter[]): string =>\n  filters.map(serializeBadge).join(';');\n\nexport interface ListFilters {\n  filters: ListFilter[];\n  /** Serialized form — stable fingerprint for list-identity (selection reset). */\n  serialized: string;\n  addFilter: (filter: ListFilter) => void;\n  /** Replaces the badge at `index` (condition or value edited in place). */\n  updateFilter: (index: number, filter: ListFilter) => void;\n  removeFilter: (index: number) => void;\n  clearFilters: () => void;\n}\n\nexport const useListFilters = (): ListFilters => {\n  const [{ query }, setQuery] = useQueryParams<{ filters?: string }>();\n\n  const filters = parseFiltersParam(query?.filters);\n\n  // `replace: true` on every write: filters are edited in rapid micro-steps\n  // (each checkbox of the keep-open Type submenu, each badge segment edit), so\n  // pushing would turn one logical change into a stack of Back entries. The\n  // URL stays shareable and refresh-safe either way.\n  const writeFilters = (next: ListFilter[]) => {\n    if (next.length === 0) {\n      setQuery({ filters: '' }, 'remove', true);\n    } else {\n      setQuery({ filters: serializeFilters(next) }, 'push', true);\n    }\n  };\n\n  return {\n    filters,\n    serialized: serializeFilters(filters),\n    addFilter: (filter) => writeFilters([...filters, filter]),\n    updateFilter: (index, filter) =>\n      writeFilters(filters.map((f, i) => (i === index ? filter : f))),\n    removeFilter: (index) => writeFilters(filters.filter((_, i) => i !== index)),\n    clearFilters: () => writeFilters([]),\n  };\n};\n"],"names":["TYPE_VALUES","DATE_PRESETS","FIELD_TOKENS","created","updated","FIELD_TOKEN_BY_FIELD","createdAt","updatedAt","PRESET_CONDITION_TOKENS","exact","within","notwithin","PRESET_TOKEN_BY_CONDITION","isExactly","withinLast","notWithinLast","RANGE_CONDITION_TOKENS","rangeis","rangenot","RANGE_TOKEN_BY_CONDITION","is","isNot","DATE_RE","isTypeValue","value","includes","isDatePreset","parseBadge","raw","field","condition","split","values","filter","length","kind","dateField","mode","preset","from","to","test","parseFiltersParam","map","serializeBadge","join","serializeFilters","filters","useListFilters","query","setQuery","useQueryParams","writeFilters","next","serialized","addFilter","updateFilter","index","f","i","removeFilter","_","clearFilters"],"mappings":"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"}

package/dist/admin/future/pages/Assets/hooks/useListSort.js

@@ -0,0 +1,124 @@
+'use strict';
+
+var strapiAdmin = require('@strapi/admin/strapi-admin');
+
+/**
+ * Sort state for the assets list, backed by URL query params so the current
+ * ordering is shareable and survives Back/refresh:
+ *
+ * - `?sort=<rule>` — a single whitelisted rule. Omitted → default (most
+ *   recent updates).
+ * - `?folders=mixed` — folders interleaved with files. Omitted → folders on top.
+ *
+ * The date rules and the direction rules are mutually exclusive: exactly one
+ * rule is active at a time (one checkmark total, like the design mock). Picking
+ * an option in one group clears the other; clearing the active option falls
+ * back to the default — an unsorted list is not a state the UI offers.
+ */ const SORT_BY_RULES = {
+    oldestUploads: 'createdAt:ASC',
+    mostRecentUpdates: 'updatedAt:DESC'
+};
+const SORT_DIRECTION_RULES = {
+    nameAsc: 'name:ASC',
+    nameDesc: 'name:DESC',
+    sizeAsc: 'size:ASC',
+    sizeDesc: 'size:DESC'
+};
+const DEFAULT_SORT_BY = 'mostRecentUpdates';
+const SORT_BY_BY_RULE = Object.fromEntries(Object.entries(SORT_BY_RULES).map(([key, rule])=>[
+        rule,
+        key
+    ]));
+const SORT_DIRECTION_BY_RULE = Object.fromEntries(Object.entries(SORT_DIRECTION_RULES).map(([key, rule])=>[
+        rule,
+        key
+    ]));
+/** Parses `?sort=` — the first recognized rule wins, unknown rules are dropped. */ const parseSortParam = (raw)=>{
+    for (const rule of (raw ?? '').split(',')){
+        if (rule in SORT_BY_BY_RULE) {
+            return {
+                sortBy: SORT_BY_BY_RULE[rule],
+                direction: null,
+                isExplicit: true
+            };
+        }
+        if (rule in SORT_DIRECTION_BY_RULE) {
+            return {
+                sortBy: null,
+                direction: SORT_DIRECTION_BY_RULE[rule],
+                isExplicit: true
+            };
+        }
+    }
+    return {
+        sortBy: DEFAULT_SORT_BY,
+        direction: null,
+        isExplicit: false
+    };
+};
+const serializeSort = (sortBy, direction)=>{
+    const rules = [
+        sortBy && SORT_BY_RULES[sortBy],
+        direction && SORT_DIRECTION_RULES[direction]
+    ];
+    return rules.filter((rule)=>Boolean(rule)).join(',');
+};
+const useListSort = ()=>{
+    const [{ query }, setQuery] = strapiAdmin.useQueryParams();
+    const { sortBy, direction, isExplicit } = parseSortParam(query?.sort);
+    const foldersPosition = query?.folders === 'mixed' ? 'mixed' : 'top';
+    const writeSort = (nextSortBy, nextDirection)=>{
+        // Exactly one active rule: clearing the active one falls back to default.
+        if (nextSortBy === null && nextDirection === null) {
+            nextSortBy = DEFAULT_SORT_BY;
+        }
+        const serialized = serializeSort(nextSortBy, nextDirection);
+        if (nextSortBy === DEFAULT_SORT_BY && nextDirection === null) {
+            setQuery({
+                sort: ''
+            }, 'remove');
+        } else {
+            setQuery({
+                sort: serialized
+            });
+        }
+    };
+    // Groups are mutually exclusive — picking in one clears the other.
+    const setSortBy = (key)=>writeSort(key, null);
+    const setDirection = (key)=>writeSort(null, key);
+    const setFoldersPosition = (position)=>{
+        if (position === 'mixed') {
+            setQuery({
+                folders: 'mixed'
+            });
+        } else {
+            setQuery({
+                folders: ''
+            }, 'remove');
+        }
+    };
+    const assetsSort = serializeSort(sortBy, direction);
+    const folderRuleCandidates = [
+        sortBy && SORT_BY_RULES[sortBy],
+        direction && !direction.startsWith('size') ? SORT_DIRECTION_RULES[direction] : null
+    ];
+    const folderRules = folderRuleCandidates.filter((rule)=>Boolean(rule));
+    // Default state keeps folders alphabetical (matches the sidebar tree) — only
+    // an explicit user sort reorders the folders band.
+    const foldersSort = isExplicit && folderRules.length > 0 ? folderRules.join(',') : 'name:ASC';
+    return {
+        sortBy,
+        direction,
+        foldersPosition,
+        assetsSort,
+        foldersSort,
+        setSortBy,
+        setDirection,
+        setFoldersPosition
+    };
+};
+
+exports.SORT_BY_RULES = SORT_BY_RULES;
+exports.SORT_DIRECTION_RULES = SORT_DIRECTION_RULES;
+exports.useListSort = useListSort;
+//# sourceMappingURL=useListSort.js.map

package/dist/admin/future/pages/Assets/hooks/useListSort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useListSort.js","sources":["../../../../../../admin/src/future/pages/Assets/hooks/useListSort.ts"],"sourcesContent":["import { useQueryParams } from '@strapi/admin/strapi-admin';\n\n/**\n * Sort state for the assets list, backed by URL query params so the current\n * ordering is shareable and survives Back/refresh:\n *\n * - `?sort=<rule>` — a single whitelisted rule. Omitted → default (most\n *   recent updates).\n * - `?folders=mixed` — folders interleaved with files. Omitted → folders on top.\n *\n * The date rules and the direction rules are mutually exclusive: exactly one\n * rule is active at a time (one checkmark total, like the design mock). Picking\n * an option in one group clears the other; clearing the active option falls\n * back to the default — an unsorted list is not a state the UI offers.\n */\n\nexport const SORT_BY_RULES = {\n  oldestUploads: 'createdAt:ASC',\n  mostRecentUpdates: 'updatedAt:DESC',\n} as const;\n\nexport const SORT_DIRECTION_RULES = {\n  nameAsc: 'name:ASC',\n  nameDesc: 'name:DESC',\n  sizeAsc: 'size:ASC',\n  sizeDesc: 'size:DESC',\n} as const;\n\nexport type SortByKey = keyof typeof SORT_BY_RULES;\nexport type SortDirectionKey = keyof typeof SORT_DIRECTION_RULES;\nexport type FoldersPosition = 'top' | 'mixed';\n\nconst DEFAULT_SORT_BY: SortByKey = 'mostRecentUpdates';\n\nconst SORT_BY_BY_RULE = Object.fromEntries(\n  Object.entries(SORT_BY_RULES).map(([key, rule]) => [rule, key])\n) as Record<string, SortByKey>;\n\nconst SORT_DIRECTION_BY_RULE = Object.fromEntries(\n  Object.entries(SORT_DIRECTION_RULES).map(([key, rule]) => [rule, key])\n) as Record<string, SortDirectionKey>;\n\ninterface ParsedSort {\n  sortBy: SortByKey | null;\n  direction: SortDirectionKey | null;\n  /** False when the state is the fallback default (no recognized rule in the URL). */\n  isExplicit: boolean;\n}\n\n/** Parses `?sort=` — the first recognized rule wins, unknown rules are dropped. */\nconst parseSortParam = (raw: string | undefined): ParsedSort => {\n  for (const rule of (raw ?? '').split(',')) {\n    if (rule in SORT_BY_BY_RULE) {\n      return { sortBy: SORT_BY_BY_RULE[rule], direction: null, isExplicit: true };\n    }\n    if (rule in SORT_DIRECTION_BY_RULE) {\n      return { sortBy: null, direction: SORT_DIRECTION_BY_RULE[rule], isExplicit: true };\n    }\n  }\n\n  return { sortBy: DEFAULT_SORT_BY, direction: null, isExplicit: false };\n};\n\nconst serializeSort = (sortBy: SortByKey | null, direction: SortDirectionKey | null): string => {\n  const rules: (string | null)[] = [\n    sortBy && SORT_BY_RULES[sortBy],\n    direction && SORT_DIRECTION_RULES[direction],\n  ];\n\n  return rules.filter((rule): rule is string => Boolean(rule)).join(',');\n};\n\nexport interface ListSort {\n  sortBy: SortByKey | null;\n  direction: SortDirectionKey | null;\n  foldersPosition: FoldersPosition;\n  /**\n   * The active rule for the files query, e.g. `updatedAt:DESC` — always a\n   * single rule since the sort groups are mutually exclusive.\n   */\n  assetsSort: string;\n  /**\n   * Rule applicable to the folders query. In the default state (no sort in the\n   * URL) folders keep their alphabetical order so the band matches the sidebar\n   * tree; an explicit user sort applies, except size rules (folders have no\n   * `size` column), which fall back to alphabetical.\n   */\n  foldersSort: string;\n  setSortBy: (key: SortByKey | null) => void;\n  setDirection: (key: SortDirectionKey | null) => void;\n  setFoldersPosition: (position: FoldersPosition) => void;\n}\n\nexport const useListSort = (): ListSort => {\n  const [{ query }, setQuery] = useQueryParams<{ sort?: string; folders?: string }>();\n\n  const { sortBy, direction, isExplicit } = parseSortParam(query?.sort);\n  const foldersPosition: FoldersPosition = query?.folders === 'mixed' ? 'mixed' : 'top';\n\n  const writeSort = (nextSortBy: SortByKey | null, nextDirection: SortDirectionKey | null) => {\n    // Exactly one active rule: clearing the active one falls back to default.\n    if (nextSortBy === null && nextDirection === null) {\n      nextSortBy = DEFAULT_SORT_BY;\n    }\n\n    const serialized = serializeSort(nextSortBy, nextDirection);\n\n    if (nextSortBy === DEFAULT_SORT_BY && nextDirection === null) {\n      setQuery({ sort: '' }, 'remove');\n    } else {\n      setQuery({ sort: serialized });\n    }\n  };\n\n  // Groups are mutually exclusive — picking in one clears the other.\n  const setSortBy = (key: SortByKey | null) => writeSort(key, null);\n  const setDirection = (key: SortDirectionKey | null) => writeSort(null, key);\n\n  const setFoldersPosition = (position: FoldersPosition) => {\n    if (position === 'mixed') {\n      setQuery({ folders: 'mixed' });\n    } else {\n      setQuery({ folders: '' }, 'remove');\n    }\n  };\n\n  const assetsSort = serializeSort(sortBy, direction);\n  const folderRuleCandidates: (string | null)[] = [\n    sortBy && SORT_BY_RULES[sortBy],\n    direction && !direction.startsWith('size') ? SORT_DIRECTION_RULES[direction] : null,\n  ];\n  const folderRules = folderRuleCandidates.filter((rule): rule is string => Boolean(rule));\n  // Default state keeps folders alphabetical (matches the sidebar tree) — only\n  // an explicit user sort reorders the folders band.\n  const foldersSort = isExplicit && folderRules.length > 0 ? folderRules.join(',') : 'name:ASC';\n\n  return {\n    sortBy,\n    direction,\n    foldersPosition,\n    assetsSort,\n    foldersSort,\n    setSortBy,\n    setDirection,\n    setFoldersPosition,\n  };\n};\n"],"names":["SORT_BY_RULES","oldestUploads","mostRecentUpdates","SORT_DIRECTION_RULES","nameAsc","nameDesc","sizeAsc","sizeDesc","DEFAULT_SORT_BY","SORT_BY_BY_RULE","Object","fromEntries","entries","map","key","rule","SORT_DIRECTION_BY_RULE","parseSortParam","raw","split","sortBy","direction","isExplicit","serializeSort","rules","filter","Boolean","join","useListSort","query","setQuery","useQueryParams","sort","foldersPosition","folders","writeSort","nextSortBy","nextDirection","serialized","setSortBy","setDirection","setFoldersPosition","position","assetsSort","folderRuleCandidates","startsWith","folderRules","foldersSort","length"],"mappings":"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"}

package/dist/admin/future/pages/Assets/hooks/useListSort.mjs

@@ -0,0 +1,120 @@
+import { useQueryParams } from '@strapi/admin/strapi-admin';
+
+/**
+ * Sort state for the assets list, backed by URL query params so the current
+ * ordering is shareable and survives Back/refresh:
+ *
+ * - `?sort=<rule>` — a single whitelisted rule. Omitted → default (most
+ *   recent updates).
+ * - `?folders=mixed` — folders interleaved with files. Omitted → folders on top.
+ *
+ * The date rules and the direction rules are mutually exclusive: exactly one
+ * rule is active at a time (one checkmark total, like the design mock). Picking
+ * an option in one group clears the other; clearing the active option falls
+ * back to the default — an unsorted list is not a state the UI offers.
+ */ const SORT_BY_RULES = {
+    oldestUploads: 'createdAt:ASC',
+    mostRecentUpdates: 'updatedAt:DESC'
+};
+const SORT_DIRECTION_RULES = {
+    nameAsc: 'name:ASC',
+    nameDesc: 'name:DESC',
+    sizeAsc: 'size:ASC',
+    sizeDesc: 'size:DESC'
+};
+const DEFAULT_SORT_BY = 'mostRecentUpdates';
+const SORT_BY_BY_RULE = Object.fromEntries(Object.entries(SORT_BY_RULES).map(([key, rule])=>[
+        rule,
+        key
+    ]));
+const SORT_DIRECTION_BY_RULE = Object.fromEntries(Object.entries(SORT_DIRECTION_RULES).map(([key, rule])=>[
+        rule,
+        key
+    ]));
+/** Parses `?sort=` — the first recognized rule wins, unknown rules are dropped. */ const parseSortParam = (raw)=>{
+    for (const rule of (raw ?? '').split(',')){
+        if (rule in SORT_BY_BY_RULE) {
+            return {
+                sortBy: SORT_BY_BY_RULE[rule],
+                direction: null,
+                isExplicit: true
+            };
+        }
+        if (rule in SORT_DIRECTION_BY_RULE) {
+            return {
+                sortBy: null,
+                direction: SORT_DIRECTION_BY_RULE[rule],
+                isExplicit: true
+            };
+        }
+    }
+    return {
+        sortBy: DEFAULT_SORT_BY,
+        direction: null,
+        isExplicit: false
+    };
+};
+const serializeSort = (sortBy, direction)=>{
+    const rules = [
+        sortBy && SORT_BY_RULES[sortBy],
+        direction && SORT_DIRECTION_RULES[direction]
+    ];
+    return rules.filter((rule)=>Boolean(rule)).join(',');
+};
+const useListSort = ()=>{
+    const [{ query }, setQuery] = useQueryParams();
+    const { sortBy, direction, isExplicit } = parseSortParam(query?.sort);
+    const foldersPosition = query?.folders === 'mixed' ? 'mixed' : 'top';
+    const writeSort = (nextSortBy, nextDirection)=>{
+        // Exactly one active rule: clearing the active one falls back to default.
+        if (nextSortBy === null && nextDirection === null) {
+            nextSortBy = DEFAULT_SORT_BY;
+        }
+        const serialized = serializeSort(nextSortBy, nextDirection);
+        if (nextSortBy === DEFAULT_SORT_BY && nextDirection === null) {
+            setQuery({
+                sort: ''
+            }, 'remove');
+        } else {
+            setQuery({
+                sort: serialized
+            });
+        }
+    };
+    // Groups are mutually exclusive — picking in one clears the other.
+    const setSortBy = (key)=>writeSort(key, null);
+    const setDirection = (key)=>writeSort(null, key);
+    const setFoldersPosition = (position)=>{
+        if (position === 'mixed') {
+            setQuery({
+                folders: 'mixed'
+            });
+        } else {
+            setQuery({
+                folders: ''
+            }, 'remove');
+        }
+    };
+    const assetsSort = serializeSort(sortBy, direction);
+    const folderRuleCandidates = [
+        sortBy && SORT_BY_RULES[sortBy],
+        direction && !direction.startsWith('size') ? SORT_DIRECTION_RULES[direction] : null
+    ];
+    const folderRules = folderRuleCandidates.filter((rule)=>Boolean(rule));
+    // Default state keeps folders alphabetical (matches the sidebar tree) — only
+    // an explicit user sort reorders the folders band.
+    const foldersSort = isExplicit && folderRules.length > 0 ? folderRules.join(',') : 'name:ASC';
+    return {
+        sortBy,
+        direction,
+        foldersPosition,
+        assetsSort,
+        foldersSort,
+        setSortBy,
+        setDirection,
+        setFoldersPosition
+    };
+};
+
+export { SORT_BY_RULES, SORT_DIRECTION_RULES, useListSort };
+//# sourceMappingURL=useListSort.mjs.map