@shakerquiz/utilities 2.0.0 → 3.0.0

package/dprint.json

@@ -19,9 +19,6 @@
   ],
   "plugins": [
     "https://plugins.dprint.dev/typescript-0.93.0.wasm",
-    "https://plugins.dprint.dev/json-0.19.3.wasm",
-    "https://plugins.dprint.dev/markdown-0.17.8.wasm",
-    "https://plugins.dprint.dev/dockerfile-0.3.2.wasm",
-    "https://plugins.dprint.dev/g-plane/pretty_yaml-v0.5.0.wasm"
+    "https://plugins.dprint.dev/json-0.19.3.wasm"
   ]
 }

package/package.json

@@ -1,23 +1,17 @@
 {
   "type": "module",
   "name": "@shakerquiz/utilities",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "author": "yurkimus <yurkimus@gmail.com>",
   "license": "ISC",
-  "scripts": {
-    "type": "tsc --declaration --emitdeclarationonly --allowjs"
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/shaker-quiz/utilities.git"
   },
   "exports": {
     ".": {
-      "types": "./source/index.d.ts",
       "default": "./source/index.js"
     },
     "./schemas/*.json": "./source/schemas/*.json"
-  },
-  "dependencies": {
-    "urlpattern-polyfill": "10.1.0"
-  },
-  "devDependencies": {
-    "typescript": "5.8.3"
   }
 }

package/source/enumerations/core/features.js

