@stndrds/schema 1.0.0-alpha.292 → 1.0.0-alpha.294

package/dist/{chunk-QYJ532XI.mjs → chunk-JZNR4HKQ.mjs}

@@ -1,5 +1,5 @@
-import { SCHEMA_LIMITS, iconNameSchema } from './chunk-UW3BOSB6.mjs';
-import { ValidationError } from './chunk-7WEOBXXA.mjs';
+import { SCHEMA_LIMITS, iconNameSchema } from './chunk-QT35SI3K.mjs';
+import { ValidationError } from './chunk-CLZORRMS.mjs';
 import { z } from 'zod';
 
 // src/types/system-attributes.ts
@@ -153,6 +153,13 @@ var FORMULA_OPERATORS = [
   "is_empty",
   "is_not_empty"
 ];
+var LOCATION_FILTER_PROPERTIES = ["city", "postalCode", "country"];
+function isLocationFilterProperty(name) {
+  return LOCATION_FILTER_PROPERTIES.includes(name);
+}
+function isLocationPartOperator(operator) {
+  return TEXT_OPERATORS.includes(operator);
+}
 var ATTRIBUTE_FILTER_OPERATORS = {
   text: TEXT_OPERATORS,
   richtext: [],
@@ -710,12 +717,9 @@ function assertDynamicValueForAttribute(rule, attrType) {
     throw new ValidationError(m, [{ path: ["value"], message: m }]);
   }
 }
