@nixxie-cms/fields-location 1.0.1

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 Nixxie International DMCC
+Portions Copyright (c) 2023 Thinkmill Labs Pty Ltd and contributors
+(this software is derived from the KeystoneJS project, https://keystonejs.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,12 @@
+# @nixxie-cms/fields-location
+
+A geolocation field for Nixxie CMS. Stores `{ lat, lng, label? }` as JSON and validates coordinate
+ranges.
+
+```ts
+import { location } from '@nixxie-cms/fields-location'
+
+fields: {
+  position: location({ validation: { isRequired: true } }),
+}
+```

package/dist/declarations/src/index.d.ts

@@ -0,0 +1,17 @@
+import type { JsonFieldConfig } from '@nixxie-cms/core/fields';
+import type { BaseListTypeInfo, FieldTypeFunc } from '@nixxie-cms/core/types';
+export type LatLng = {
+    lat: number;
+    lng: number;
+    label?: string;
+};
+export type LocationFieldConfig<ListTypeInfo extends BaseListTypeInfo> = Omit<JsonFieldConfig<ListTypeInfo>, 'defaultValue'> & {
+    validation?: {
+        isRequired?: boolean;
+    };
+};
+/**
+ * A geolocation field storing `{ lat, lng, label? }` as JSON. Validates latitude/longitude ranges.
+ */
+export declare function location<ListTypeInfo extends BaseListTypeInfo>(config?: LocationFieldConfig<ListTypeInfo>): FieldTypeFunc<ListTypeInfo>;
+//# sourceMappingURL=index.d.ts.map

package/dist/declarations/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"../../../src","sources":["index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAE7E,MAAM,MAAM,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjE,MAAM,MAAM,mBAAmB,CAAC,YAAY,SAAS,gBAAgB,IAAI,IAAI,CAC3E,eAAe,CAAC,YAAY,CAAC,EAC7B,cAAc,CACf,GAAG;IACF,UAAU,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CACtC,CAAA;AAeD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,YAAY,SAAS,gBAAgB,EAC5D,MAAM,GAAE,mBAAmB,CAAC,YAAY,CAAM,GAC7C,aAAa,CAAC,YAAY,CAAC,CAuB7B"}

package/dist/nixxie-cms-fields-location.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./declarations/src/index.js";
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibml4eGllLWNtcy1maWVsZHMtbG9jYXRpb24uY2pzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuL2RlY2xhcmF0aW9ucy9zcmMvaW5kZXguZC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSJ9

package/dist/nixxie-cms-fields-location.cjs.js

@@ -0,0 +1,47 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var fields = require('@nixxie-cms/core/fields');
+
+function isValidLatLng(v) {
+  return v && typeof v === 'object' && typeof v.lat === 'number' && typeof v.lng === 'number' && v.lat >= -90 && v.lat <= 90 && v.lng >= -180 && v.lng <= 180;
+}
+
+/**
+ * A geolocation field storing `{ lat, lng, label? }` as JSON. Validates latitude/longitude ranges.
+ */
+function location(config = {}) {
+  const {
+    validation,
+    hooks,
+    ...rest
+  } = config;
+  return fields.json({
+    ...rest,
+    defaultValue: null,
+    hooks: {
+      ...hooks,
+      validate: args => {
+        const {
+          resolvedData,
+          fieldKey,
+          addValidationError,
+          operation
+        } = args;
+        if (operation === 'delete') return;
+        const value = resolvedData[fieldKey];
+        if (value === undefined) return;
+        if (value === null) {
+          if (validation !== null && validation !== void 0 && validation.isRequired) addValidationError(`${fieldKey} is required`);
+          return;
+        }
+        if (!isValidLatLng(value)) {
+          addValidationError(`${fieldKey} must be { lat, lng } with valid coordinates`);
+        }
+      }
+    }
+  });
+}
+
+exports.location = location;

package/dist/nixxie-cms-fields-location.esm.js

@@ -0,0 +1,43 @@
+import { json } from '@nixxie-cms/core/fields';
+
+function isValidLatLng(v) {
+  return v && typeof v === 'object' && typeof v.lat === 'number' && typeof v.lng === 'number' && v.lat >= -90 && v.lat <= 90 && v.lng >= -180 && v.lng <= 180;
+}
+
+/**
+ * A geolocation field storing `{ lat, lng, label? }` as JSON. Validates latitude/longitude ranges.
+ */
+function location(config = {}) {
+  const {
+    validation,
+    hooks,
+    ...rest
+  } = config;
+  return json({
+    ...rest,
+    defaultValue: null,
+    hooks: {
+      ...hooks,
+      validate: args => {
+        const {
+          resolvedData,
+          fieldKey,
+          addValidationError,
+          operation
+        } = args;
+        if (operation === 'delete') return;
+        const value = resolvedData[fieldKey];
+        if (value === undefined) return;
+        if (value === null) {
+          if (validation !== null && validation !== void 0 && validation.isRequired) addValidationError(`${fieldKey} is required`);
+          return;
+        }
+        if (!isValidLatLng(value)) {
+          addValidationError(`${fieldKey} must be { lat, lng } with valid coordinates`);
+        }
+      }
+    }
+  });
+}
+
+export { location };

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@nixxie-cms/fields-location",
+  "version": "1.0.1",
+  "license": "MIT",
+  "main": "dist/nixxie-cms-fields-location.cjs.js",
+  "module": "dist/nixxie-cms-fields-location.esm.js",
+  "exports": {
+    ".": {
+      "types": "./dist/nixxie-cms-fields-location.cjs.js",
+      "module": "./dist/nixxie-cms-fields-location.esm.js",
+      "default": "./dist/nixxie-cms-fields-location.cjs.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@babel/runtime": "^7.24.7"
+  },
+  "devDependencies": {
+    "@nixxie-cms/core": "^1.0.1"
+  },
+  "peerDependencies": {
+    "@nixxie-cms/core": "^1.0.1"
+  },
+  "preconstruct": {
+    "entrypoints": [
+      "index.ts"
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nixxiecms/nixxie/tree/main/packages/fields-location"
+  }
+}

package/src/index.ts

@@ -0,0 +1,55 @@
+import { json } from '@nixxie-cms/core/fields'
+import type { JsonFieldConfig } from '@nixxie-cms/core/fields'
+import type { BaseListTypeInfo, FieldTypeFunc } from '@nixxie-cms/core/types'
+
+export type LatLng = { lat: number; lng: number; label?: string }
+
+export type LocationFieldConfig<ListTypeInfo extends BaseListTypeInfo> = Omit<
+  JsonFieldConfig<ListTypeInfo>,
+  'defaultValue'
+> & {
+  validation?: { isRequired?: boolean }
+}
+
+function isValidLatLng(v: any): v is LatLng {
+  return (
+    v &&
+    typeof v === 'object' &&
+    typeof v.lat === 'number' &&
+    typeof v.lng === 'number' &&
+    v.lat >= -90 &&
+    v.lat <= 90 &&
+    v.lng >= -180 &&
+    v.lng <= 180
+  )
+}
+
+/**
+ * A geolocation field storing `{ lat, lng, label? }` as JSON. Validates latitude/longitude ranges.
+ */
+export function location<ListTypeInfo extends BaseListTypeInfo>(
+  config: LocationFieldConfig<ListTypeInfo> = {}
+): FieldTypeFunc<ListTypeInfo> {
+  const { validation, hooks, ...rest } = config
+
+  return json<ListTypeInfo>({
+    ...(rest as JsonFieldConfig<ListTypeInfo>),
+    defaultValue: null,
+    hooks: {
+      ...hooks,
+      validate: (args: any) => {
+        const { resolvedData, fieldKey, addValidationError, operation } = args
+        if (operation === 'delete') return
+        const value = resolvedData[fieldKey]
+        if (value === undefined) return
+        if (value === null) {
+          if (validation?.isRequired) addValidationError(`${fieldKey} is required`)
+          return
+        }
+        if (!isValidLatLng(value)) {
+          addValidationError(`${fieldKey} must be { lat, lng } with valid coordinates`)
+        }
+      },
+    },
+  })
+}