@@ -1,205 +1,56 @@
-import { Kinds } from './kinds.js'
-
-export var Domains = /** @type {const} */ ([
-  // 'Asset',
-  'User',
-  'Role',
-  'Country',
-  'Currency',
-  'City',
-  'Venue',
-  'Theme',
-  // 'ThemeAsset',
-  'Game',
-  // 'GameAsset',
-  'Registration',
-  'Mailing',
-])
-
-/**
- * @type {Record<Domain, Icon>}
- */
-export var DomainIcon = {
-  'User': 'users',
-  'Role': 'identification',
-  'Country': 'no-symbol',
-  'Currency': 'no-symbol',
-  'City': 'building-office',
-  'Venue': 'map-pin',
-  'Theme': 'document-text',
-  'Game': 'newspaper',
-  'Registration': 'user-group',
-  'Mailing': 'envelope',
-}
-
-/**
- * @type {Record<Domain, Record<Kind, string>>}
- */
-export var DomainKindPathname = /** @type {const} */ ({
-  'User': {
-    'Unit': '/user/:user?',
-    'Set': '/users',
-  },
-
-  'Role': {
-    'Unit': '/role/:role?',
-    'Set': '/roles',
-  },
-
-  'Country': {
-    'Unit': '/country/:country?',
-    'Set': '/countries',
-  },
-
-  'Currency': {
-    'Unit': '/currency/:currency?',
-    'Set': '/currencies',
-  },
-
-  'City': {
-    'Unit': '/city/:city?',
-    'Set': '/cities',
-  },
-
-  'Venue': {
-    'Unit': '/venue/:venue?',
-    'Set': '/venues',
-  },
-
-  'Theme': {
-    'Unit': '/theme/:theme?',
-    'Set': '/themes',
-  },
-
-  'Game': {
-    /**
-     * Parameter "game" can be one of:
-     * - UUID of a Game,
-     * - Game alias combined with City (UUID, alias or VK group ID),
-     * - UUID of a Registration
-     */
-    'Unit': '/game/:game?',
-    'Set': '/games',
-  },
-
-  'Registration': {
-    /**
-     * Parameter "registration" can be one of:
-     * - UUID of a Registration,
-     * - VK identifier of a Registration
-     */
-    'Unit': '/registration/:registration?',
-    'Set': '/registrations',
-  },
-
-  'Mailing': {
-    'Unit': '/mailing/:mailing?',
-    'Set': '/mailings',
-  },
+export var Feature = /** @type {const} */ ({
+  'role': 'role',
+  'roles': 'roles',
+  'user': 'user',
+  'users': 'users',
+  'checkin': 'checkin',
+  'checkins': 'checkins',
+  'country': 'country',
+  'countries': 'countries',
+  'currency': 'currency',
+  'currencies': 'currencies',
+  'timezone': 'timezone',
+  'timezones': 'timezones',
+  'city': 'city',
+  'cities': 'cities',
+  'venue': 'venue',
+  'venues': 'venues',
+  'theme': 'theme',
+  'themes': 'themes',
+  'game': 'game',
+  'games': 'games',
+  'registration': 'registration',
+  'registrations': 'registrations',
+  'mailing': 'mailing',
+  'mailings': 'mailings',
 })
 
-export var Procedures = /** @type {const} */ ([
-  'Checkin',
-  'Redirect',
-])
-
-/**
- * @type {Record<Procedure, Icon>}
- */
-export var ProcedureIcon = {
-  'Checkin': 'arrow-right-end-on-rectangle',
-  'Redirect': 'no-symbol',
-}
-
-/**
- * @type {Record<Procedure, Record<Kind, string>>}
- */
-export var ProcedureKindPathname = /** @type {const} */ ({
-  'Checkin': {
-    'Unit': '/checkin',
-    'Set': '/checkins',
-  },
+export var Features = Object.values(Feature)
 
-  'Redirect': {
-    'Unit': '/redirect',
-    'Set': '/redirects',
-  },
-})
-
-/**
- * @type {Array<Domain | Procedure>}
- */
-export var Features = Domains.concat(Procedures)
-
-/**
- * @type {Record<Feature, Icon>}
- */
+/** @type {Record<Feature, Icon>} */
 export var FeatureIcon = {
-  ...DomainIcon,
-  ...ProcedureIcon,
-}
-
-/**
- * @type {Record<Feature, Record<Kind, string>>}
- */
-export var FeatureKindPathname = {
-  ...DomainKindPathname,
-  ...ProcedureKindPathname,
-}
-
-/**
- * @type {Array<[feature: Feature, kind: Kind, pathname: string]>}
- */
-export var FeatureKindPathnames = Object
-  .keys(FeatureKindPathname)
-  .flatMap(feature =>
-    Object
-      .keys(FeatureKindPathname[feature])
-      .map(kind => [feature, kind, FeatureKindPathname[feature][kind]])
-  )
-
-/**
- * @type {Array<[feature: Feature, kind: Kind, pattern: URLPattern]>}
- */
-export var FeatureKindPatterns = FeatureKindPathnames
-  .map(([feature, kind, pathname]) => [
-    feature,
-    kind,
-    new URLPattern({ pathname }),
-  ])
-
-/**
- * @param {Feature} feature
- * @param {Kind} kind
- */
-export var getPathname = (feature, kind) => {
-  if (!Features.includes(feature))
-    throw TypeError(
-      `[getPathname] Feature '${feature}' must be listed in 'Features'.`,
-    )
-
-  if (!Kinds.includes(kind))
-    throw TypeError(
-      `[getPathname] Kind '${kind}' must be listed in 'Kinds'.`,
-    )
-
-  return FeatureKindPathname[feature][kind]
-}
-
-/**
- * @param {Feature} feature
- * @param {Kind} kind
- */
-export var getPattern = (feature, kind) => {
-  if (!Features.includes(feature))
-    throw TypeError(
-      `[getPattern] Feature '${feature}' must be listed in 'Features'.`,
-    )
-
-  if (!Kinds.includes(kind))
-    throw TypeError(
-      `[getPattern] Kind '${kind}' must be listed in 'Kinds'.`,
-    )
-
-  return FeatureKindPatterns.find(([f, k]) => f == feature && k == kind)[2]
+  [Feature.role]: 'hero/solid/identification',
+  [Feature.roles]: 'hero/solid/identification',
+  [Feature.user]: 'hero/solid/users',
+  [Feature.users]: 'hero/solid/users',
+  [Feature.checkin]: 'arrow-right-end-on-rectangle',
+  [Feature.checkins]: 'arrow-right-end-on-rectangle',
+  [Feature.country]: 'hero/outline/no-symbol',
+  [Feature.countries]: 'hero/outline/no-symbol',
+  [Feature.currency]: 'hero/outline/banknotes',
+  [Feature.currencies]: 'hero/outline/banknotes',
+  [Feature.timezone]: 'hero/outline/no-symbol',
+  [Feature.timezones]: 'hero/outline/no-symbol',
+  [Feature.city]: 'hero/outline/building-office',
+  [Feature.cities]: 'hero/outline/building-office',
+  [Feature.venue]: 'hero/outline/map-pin',
+  [Feature.venues]: 'hero/outline/map-pin',
+  [Feature.theme]: 'hero/outline/document-text',
+  [Feature.themes]: 'hero/outline/document-text',
+  [Feature.game]: 'hero/outline/newspaper',
+  [Feature.games]: 'hero/outline/newspaper',
+  [Feature.registration]: 'hero/outline/user-group',
+  [Feature.registrations]: 'hero/outline/user-group',
+  [Feature.mailing]: 'hero/outline/envelope',
+  [Feature.mailings]: 'hero/outline/envelope',
 }

package/source/enumerations/core/methods.js

@@ -5,21 +5,12 @@
  *  - CONNECT: {@link https://datatracker.ietf.org/doc/html/rfc9110}
  *  - WebDAV Extensions {@link https://datatracker.ietf.org/doc/html/rfc4918}
  */
-export var Methods = /** @type {const} */ ([
-  // 'CONNECT',
-  // 'COPY',
-  'DELETE',
-  'GET',
-  // 'HEAD',
-  // 'LOCK',
-  // 'MKCOL',
-  // 'MOVE',
-  'OPTIONS',
-  'PATCH',
-  'POST',
-  // 'PROPFIND',
-  // 'PROPPATCH',
-  'PUT',
-  // 'TRACE',
-  // 'UNLOCK',
-])
+export var Method = /** @type {const} */ ({
+  'DELETE': 'DELETE',
+  'GET': 'GET',
+  'OPTIONS': 'OPTIONS',
+  'PATCH': 'PATCH',
+  'POST': 'POST',
+})
+
+export var Methods = Object.values(Method)

package/source/enumerations/core/networks.js

@@ -1,4 +1,6 @@
-export var Networks = /** @type {const} */ ([
-  'Docker',
-  'Public',
-])
+export var Network = /** @type {const} */ ({
+  'Docker': 'Docker',
+  'Public': 'Public',
+})
+
+export var Networks = Object.values(Network)

package/source/enumerations/core/runtimes.js

@@ -1,4 +1,6 @@
-export var Runtimes = /** @type {const} */ ([
-  'Next',
-  'React',
-])
+export var Runtime = /** @type {const} */ ({
+  'Next': 'Next',
+  'React': 'React',
+})
+
+export var Runtimes = Object.values(Runtime)

package/source/enumerations/entities/affilation.js

@@ -0,0 +1,91 @@
+export var Affilation = /** @type {const} */ ({
+  'Branch': 'Branch',
+  'Franchise': 'Franchise',
+  'Unknown': 'Unknown',
+})
+
+export var Affilations = Object.values(Affilation)
+
+export var AffilationWeight = {
+  [Affilation['Branch']]: 0,
+  [Affilation['Franchise']]: 1,
+  [Affilation['Unknown']]: 2,
+}
+
+export var AffilationTitle = {
+  [Affilation['Branch']]: 'Филиал',
+  [Affilation['Franchise']]: 'Франшиза',
+  [Affilation['Unknown']]: 'Неизвестно',
+}
+
+export var AffilationActionTitle = {
+  [Affilation['Branch']]: '',
+  [Affilation['Franchise']]: '',
+  [Affilation['Unknown']]: '',
+}
+
+export var AffilationActionDescpription = {
+  [Affilation['Branch']]: '',
+  [Affilation['Franchise']]: '',
+  [Affilation['Unknown']]: '',
+}
+
+export var AffilationColor = {
+  [Affilation['Branch']]: 'primary',
+  [Affilation['Franchise']]: 'secondary',
+  [Affilation['Unknown']]: 'danger',
+}
+
+export var AffilationTextColor = {
+  [Affilation['Branch']]: 'text-primary',
+  [Affilation['Franchise']]: 'text-secondary',
+  [Affilation['Unknown']]: 'text-danger',
+}
+
+/** @type {Record<Affilation, Icon>} */
+export var AffilationIcon = {
+  [Affilation['Branch']]: 'hero/outline/building-office-2',
+  [Affilation['Franchise']]: 'hero/outline/building-storefront',
+  [Affilation['Unknown']]: 'hero/outline/no-symbol',
+}
+
+/** @type {Record<Affilation, Pick<CityTable, 'is_franchise'>>} */
+export var AffilationShape = {
+  [Affilation['Branch']]: {
+    is_franchise: false,
+  },
+
+  [Affilation['Franchise']]: {
+    is_franchise: true,
+  },
+
+  [Affilation['Unknown']]: {
+    is_franchise: null,
+  },
+}
+
+export var AffilationShapes = Object.entries(AffilationShape)
+
+/**
+ * @param {Affilation | typeof AffilationShape[Affilation]} value
+ */
+export var getAffilation = value => {
+  if (value === null)
+    return Affilation['Unknown']
+
+  switch (typeof value) {
+    case 'object':
+      return AffilationShapes
+        .find(([, object]) => object.is_franchise === value.is_franchise)
+        ?.at(0)
+        ?? Affilation['Unknown']
+
+    case 'string':
+      return value in AffilationShape
+        ? AffilationShape[value]
+        : AffilationShape[Affilation['Unknown']]
+
+    default:
+      return Affilation['Unknown']
+  }
+}

package/source/enumerations/entities/cities-mode.js

@@ -0,0 +1,49 @@
+export var CitiesMode = /** @type {const} */ ({
+  'all': 'all',
+  'many': 'many',
+  'single': 'single',
+  'none': 'none',
+  'unknown': 'unknown',
+})
+
+export var CitiesModes = Object.values(CitiesMode)
+
+export var CitiesModeTitle = {
+  [CitiesMode.all]: 'Все',
+  [CitiesMode.many]: 'Несколько',
+  [CitiesMode.single]: 'Один',
+  [CitiesMode.none]: 'Пусто',
+  [CitiesMode.unknown]: 'Не назначено',
+}
+
+export var CitiesModeWeigth = {
+  [CitiesMode.all]: 0,
+  [CitiesMode.many]: 1,
+  [CitiesMode.single]: 2,
+  [CitiesMode.none]: 3,
+  [CitiesMode.unknown]: 4,
+}
+
+/**
+ * @param {keyof typeof CitiesMode} value
+ */
+var getter = value =>
+  value in CitiesMode
+    ? value
+    : CitiesMode['unknown']
+
+export var getCitiesMode = value => {
+  if (value === null)
+    return getter(undefined)
+
+  switch (typeof value) {
+    case 'string':
+      return getter(value)
+
+    case 'object':
+      return getter(value?.mode)
+
+    default:
+      return getter(undefined)
+  }
+}

package/source/enumerations/entities/city/timezone-mode.js

@@ -0,0 +1,44 @@
+export var CityTimezoneMode = /** @type {const} */ ({
+  'Any': 'Any',
+  'Known': 'Known',
+  'Unknown': 'Unknown',
+})
+
+export var CityTimezoneModes = [
+  CityTimezoneMode['Any'],
+  CityTimezoneMode['Known'],
+  CityTimezoneMode['Unknown'],
+]
+
+export var CityTimezoneModeTitle = {
+  [CityTimezoneMode['Any']]: 'Любой',
+  [CityTimezoneMode['Known']]: 'Назначено',
+  [CityTimezoneMode['Unknown']]: 'Неизвестно',
+}
+
+export var CityTimezoneModeIcon = {
+  [CityTimezoneMode['Any']]: 'hero/outline/square-2-stack',
+  [CityTimezoneMode['Known']]: 'hero/outline/check',
+  [CityTimezoneMode['Unknown']]: 'hero/outline/no-symbol',
+}
+
+/**
+ * @returns {keyof typeof CityTimezoneMode} value
+ */
+var inferString = value =>
+  value in CityTimezoneMode
+    ? value
+    : CityTimezoneMode['Unknown']
+
+export var inferCityTimezoneMode = value => {
+  switch (typeof value) {
+    case 'string':
+      return inferString(value)
+
+    case 'object':
+      return inferString(value?.mode)
+
+    default:
+      return CityTimezoneMode['Unknown']
+  }
+}

package/source/enumerations/entities/city/venues-mode.js

@@ -0,0 +1,60 @@
+export var CityVenuesMode = /** @type {const} */ ({
+  'Any': 'Any',
+  'None': 'None',
+  'Single': 'Single',
+  'Many': 'Many',
+  'Unknown': 'Unknown',
+})
+
+export var CityVenuesModes = [
+  CityVenuesMode['Any'],
+  CityVenuesMode['None'],
+  CityVenuesMode['Single'],
+  CityVenuesMode['Many'],
+  CityVenuesMode['Unknown'],
+]
+
+export var CityVenuesModeTitle = {
+  [CityVenuesMode['None']]: 'Любые',
+  [CityVenuesMode['None']]: 'Пусто',
+  [CityVenuesMode['Single']]: 'Одно',
+  [CityVenuesMode['Many']]: 'Несколько',
+  [CityVenuesMode['Unknown']]: 'Неизвестно',
+}
+
+export var CityVenuesModeIcon = {
+  [CityVenuesMode['Any']]: 'hero/outline/square-2-stack',
+  [CityVenuesMode['None']]: 'hero/outline/no-symbol',
+  [CityVenuesMode['Single']]: 'hero/outline/no-symbol',
+  [CityVenuesMode['Many']]: 'hero/outline/no-symbol',
+  [CityVenuesMode['Unknown']]: 'hero/outline/no-symbol',
+}
+
+/**
+ * @returns {keyof typeof CityVenuesMode} value
+ */
+var fromString = value =>
+  value in CityVenuesMode
+    ? value
+    : CityVenuesMode['Unknown']
+
+/**
+ * @returns {keyof typeof CityVenuesMode} value
+ */
+var fromObject = value =>
+  value?.mode in CityVenuesMode
+    ? value.mode
+    : CityVenuesMode['Unknown']
+
+export var inferCityVenuesMode = value => {
+  switch (typeof value) {
+    case 'string':
+      return fromString(value)
+
+    case 'object':
+      return fromObject(value)
+
+    default:
+      return CityVenuesMode['Unknown']
+  }
+}