-function locationQueryHint(type) {
-  return type === "location" ? ' Location attributes cannot be filtered on their text \u2014 use the full-text "query" parameter to match a city, address or postal code.' : "";
-}
-function withLocationQueryHint(message, type) {
-  const hint = locationQueryHint(type);
-  return hint ? `${message}.${hint}` : message;
+var LOCATION_PARTS_LIST = LOCATION_FILTER_PROPERTIES.map((part) => `"${part}"`).join(", ");
+function locationPartsHint(type) {
+  return type === "location" ? ` A location is filtered on one of its parts: set "property" to one of ${LOCATION_PARTS_LIST} and use a text operator (e.g. contains).` : "";
 }
 function collectQualifiedRuleIssues(rule, context) {
   try {
@@ -730,7 +734,9 @@ function validateQualifiedRule(rule, context) {
   const rootAttr = context.attributes.find((a) => a.name === rule.attribute);
   const systemOps = SYSTEM_FILTER_OPERATORS[rule.attribute];
   if (!(rootAttr || systemOps)) {
-    const dottedHint = rule.attribute.includes(".") ? ' Dotted paths are not supported \u2014 filter on the attribute name alone, or use the full-text "query" parameter to match text inside a value.' : "";
+    const [head, ...tail] = rule.attribute.split(".");
+    const dottedRoot = tail.length > 0 ? context.attributes.find((a) => a.name === head) : void 0;
+    const dottedHint = dottedRoot?.type === "location" ? ` Dotted paths are not supported \u2014 set "attribute" to "${head}" and "property" to ${isLocationFilterProperty(tail[0] ?? "") ? `"${tail[0]}"` : `one of ${LOCATION_PARTS_LIST}`}.` : rule.attribute.includes(".") ? ' Dotted paths are not supported \u2014 filter on the attribute name alone, or use the full-text "query" parameter to match text inside a value.' : "";
     const m = `Unknown attribute: ${rule.attribute}${dottedHint}`;
     throw new ValidationError(m, [{ path: ["attribute"], message: m }]);
   }
@@ -759,28 +765,30 @@ function validateQualifiedRule(rule, context) {
     const normalizedOperator2 = resolveCanonicalOperator(rule.operator, rootAttr.type);
     if (!ops.includes(normalizedOperator2)) {
       const validList = ops.length ? ops.join(", ") : "(not filterable)";
-      const summary = `Operator "${rule.operator}" is not valid for attribute "${rootAttr.name}". Valid operators: ${validList}.${locationQueryHint(rootAttr.type)}`;
+      const summary = `Operator "${rule.operator}" is not valid for attribute "${rootAttr.name}". Valid operators: ${validList}.${locationPartsHint(rootAttr.type)}`;
       throw new ValidationError(summary, [{ path: ["operator"], message: summary }]);
     }
     applyCanonicalForm(rule, normalizedOperator2, resolveEffectiveFilterType(rootAttr));
     return;
   }
+  if (rootAttr.type === "location") {
+    if (rule.quantifier !== void 0) {
+      const m = "quantifier is not valid on a location part \u2014 a location is one value, not a set of edges";
+      throw new ValidationError(m, [{ path: ["quantifier"], message: m }]);
+    }
+    if (!isLocationFilterProperty(rule.property)) {
+      const m = `Property "${rule.property}" is not a part of location "${rule.attribute}". Valid parts: ${LOCATION_PARTS_LIST}.`;
+      throw new ValidationError(m, [{ path: ["property"], message: m }]);
+    }
+    assertDynamicValueForAttribute(rule, "text");
+    const normalizedOperator2 = assertOperatorForType(rule.operator, "text", "property");
+    applyCanonicalForm(rule, normalizedOperator2, "text");
+    return;
+  }
   if (!REFERENCE_TYPES.has(rootAttr.type)) {
-    throw new ValidationError(
-      withLocationQueryHint(
-        `Cannot qualify ${rootAttr.type} attribute "${rule.attribute}"`,
-        rootAttr.type
-      ),
-      [
-        {
-          path: ["property"],
-          message: withLocationQueryHint(
-            `Attribute "${rule.attribute}" is not a reference type`,
-            rootAttr.type
-          )
-        }
-      ]
-    );
+    throw new ValidationError(`Cannot qualify ${rootAttr.type} attribute "${rule.attribute}"`, [
+      { path: ["property"], message: `Attribute "${rule.attribute}" is not a reference type` }
+    ]);
   }
   const propSchema = rootAttr.properties;
   if (!propSchema) {
@@ -841,6 +849,9 @@ var RESERVED_OBJECT_NAMES = ["skill"];
 var createModeSchema = z.enum(["redirect", "inline", "peek"]);
 var nonEmptyStringArraySchema = z.array(z.string()).min(1);
 var columnsSchema = z.array(z.string()).max(SCHEMA_LIMITS.columnsPerTab);
+var displayAttributesSchema = z.array(z.string().min(1)).max(SCHEMA_LIMITS.columnsPerTab).refine((names) => new Set(names).size === names.length, {
+  message: "Displayed attribute names must be unique"
+});
 var sortRuleSchema = z.object({
   attribute: z.string(),
   direction: z.enum(["asc", "desc"])
@@ -1281,6 +1292,8 @@ var listTabCommonShape = {
   // required so configs stored before the field existed still parse.
   visibility: z.enum(LIST_VIEW_TAB_VISIBILITIES).default("all"),
   columns: columnsSchema,
+  descriptionAttribute: z.string().min(1).optional(),
+  displayAttributes: displayAttributesSchema.optional(),
   filters: filterGroupSchema.optional(),
   sorts: sortsSchema.optional(),
   readOnly: z.boolean().optional(),
@@ -1289,11 +1302,15 @@ var listTabCommonShape = {
 var listTableTabSchema = z.object({
   ...listTabCommonShape,
   layout: z.literal("table"),
-  columnSizing: z.record(z.string(), z.number()).optional()
+  columnSizing: z.record(z.string(), z.number()).optional(),
+  // Opted-in system views expose their immutable code grouping as an inert
+  // hint so Architect can return to Kanban after a saved layout change.
+  groupByAttribute: z.string().min(1).optional()
 }).strict();
 var listKanbanTabSchema = z.object({
   ...listTabCommonShape,
   layout: z.literal("kanban"),
+  columns: columnsSchema.default([]),
   groupByAttribute: z.string(),
   cardUserAttribute: z.string().optional(),
   cardDateAttribute: z.string().optional(),
@@ -1301,17 +1318,33 @@ var listKanbanTabSchema = z.object({
   kanbanColumnVisibility: z.record(z.string(), z.boolean()).optional(),
   kanbanPinnedColumns: z.array(z.string()).optional()
 }).strict();
+var listRowsTabSchema = z.object({
+  ...listTabCommonShape,
+  layout: z.literal("list"),
+  columns: columnsSchema.default([]),
+  columnSizing: z.record(z.string(), z.number()).optional(),
+  groupByAttribute: z.string().min(1).optional()
+}).strict();
 var listViewTabSchema = z.discriminatedUnion("layout", [
   listTableTabSchema,
+  listRowsTabSchema,
   listKanbanTabSchema
 ]);
 var _listViewConfigSchema = z.object({
+  allowPresentationCustomization: z.boolean().optional(),
   defaultFilters: filterGroupSchema.optional(),
   tabs: z.array(listViewTabSchema).min(1).max(SCHEMA_LIMITS.tabsPerView)
 }).strict().superRefine((config, ctx) => {
   addDuplicateIdIssues(config.tabs, ctx, ["tabs"]);
   let hasDefault = false;
   config.tabs.forEach((tab, index) => {
+    if (tab.layout !== "kanban" && tab.groupByAttribute !== void 0 && config.allowPresentationCustomization !== true) {
+      ctx.addIssue({
+        code: "unrecognized_keys",
+        keys: ["groupByAttribute"],
+        path: ["tabs", index]
+      });
+    }
     if (!tab.default) return;
     if (hasDefault) {
       ctx.addIssue({
@@ -1396,4 +1429,4 @@ var LIST_TAB_KANBAN_KEYS = [
   "kanbanPinnedColumns"
 ];
 
-export { ATTRIBUTE_FILTER_OPERATORS, LIST_TAB_KANBAN_KEYS, LIST_TAB_TABLE_KEYS, LIST_VIEW_TAB_VISIBILITIES, NO_VALUE_OPERATORS, OPERATORS_BY_TYPE, REMOVED_OPERATOR_REPLACEMENTS, RESERVED_ATTRIBUTE_NAMES, RESERVED_OBJECT_NAMES, RESOURCE_VISIBILITIES, SYNONYM_ALIASES, SYSTEM_ATTRIBUTES, SYSTEM_ATTRIBUTE_I18N_KEYS, SYSTEM_FIELD_NAMES, SYSTEM_FILTER_ATTRIBUTE_TYPES, canonicalizeFilterValue, collectQualifiedRuleIssues, columnsSchema, currentActor, detailTabDraftSchema, detailTabSchema, detailViewConfigSchema, extractCurrencyFilterValue, extractFilterValue, fieldSchema, fieldShape, fieldSlotSchema, filterGroupSchema, filterStateSchema, getAttributeCapabilities, getAttributeFilterOperators, getOperatorPolarity, getRollupFilterOperators2 as getRollupFilterOperators, getSystemAttributeI18nKey, getSystemAttributeList, groupWriteSchema, inverseSourceSchema, isAttributeFilterable, isAttributeGroupable, isAttributeKanbanGroupable, isAttributeSearchable, isAttributeSortable, isDynamicValue, isManagedSystemAttribute, isNoValueOperator, isRelativeDateValue, isSetMembershipOperator, listViewConfigSchema, listViewTabSchema, normalizeFilterRule, normalizeForEdgeRpc, normalizeOperator, now, parseResourceVisibility, parseViewConfig, relationSourceSchema, resolveEffectiveFilterType, resolveIsWithinBounds, resolveUtcDayBounds, sortsSchema, tableSourceSchema, toMultiValueOperator, toUtcDayString, today, validateQualifiedRule, viewConfigByTypeSchema, viewTypeSchema };
+export { ATTRIBUTE_FILTER_OPERATORS, LIST_TAB_KANBAN_KEYS, LIST_TAB_TABLE_KEYS, LIST_VIEW_TAB_VISIBILITIES, LOCATION_FILTER_PROPERTIES, NO_VALUE_OPERATORS, OPERATORS_BY_TYPE, REMOVED_OPERATOR_REPLACEMENTS, RESERVED_ATTRIBUTE_NAMES, RESERVED_OBJECT_NAMES, RESOURCE_VISIBILITIES, SYNONYM_ALIASES, SYSTEM_ATTRIBUTES, SYSTEM_ATTRIBUTE_I18N_KEYS, SYSTEM_FIELD_NAMES, SYSTEM_FILTER_ATTRIBUTE_TYPES, canonicalizeFilterValue, collectQualifiedRuleIssues, columnsSchema, currentActor, detailTabDraftSchema, detailTabSchema, detailViewConfigSchema, displayAttributesSchema, extractCurrencyFilterValue, extractFilterValue, fieldSchema, fieldShape, fieldSlotSchema, filterGroupSchema, filterStateSchema, getAttributeCapabilities, getAttributeFilterOperators, getOperatorPolarity, getRollupFilterOperators2 as getRollupFilterOperators, getSystemAttributeI18nKey, getSystemAttributeList, groupWriteSchema, inverseSourceSchema, isAttributeFilterable, isAttributeGroupable, isAttributeKanbanGroupable, isAttributeSearchable, isAttributeSortable, isDynamicValue, isLocationFilterProperty, isLocationPartOperator, isManagedSystemAttribute, isNoValueOperator, isRelativeDateValue, isSetMembershipOperator, listViewConfigSchema, listViewTabSchema, normalizeFilterRule, normalizeForEdgeRpc, normalizeOperator, now, parseResourceVisibility, parseViewConfig, relationSourceSchema, resolveEffectiveFilterType, resolveIsWithinBounds, resolveUtcDayBounds, sortsSchema, tableSourceSchema, toMultiValueOperator, toUtcDayString, today, validateQualifiedRule, viewConfigByTypeSchema, viewTypeSchema };

package/dist/{chunk-5JMQNH2A.js → chunk-KAWYU7TE.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk3YCZ5H3H_js = require('./chunk-3YCZ5H3H.js');
+var chunk4KMUATDG_js = require('./chunk-4KMUATDG.js');
 var zod = require('zod');
 var constants = require('@stndrds/constants');
 
@@ -551,7 +551,7 @@ var attributeConfigSchemas = {
 function getAttributeConfigSchema(type) {
   const schema = attributeConfigSchemas[type];
   if (!schema) {
-    throw new chunk3YCZ5H3H_js.ValidationError(`Unsupported attribute type: ${type}`, []);
+    throw new chunk4KMUATDG_js.ValidationError(`Unsupported attribute type: ${type}`, []);
   }
   return schema;
 }
@@ -575,7 +575,7 @@ function getAttributeConfigWriteSchema(type) {
   }
 }
 function validationErrorFromIssues(issues) {
-  return chunk3YCZ5H3H_js.ValidationError.fromZodErrors(
+  return chunk4KMUATDG_js.ValidationError.fromZodErrors(
     issues.map((issue) => ({
       path: issue.path.map((segment) => typeof segment === "symbol" ? String(segment) : segment),
       message: issue.message
@@ -598,7 +598,7 @@ function validatePatchedIcon(patch) {
   }
   const result = iconNameSchema.optional().safeParse(patch.icon);
   if (!result.success) {
-    throw chunk3YCZ5H3H_js.ValidationError.fromZodErrors(
+    throw chunk4KMUATDG_js.ValidationError.fromZodErrors(
       result.error.issues.map((issue) => ({
         path: [
           "icon",

package/dist/{chunk-UW3BOSB6.mjs → chunk-QT35SI3K.mjs}

@@ -1,4 +1,4 @@
-import { ValidationError } from './chunk-7WEOBXXA.mjs';
+import { ValidationError } from './chunk-CLZORRMS.mjs';
 import { z } from 'zod';
 import { ICONS, COLORS } from '@stndrds/constants';
 

package/dist/{chunk-JSQCTLV5.mjs → chunk-R2DAEDRF.mjs}

@@ -1,4 +1,4 @@
-import { ValidationError } from './chunk-7WEOBXXA.mjs';
+import { ValidationError } from './chunk-CLZORRMS.mjs';
 
 // src/utils/canonical-json.ts
 function canonicalStringify(value) {

package/dist/{chunk-D4A6FL67.js → chunk-T5PM73EF.js}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunk5JMQNH2A_js = require('./chunk-5JMQNH2A.js');
-var chunk3YCZ5H3H_js = require('./chunk-3YCZ5H3H.js');
+var chunkKAWYU7TE_js = require('./chunk-KAWYU7TE.js');
+var chunk4KMUATDG_js = require('./chunk-4KMUATDG.js');
 var zod = require('zod');
 
 // src/types/system-attributes.ts
@@ -155,6 +155,13 @@ var FORMULA_OPERATORS = [
   "is_empty",
   "is_not_empty"
 ];
+var LOCATION_FILTER_PROPERTIES = ["city", "postalCode", "country"];
+function isLocationFilterProperty(name) {
+  return LOCATION_FILTER_PROPERTIES.includes(name);
+}
+function isLocationPartOperator(operator) {
+  return TEXT_OPERATORS.includes(operator);
+}
 var ATTRIBUTE_FILTER_OPERATORS = {
   text: TEXT_OPERATORS,
   richtext: [],
@@ -500,7 +507,7 @@ function canonicalizeFilterValue(rule, effectiveType) {
   const message = `Filter on a currency attribute expected a numeric amount, received ${JSON.stringify(
     value
   )}`;
-  throw new chunk3YCZ5H3H_js.ValidationError(message, [{ path: ["value"], message }]);
+  throw new chunk4KMUATDG_js.ValidationError(message, [{ path: ["value"], message }]);
 }
 function hasCurrencyAmount(value) {
   if (typeof value !== "object") return true;
@@ -663,13 +670,13 @@ function resolveCanonicalOperator(rawOperator, effectiveType) {
   const replacement = REMOVED_OPERATOR_REPLACEMENTS[rawOperator];
   if (replacement) {
     const m = `Unknown filter operator "${rawOperator}" \u2014 use ${replacement}`;
-    throw new chunk3YCZ5H3H_js.ValidationError(m, [{ path: ["operator"], message: m }]);
+    throw new chunk4KMUATDG_js.ValidationError(m, [{ path: ["operator"], message: m }]);
   }
   const normalized = normalizeOperator(rawOperator);
   const membership = SUBSTRING_TO_MEMBERSHIP[normalized];
   if (membership && SET_MEMBERSHIP_TYPES.has(effectiveType)) {
     const m = `Operator "${normalized}" is not valid for type "${effectiveType}" \u2014 use "${membership}"`;
-    throw new chunk3YCZ5H3H_js.ValidationError(m, [{ path: ["operator"], message: m }]);
+    throw new chunk4KMUATDG_js.ValidationError(m, [{ path: ["operator"], message: m }]);
   }
   return normalized;
 }
@@ -679,7 +686,7 @@ function assertOperatorForType(operator, type, context) {
   if (!ops?.includes(normalized)) {
     const validList = ops?.length ? ops.join(", ") : "(no operators registered for this type)";
     const summary = `Operator "${operator}" is not valid for ${context} type "${type}". Valid operators: ${validList}.`;
-    throw new chunk3YCZ5H3H_js.ValidationError(summary, [
+    throw new chunk4KMUATDG_js.ValidationError(summary, [
       {
         path: ["operator"],
         message: summary
@@ -692,7 +699,7 @@ function assertRelativeDateValue(rule) {
   if (rule.operator !== "is_within") return;
   if (!isRelativeDateValue(rule.value)) {
     const m = `Operator "is_within" requires a relative-date value { amount: positive number, unit: days|weeks|months|years, direction: past|future }`;
-    throw new chunk3YCZ5H3H_js.ValidationError(m, [{ path: ["value"], message: m }]);
+    throw new chunk4KMUATDG_js.ValidationError(m, [{ path: ["value"], message: m }]);
   }
 }
 function applyCanonicalForm(rule, operator, effectiveType) {
@@ -705,26 +712,23 @@ function assertDynamicValueForAttribute(rule, attrType) {
   const v = rule.value;
   if (v.dynamic === "actor" && attrType !== "user") {
     const m = `actor token (@me) is only valid on user attributes, not "${attrType}"`;
-    throw new chunk3YCZ5H3H_js.ValidationError(m, [{ path: ["value"], message: m }]);
+    throw new chunk4KMUATDG_js.ValidationError(m, [{ path: ["value"], message: m }]);
   }
   if (v.dynamic === "date" && attrType !== "date") {
     const m = `date token (@today/@now) is only valid on date attributes, not "${attrType}"`;
-    throw new chunk3YCZ5H3H_js.ValidationError(m, [{ path: ["value"], message: m }]);
+    throw new chunk4KMUATDG_js.ValidationError(m, [{ path: ["value"], message: m }]);
   }
 }
-function locationQueryHint(type) {
-  return type === "location" ? ' Location attributes cannot be filtered on their text \u2014 use the full-text "query" parameter to match a city, address or postal code.' : "";
-}
-function withLocationQueryHint(message, type) {
-  const hint = locationQueryHint(type);
-  return hint ? `${message}.${hint}` : message;
+var LOCATION_PARTS_LIST = LOCATION_FILTER_PROPERTIES.map((part) => `"${part}"`).join(", ");
+function locationPartsHint(type) {
+  return type === "location" ? ` A location is filtered on one of its parts: set "property" to one of ${LOCATION_PARTS_LIST} and use a text operator (e.g. contains).` : "";
 }
 function collectQualifiedRuleIssues(rule, context) {
   try {
     validateQualifiedRule({ ...rule }, context);
     return [];
   } catch (error) {
-    if (!(error instanceof chunk3YCZ5H3H_js.ValidationError)) throw error;
+    if (!(error instanceof chunk4KMUATDG_js.ValidationError)) throw error;
     return error.errors.map((issue) => ({ ...issue, path: [...issue.path] }));
   }
 }
@@ -732,17 +736,19 @@ function validateQualifiedRule(rule, context) {
   const rootAttr = context.attributes.find((a) => a.name === rule.attribute);
   const systemOps = SYSTEM_FILTER_OPERATORS[rule.attribute];
   if (!(rootAttr || systemOps)) {
-    const dottedHint = rule.attribute.includes(".") ? ' Dotted paths are not supported \u2014 filter on the attribute name alone, or use the full-text "query" parameter to match text inside a value.' : "";
+    const [head, ...tail] = rule.attribute.split(".");
+    const dottedRoot = tail.length > 0 ? context.attributes.find((a) => a.name === head) : void 0;
+    const dottedHint = dottedRoot?.type === "location" ? ` Dotted paths are not supported \u2014 set "attribute" to "${head}" and "property" to ${isLocationFilterProperty(tail[0] ?? "") ? `"${tail[0]}"` : `one of ${LOCATION_PARTS_LIST}`}.` : rule.attribute.includes(".") ? ' Dotted paths are not supported \u2014 filter on the attribute name alone, or use the full-text "query" parameter to match text inside a value.' : "";
     const m = `Unknown attribute: ${rule.attribute}${dottedHint}`;
-    throw new chunk3YCZ5H3H_js.ValidationError(m, [{ path: ["attribute"], message: m }]);
+    throw new chunk4KMUATDG_js.ValidationError(m, [{ path: ["attribute"], message: m }]);
   }
   if (rule.quantifier !== void 0 && !rule.property) {
     const m = `quantifier is only valid on qualified edge rules (set "property")`;
-    throw new chunk3YCZ5H3H_js.ValidationError(m, [{ path: ["quantifier"], message: m }]);
+    throw new chunk4KMUATDG_js.ValidationError(m, [{ path: ["quantifier"], message: m }]);
   }
   if (!rootAttr) {
     if (rule.property) {
-      throw new chunk3YCZ5H3H_js.ValidationError(`Cannot qualify system attribute "${rule.attribute}"`, [
+      throw new chunk4KMUATDG_js.ValidationError(`Cannot qualify system attribute "${rule.attribute}"`, [
         { path: ["property"], message: `"${rule.attribute}" is a system column, not a reference` }
       ]);
     }
@@ -750,7 +756,7 @@ function validateQualifiedRule(rule, context) {
     const normalizedOperator2 = resolveCanonicalOperator(rule.operator, effectiveType);
     if (!systemOps.includes(normalizedOperator2)) {
       const summary = `Operator "${rule.operator}" is not valid for system attribute "${rule.attribute}". Valid operators: ${systemOps.join(", ")}.`;
-      throw new chunk3YCZ5H3H_js.ValidationError(summary, [{ path: ["operator"], message: summary }]);
+      throw new chunk4KMUATDG_js.ValidationError(summary, [{ path: ["operator"], message: summary }]);
     }
     applyCanonicalForm(rule, normalizedOperator2, effectiveType);
     return;
@@ -761,38 +767,40 @@ function validateQualifiedRule(rule, context) {
     const normalizedOperator2 = resolveCanonicalOperator(rule.operator, rootAttr.type);
     if (!ops.includes(normalizedOperator2)) {
       const validList = ops.length ? ops.join(", ") : "(not filterable)";
-      const summary = `Operator "${rule.operator}" is not valid for attribute "${rootAttr.name}". Valid operators: ${validList}.${locationQueryHint(rootAttr.type)}`;
-      throw new chunk3YCZ5H3H_js.ValidationError(summary, [{ path: ["operator"], message: summary }]);
+      const summary = `Operator "${rule.operator}" is not valid for attribute "${rootAttr.name}". Valid operators: ${validList}.${locationPartsHint(rootAttr.type)}`;
+      throw new chunk4KMUATDG_js.ValidationError(summary, [{ path: ["operator"], message: summary }]);
     }
     applyCanonicalForm(rule, normalizedOperator2, resolveEffectiveFilterType(rootAttr));
     return;
   }
+  if (rootAttr.type === "location") {
+    if (rule.quantifier !== void 0) {
+      const m = "quantifier is not valid on a location part \u2014 a location is one value, not a set of edges";
+      throw new chunk4KMUATDG_js.ValidationError(m, [{ path: ["quantifier"], message: m }]);
+    }
+    if (!isLocationFilterProperty(rule.property)) {
+      const m = `Property "${rule.property}" is not a part of location "${rule.attribute}". Valid parts: ${LOCATION_PARTS_LIST}.`;
+      throw new chunk4KMUATDG_js.ValidationError(m, [{ path: ["property"], message: m }]);
+    }
+    assertDynamicValueForAttribute(rule, "text");
+    const normalizedOperator2 = assertOperatorForType(rule.operator, "text", "property");
+    applyCanonicalForm(rule, normalizedOperator2, "text");
+    return;
+  }
   if (!REFERENCE_TYPES.has(rootAttr.type)) {
-    throw new chunk3YCZ5H3H_js.ValidationError(
-      withLocationQueryHint(
-        `Cannot qualify ${rootAttr.type} attribute "${rule.attribute}"`,
-        rootAttr.type
-      ),
-      [
-        {
-          path: ["property"],
-          message: withLocationQueryHint(
-            `Attribute "${rule.attribute}" is not a reference type`,
-            rootAttr.type
-          )
-        }
-      ]
-    );
+    throw new chunk4KMUATDG_js.ValidationError(`Cannot qualify ${rootAttr.type} attribute "${rule.attribute}"`, [
+      { path: ["property"], message: `Attribute "${rule.attribute}" is not a reference type` }
+    ]);
   }
   const propSchema = rootAttr.properties;
   if (!propSchema) {
-    throw new chunk3YCZ5H3H_js.ValidationError(`Attribute "${rule.attribute}" has no qualifyWith schema`, [
+    throw new chunk4KMUATDG_js.ValidationError(`Attribute "${rule.attribute}" has no qualifyWith schema`, [
       { path: ["property"], message: `"${rule.attribute}" has no qualifyWith` }
     ]);
   }
   const propDef = propSchema.definitions.find((p) => p.name === rule.property);
   if (!propDef) {
-    throw new chunk3YCZ5H3H_js.ValidationError(
+    throw new chunk4KMUATDG_js.ValidationError(
       `Property "${rule.property}" not defined on "${rule.attribute}".qualifyWith()`,
       [{ path: ["property"], message: `Unknown property: ${rule.property}` }]
     );
@@ -808,7 +816,7 @@ function parseResourceVisibility(value) {
   if (typeof value === "string" && RESOURCE_VISIBILITIES.includes(value)) {
     return value;
   }
-  throw new chunk3YCZ5H3H_js.ValidationError(
+  throw new chunk4KMUATDG_js.ValidationError(
     `visibility must be one of: ${RESOURCE_VISIBILITIES.join(", ")} (received: ${String(value)})`,
     []
   );
@@ -842,12 +850,15 @@ var RESERVED_OBJECT_NAMES = ["skill"];
 // src/validators/view-config.schema.ts
 var createModeSchema = zod.z.enum(["redirect", "inline", "peek"]);
 var nonEmptyStringArraySchema = zod.z.array(zod.z.string()).min(1);
-var columnsSchema = zod.z.array(zod.z.string()).max(chunk5JMQNH2A_js.SCHEMA_LIMITS.columnsPerTab);
+var columnsSchema = zod.z.array(zod.z.string()).max(chunkKAWYU7TE_js.SCHEMA_LIMITS.columnsPerTab);
+var displayAttributesSchema = zod.z.array(zod.z.string().min(1)).max(chunkKAWYU7TE_js.SCHEMA_LIMITS.columnsPerTab).refine((names) => new Set(names).size === names.length, {
+  message: "Displayed attribute names must be unique"
+});
 var sortRuleSchema = zod.z.object({
   attribute: zod.z.string(),
   direction: zod.z.enum(["asc", "desc"])
 }).strict();
-var sortsSchema = zod.z.array(sortRuleSchema).max(chunk5JMQNH2A_js.SCHEMA_LIMITS.sortsPerTab);
+var sortsSchema = zod.z.array(sortRuleSchema).max(chunkKAWYU7TE_js.SCHEMA_LIMITS.sortsPerTab);
 var relativeDateValueSchema = zod.z.object({
   amount: zod.z.number(),
   unit: zod.z.enum(["days", "weeks", "months", "years"]),
@@ -921,7 +932,7 @@ var filterRuleSchema = zod.z.object({
   operator: filterOperatorSchema,
   value: filterValueSchema
 }).strict();
-var filterRulesSchema = zod.z.array(filterRuleSchema).max(chunk5JMQNH2A_js.SCHEMA_LIMITS.filterRulesPerTab);
+var filterRulesSchema = zod.z.array(filterRuleSchema).max(chunkKAWYU7TE_js.SCHEMA_LIMITS.filterRulesPerTab);
 var filterStateSchema = zod.z.object({
   combinator: zod.z.enum(["and", "or"]),
   rules: filterRulesSchema
@@ -1012,17 +1023,17 @@ var baseGroupShape = {
 var fieldGroupWriteSchema = zod.z.object({
   ...baseGroupShape,
   type: zod.z.literal("fields"),
-  fields: zod.z.array(fieldSchema).max(chunk5JMQNH2A_js.SCHEMA_LIMITS.fieldsPerGroup)
+  fields: zod.z.array(fieldSchema).max(chunkKAWYU7TE_js.SCHEMA_LIMITS.fieldsPerGroup)
 }).strict();
 var groupWriteSchema = fieldGroupWriteSchema;
 var baseTabShape = {
   id: zod.z.string(),
   name: zod.z.string(),
   label: zod.z.string(),
-  icon: chunk5JMQNH2A_js.iconNameSchema.optional(),
+  icon: chunkKAWYU7TE_js.iconNameSchema.optional(),
   order: zod.z.number().optional()
 };
-var formTabGroupsSchema = zod.z.array(groupWriteSchema).max(chunk5JMQNH2A_js.SCHEMA_LIMITS.groupsPerFormTab);
+var formTabGroupsSchema = zod.z.array(groupWriteSchema).max(chunkKAWYU7TE_js.SCHEMA_LIMITS.groupsPerFormTab);
 var formTabShape = {
   ...baseTabShape,
   type: zod.z.literal("form"),
@@ -1037,13 +1048,13 @@ function refineFormTab(tab, ctx) {
     (count, group) => count + (group.type === "fields" ? group.fields.length : 0),
     0
   );
-  if (totalFields > chunk5JMQNH2A_js.SCHEMA_LIMITS.fieldsPerFormTab) {
+  if (totalFields > chunkKAWYU7TE_js.SCHEMA_LIMITS.fieldsPerFormTab) {
     ctx.addIssue({
       code: "too_big",
       origin: "array",
-      maximum: chunk5JMQNH2A_js.SCHEMA_LIMITS.fieldsPerFormTab,
+      maximum: chunkKAWYU7TE_js.SCHEMA_LIMITS.fieldsPerFormTab,
       inclusive: true,
-      message: `A form tab can contain at most ${chunk5JMQNH2A_js.SCHEMA_LIMITS.fieldsPerFormTab} fields`,
+      message: `A form tab can contain at most ${chunkKAWYU7TE_js.SCHEMA_LIMITS.fieldsPerFormTab} fields`,
       path: ["groups"]
     });
   }
@@ -1247,12 +1258,12 @@ var formsTabSchema = zod.z.object({
 var emailsTabSchema = zod.z.object({
   ...baseTabShape,
   type: zod.z.literal("emails"),
-  emailAttributeIds: zod.z.array(zod.z.string()).max(chunk5JMQNH2A_js.SCHEMA_LIMITS.emailAttributesPerTab)
+  emailAttributeIds: zod.z.array(zod.z.string()).max(chunkKAWYU7TE_js.SCHEMA_LIMITS.emailAttributesPerTab)
 }).strict();
 var meetingsTabSchema = zod.z.object({
   ...baseTabShape,
   type: zod.z.literal("meetings"),
-  emailAttributeIds: zod.z.array(zod.z.string()).max(chunk5JMQNH2A_js.SCHEMA_LIMITS.emailAttributesPerTab)
+  emailAttributeIds: zod.z.array(zod.z.string()).max(chunkKAWYU7TE_js.SCHEMA_LIMITS.emailAttributesPerTab)
 }).strict();
 var nonFormDetailTabSchemas = [
   tableTabSchema,
@@ -1275,7 +1286,7 @@ var detailTabDraftSchema = zod.z.discriminatedUnion("type", [
 var listTabCommonShape = {
   id: zod.z.string(),
   label: zod.z.string(),
-  icon: chunk5JMQNH2A_js.iconNameSchema.optional(),
+  icon: chunkKAWYU7TE_js.iconNameSchema.optional(),
   default: zod.z.boolean().optional(),
   // Which records the tab scopes to. `"all"` is the default and means "impose
   // no scope" — the mandatory viewer predicate alone decides, so the tab shows
@@ -1283,6 +1294,8 @@ var listTabCommonShape = {
   // required so configs stored before the field existed still parse.
   visibility: zod.z.enum(LIST_VIEW_TAB_VISIBILITIES).default("all"),
   columns: columnsSchema,
+  descriptionAttribute: zod.z.string().min(1).optional(),
+  displayAttributes: displayAttributesSchema.optional(),
   filters: filterGroupSchema.optional(),
   sorts: sortsSchema.optional(),
   readOnly: zod.z.boolean().optional(),
@@ -1291,11 +1304,15 @@ var listTabCommonShape = {
 var listTableTabSchema = zod.z.object({
   ...listTabCommonShape,
   layout: zod.z.literal("table"),
-  columnSizing: zod.z.record(zod.z.string(), zod.z.number()).optional()
+  columnSizing: zod.z.record(zod.z.string(), zod.z.number()).optional(),
+  // Opted-in system views expose their immutable code grouping as an inert
+  // hint so Architect can return to Kanban after a saved layout change.
+  groupByAttribute: zod.z.string().min(1).optional()
 }).strict();
 var listKanbanTabSchema = zod.z.object({
   ...listTabCommonShape,
   layout: zod.z.literal("kanban"),
+  columns: columnsSchema.default([]),
   groupByAttribute: zod.z.string(),
   cardUserAttribute: zod.z.string().optional(),
   cardDateAttribute: zod.z.string().optional(),
@@ -1303,17 +1320,33 @@ var listKanbanTabSchema = zod.z.object({
   kanbanColumnVisibility: zod.z.record(zod.z.string(), zod.z.boolean()).optional(),
   kanbanPinnedColumns: zod.z.array(zod.z.string()).optional()
 }).strict();
+var listRowsTabSchema = zod.z.object({
+  ...listTabCommonShape,
+  layout: zod.z.literal("list"),
+  columns: columnsSchema.default([]),
+  columnSizing: zod.z.record(zod.z.string(), zod.z.number()).optional(),
+  groupByAttribute: zod.z.string().min(1).optional()
+}).strict();
 var listViewTabSchema = zod.z.discriminatedUnion("layout", [
   listTableTabSchema,
+  listRowsTabSchema,
   listKanbanTabSchema
 ]);
 var _listViewConfigSchema = zod.z.object({
+  allowPresentationCustomization: zod.z.boolean().optional(),
   defaultFilters: filterGroupSchema.optional(),
-  tabs: zod.z.array(listViewTabSchema).min(1).max(chunk5JMQNH2A_js.SCHEMA_LIMITS.tabsPerView)
+  tabs: zod.z.array(listViewTabSchema).min(1).max(chunkKAWYU7TE_js.SCHEMA_LIMITS.tabsPerView)
 }).strict().superRefine((config, ctx) => {
   addDuplicateIdIssues(config.tabs, ctx, ["tabs"]);
   let hasDefault = false;
   config.tabs.forEach((tab, index) => {
+    if (tab.layout !== "kanban" && tab.groupByAttribute !== void 0 && config.allowPresentationCustomization !== true) {
+      ctx.addIssue({
+        code: "unrecognized_keys",
+        keys: ["groupByAttribute"],
+        path: ["tabs", index]
+      });
+    }
     if (!tab.default) return;
     if (hasDefault) {
       ctx.addIssue({
@@ -1330,7 +1363,7 @@ var sidePanelPaneSchema = zod.z.discriminatedUnion("kind", [
     kind: zod.z.literal("fields"),
     id: zod.z.string().optional(),
     label: zod.z.string().optional(),
-    attributes: zod.z.array(zod.z.string()).max(chunk5JMQNH2A_js.SCHEMA_LIMITS.sidePanelAttributes)
+    attributes: zod.z.array(zod.z.string()).max(chunkKAWYU7TE_js.SCHEMA_LIMITS.sidePanelAttributes)
   }).strict(),
   zod.z.object({
     kind: zod.z.literal("activity"),
@@ -1349,10 +1382,10 @@ var sidePanelPaneSchema = zod.z.discriminatedUnion("kind", [
   }).strict()
 ]);
 var _detailViewConfigSchema = zod.z.object({
-  tabs: zod.z.array(detailTabSchema).min(1).max(chunk5JMQNH2A_js.SCHEMA_LIMITS.tabsPerView),
+  tabs: zod.z.array(detailTabSchema).min(1).max(chunkKAWYU7TE_js.SCHEMA_LIMITS.tabsPerView),
   sidePanel: zod.z.object({
-    attributes: zod.z.array(zod.z.string()).max(chunk5JMQNH2A_js.SCHEMA_LIMITS.sidePanelAttributes).optional(),
-    panes: zod.z.array(sidePanelPaneSchema).max(chunk5JMQNH2A_js.SCHEMA_LIMITS.sidePanelPanes).optional(),
+    attributes: zod.z.array(zod.z.string()).max(chunkKAWYU7TE_js.SCHEMA_LIMITS.sidePanelAttributes).optional(),
+    panes: zod.z.array(sidePanelPaneSchema).max(chunkKAWYU7TE_js.SCHEMA_LIMITS.sidePanelPanes).optional(),
     width: zod.z.number().optional()
   }).strict().refine((sidePanel) => sidePanel.attributes !== void 0 || sidePanel.panes !== void 0, {
     message: "sidePanel requires attributes or panes"
@@ -1402,6 +1435,7 @@ exports.ATTRIBUTE_FILTER_OPERATORS = ATTRIBUTE_FILTER_OPERATORS;
 exports.LIST_TAB_KANBAN_KEYS = LIST_TAB_KANBAN_KEYS;
 exports.LIST_TAB_TABLE_KEYS = LIST_TAB_TABLE_KEYS;
 exports.LIST_VIEW_TAB_VISIBILITIES = LIST_VIEW_TAB_VISIBILITIES;
+exports.LOCATION_FILTER_PROPERTIES = LOCATION_FILTER_PROPERTIES;
 exports.NO_VALUE_OPERATORS = NO_VALUE_OPERATORS;
 exports.OPERATORS_BY_TYPE = OPERATORS_BY_TYPE;
 exports.REMOVED_OPERATOR_REPLACEMENTS = REMOVED_OPERATOR_REPLACEMENTS;
@@ -1420,6 +1454,7 @@ exports.currentActor = currentActor;
 exports.detailTabDraftSchema = detailTabDraftSchema;
 exports.detailTabSchema = detailTabSchema;
 exports.detailViewConfigSchema = detailViewConfigSchema;
+exports.displayAttributesSchema = displayAttributesSchema;
 exports.extractCurrencyFilterValue = extractCurrencyFilterValue;
 exports.extractFilterValue = extractFilterValue;
 exports.fieldSchema = fieldSchema;
@@ -1441,6 +1476,8 @@ exports.isAttributeKanbanGroupable = isAttributeKanbanGroupable;
 exports.isAttributeSearchable = isAttributeSearchable;
 exports.isAttributeSortable = isAttributeSortable;
 exports.isDynamicValue = isDynamicValue;
+exports.isLocationFilterProperty = isLocationFilterProperty;
+exports.isLocationPartOperator = isLocationPartOperator;
 exports.isManagedSystemAttribute = isManagedSystemAttribute;
 exports.isNoValueOperator = isNoValueOperator;
 exports.isRelativeDateValue = isRelativeDateValue;

package/dist/exceptions.d.mts

@@ -96,10 +96,13 @@ declare const SchemaErrorCode: {
     readonly AGENT_WORK_MODE_REQUIRED: "AGENT_WORK_MODE_REQUIRED";
     readonly AGENT_MESSAGE_NOT_FOUND: "AGENT_MESSAGE_NOT_FOUND";
     readonly AGENT_MESSAGE_NOT_EDITABLE: "AGENT_MESSAGE_NOT_EDITABLE";
+    readonly DEVICE_NOT_FOUND: "DEVICE_NOT_FOUND";
+    readonly DEVICE_OFFLINE: "DEVICE_OFFLINE";
     readonly AI_UNKNOWN: "AI_UNKNOWN";
     readonly AI_USAGE_LIMIT_EXCEEDED: "AI_USAGE_LIMIT_EXCEEDED";
     readonly AI_INVALID_USAGE: "AI_INVALID_USAGE";
     readonly AI_INVALID_MODEL: "AI_INVALID_MODEL";
+    readonly AI_INVALID_MODEL_INPUT: "AI_INVALID_MODEL_INPUT";
     readonly AI_REPOSITORY_ERROR: "AI_REPOSITORY_ERROR";
     readonly AI_GENERATION_FAILED: "AI_GENERATION_FAILED";
     readonly DOCUMENT_MIME_NOT_ACCEPTED: "DOCUMENT_MIME_NOT_ACCEPTED";
@@ -131,6 +134,10 @@ declare const SchemaErrorCode: {
     readonly REFLEX_DEPENDENCY_DRIFT: "REFLEX_DEPENDENCY_DRIFT";
     readonly REFLEX_NOT_READY: "REFLEX_NOT_READY";
     readonly REFLEX_INVARIANT_VIOLATION: "REFLEX_INVARIANT_VIOLATION";
+    /** The embeddings feature is enabled but no Gateway credential is configured. */
+    readonly EMBEDDING_MODEL_UNAVAILABLE: "EMBEDDING_MODEL_UNAVAILABLE";
+    /** The provider returned vectors whose length differs from the configured dimensions. */
+    readonly EMBEDDING_DIMENSION_MISMATCH: "EMBEDDING_DIMENSION_MISMATCH";
 };
 type SchemaErrorCode = (typeof SchemaErrorCode)[keyof typeof SchemaErrorCode];
 /**