@fayz-ai/core 0.10.0 → 0.11.0

package/dist/{chunk-732GZEUI.js → chunk-RRYFXUQX.js}

@@ -1,3 +1,4 @@
+import { Registry } from './chunk-EWKX4VUM.js';
 import { getAllEntities } from './chunk-CU64QI4A.js';
 import * as React from 'react';
 
@@ -153,59 +154,6 @@ function defaultPropsFromSettings(settings = []) {
   return props;
 }
 
-// src/registry/registry-class.ts
-var Registry = class {
-  constructor(kind) {
-    this.kind = kind;
-    this.entries = /* @__PURE__ */ new Map();
-  }
-  register(id, value, meta = {}) {
-    const title = meta.title ?? meta.label;
-    this.entries.set(id, { id, value, meta: title === void 0 ? meta : { ...meta, title, label: title } });
-  }
-  get(id) {
-    return this.entries.get(id)?.value;
-  }
-  getEntry(id) {
-    return this.entries.get(id);
-  }
-  has(id) {
-    return this.entries.has(id);
-  }
-  list() {
-    return Array.from(this.entries.values());
-  }
-  ids() {
-    return Array.from(this.entries.keys());
-  }
-  /**
-   * Every entry reduced to the uniform meta envelope, sorted by id.
-   *
-   * Sorted for the same reason as `describeBlocks`: this feeds prompts,
-   * documents and generated catalogs, and registration order is an
-   * implementation detail that would make every diff noisy.
-   */
-  describe() {
-    return this.list().map(({ id, meta }) => ({
-      id,
-      kind: this.kind,
-      title: meta.title ?? meta.label,
-      description: meta.description,
-      schema: meta.propsSchema,
-      stability: meta.stability ?? "stable",
-      since: meta.since,
-      source: meta.source,
-      pluginId: meta.pluginId
-    })).sort((a, b) => a.id.localeCompare(b.id));
-  }
-  clear() {
-    this.entries.clear();
-  }
-};
-function isCustomId(id) {
-  return id.startsWith("custom:");
-}
-
 // src/registry/handles.ts
 var HANDLE_NAME_RE = /^[a-z0-9][a-z0-9-]*(\.[A-Za-z0-9_][A-Za-z0-9_-]*)+$/;
 var handleRegistry = new Registry("handle");
@@ -314,314 +262,6 @@ function dataNeedKey(loader, params = {}) {
   return `${loader} ${canonicalJson(params)}`;
 }
 
-// src/registry/entities.ts
-var ENTITY_FIELD_TYPES = [
-  "text",
-  "richtext",
-  "number",
-  "boolean",
-  "json",
-  "image",
-  "url",
-  "ref",
-  "point",
-  "datetime"
-];
-var GENERIC_ENTITY_TABLE = "plg_entity_records";
-var ENTITY_KEY_RE = /^[a-z][a-z0-9_]*$/;
-var FIELD_NAME_RE = /^[a-z][a-z0-9_]*$/;
-var RESERVED_ENTITY_FIELDS = ["id", "slug", "entity", "tenant_id", "created_at", "updated_at"];
-var entityDeclarationRegistry = new Registry("entity");
-function fail(message, valid) {
-  throw new Error(valid?.length ? `${message} Valid: ${valid.join(", ")}.` : message);
-}
-function normalizeDeclaration(key, input) {
-  if (!ENTITY_KEY_RE.test(key)) {
-    fail(`defineEntity: "${key}" is not a valid entity key \u2014 keys are snake_case (${ENTITY_KEY_RE}).`);
-  }
-  const fieldNames = Object.keys(input.fields ?? {});
-  if (fieldNames.length === 0) {
-    fail(`defineEntity("${key}"): an entity declares at least one field.`);
-  }
-  for (const [name, field] of Object.entries(input.fields)) {
-    if (!FIELD_NAME_RE.test(name)) {
-      fail(`defineEntity("${key}"): "${name}" is not a valid field name \u2014 fields are snake_case (${FIELD_NAME_RE}).`);
-    }
-    if (RESERVED_ENTITY_FIELDS.includes(name)) {
-      fail(`defineEntity("${key}"): "${name}" is a structural record column and cannot be a declared field.`, RESERVED_ENTITY_FIELDS);
-    }
-    if (!ENTITY_FIELD_TYPES.includes(field?.type)) {
-      fail(`defineEntity("${key}"): field "${name}" has unknown type "${String(field?.type)}".`, ENTITY_FIELD_TYPES);
-    }
-    if (field.type === "ref" && !field.entity) {
-      fail(`defineEntity("${key}"): ref field "${name}" must name the entity it points to ({ type: 'ref', entity: '<key>' }).`);
-    }
-  }
-  const knows = (name, where) => {
-    if (!fieldNames.includes(name)) {
-      fail(`defineEntity("${key}"): ${where} references undeclared field "${name}".`, fieldNames);
-    }
-  };
-  for (const index of input.indexes ?? []) {
-    for (const name of index) knows(name, "an index");
-  }
-  if (input.titleField) knows(input.titleField, "titleField");
-  for (const name of input.displayFields ?? []) knows(name, "displayFields");
-  const titleField = input.titleField ?? fieldNames.find((name) => input.fields[name].type === "text");
-  const displayFields = input.displayFields ?? fieldNames.filter((name) => input.fields[name].type !== "json");
-  return {
-    key,
-    title: input.title ?? key,
-    description: input.description,
-    fields: input.fields,
-    scope: input.scope ?? "tenant",
-    access: { read: input.access?.read ?? "staff", write: "staff" },
-    indexes: input.indexes ?? [],
-    titleField,
-    displayFields,
-    storage: { mode: "generic", table: GENERIC_ENTITY_TABLE }
-  };
-}
-function defineEntity(key, input, meta = {}) {
-  const declaration = normalizeDeclaration(key, input);
-  entityDeclarationRegistry.register(key, declaration, {
-    title: declaration.title,
-    description: declaration.description,
-    propsSchema: entityRecordSchema(declaration),
-    source: meta.source ?? "app",
-    pluginId: meta.pluginId,
-    since: meta.since
-  });
-  return declaration;
-}
-function formatValidEntities() {
-  const ids = entityDeclarationRegistry.ids().sort();
-  return ids.length ? `Declared entities: ${ids.join(", ")}` : "No entities are declared \u2014 call defineEntity(key, declaration) first.";
-}
-function resolveEntityDeclaration(key) {
-  const declaration = entityDeclarationRegistry.get(key);
-  if (!declaration) throw new Error(`Unknown entity "${key}". ${formatValidEntities()}`);
-  return declaration;
-}
-function hasEntityDeclaration(key) {
-  return entityDeclarationRegistry.has(key);
-}
-function listEntityDeclarations() {
-  return entityDeclarationRegistry.ids().sort();
-}
-function clearEntityDeclarations() {
-  entityDeclarationRegistry.clear();
-}
-var FIELD_FORMAT = {
-  image: "uri",
-  url: "uri",
-  datetime: "date-time"
-};
-function fieldToJsonSchema(name, field) {
-  const node = {
-    title: field.label ?? name,
-    // The control survives the compile, exactly as in block settings: a `ref`
-    // is a string in JSON Schema terms, but an editor rendering it as a text
-    // input (instead of a record picker) is a bug.
-    "x-fayz-control": field.type
-  };
-  if (field.help) node.description = field.help;
-  if (field.default !== void 0) node.default = field.default;
-  const format = FIELD_FORMAT[field.type];
-  if (format) node.format = format;
-  switch (field.type) {
-    case "number":
-      node.type = "number";
-      return node;
-    case "boolean":
-      node.type = "boolean";
-      return node;
-    case "json":
-      return node;
-    case "point":
-      node.type = "object";
-      node.properties = { lat: { type: "number" }, lng: { type: "number" } };
-      node.required = ["lat", "lng"];
-      node.additionalProperties = false;
-      return node;
-    case "ref":
-      node.type = "string";
-      node["x-fayz-ref-entity"] = field.entity;
-      return node;
-    default:
-      node.type = "string";
-      return node;
-  }
-}
-function entityRecordSchema(declaration) {
-  const properties = {};
-  const required = [];
-  for (const [name, field] of Object.entries(declaration.fields)) {
-    properties[name] = fieldToJsonSchema(name, field);
-    if (field.required) required.push(name);
-  }
-  const schema = {
-    type: "object",
-    title: declaration.title,
-    properties,
-    additionalProperties: false
-  };
-  if (declaration.description) schema.description = declaration.description;
-  if (required.length > 0) schema.required = required;
-  return schema;
-}
-function typeOf(value) {
-  return Array.isArray(value) ? "array" : value === null ? "null" : typeof value;
-}
-function validateEntityRecordData(declaration, data) {
-  const issues = [];
-  if (typeof data !== "object" || data === null || Array.isArray(data)) {
-    return [{ path: "", code: "invalid-value", message: `record data is an object, got ${typeOf(data)}` }];
-  }
-  const record = data;
-  const fieldNames = Object.keys(declaration.fields);
-  for (const [name, value] of Object.entries(record)) {
-    const field = declaration.fields[name];
-    if (!field) {
-      issues.push({
-        path: name,
-        code: "unknown-field",
-        message: `field "${name}" is not declared by this entity`,
-        valid: fieldNames
-      });
-      continue;
-    }
-    if (value === null || value === void 0) continue;
-    switch (field.type) {
-      case "number":
-        if (typeof value !== "number" || !Number.isFinite(value)) {
-          issues.push({ path: name, code: "invalid-value", message: `"${name}" expects a number, got ${typeOf(value)}` });
-        }
-        break;
-      case "boolean":
-        if (typeof value !== "boolean") {
-          issues.push({ path: name, code: "invalid-value", message: `"${name}" expects a boolean, got ${typeOf(value)}` });
-        }
-        break;
-      case "json":
-        break;
-      // any JSON value
-      case "point": {
-        const point = value;
-        if (typeOf(value) !== "object" || typeof point.lat !== "number" || typeof point.lng !== "number" || Object.keys(point).length !== 2) {
-          issues.push({ path: name, code: "invalid-value", message: `"${name}" expects {lat: number, lng: number}` });
-        }
-        break;
-      }
-      default:
-        if (typeof value !== "string") {
-          issues.push({ path: name, code: "invalid-value", message: `"${name}" expects a string, got ${typeOf(value)}` });
-        }
-    }
-  }
-  for (const [name, field] of Object.entries(declaration.fields)) {
-    if (field.required && (record[name] === void 0 || record[name] === null || record[name] === "")) {
-      issues.push({ path: name, code: "missing-field", message: `required field "${name}" is missing` });
-    }
-  }
-  return issues;
-}
-function describeEntities() {
-  return entityDeclarationRegistry.describe().map((base) => {
-    const declaration = entityDeclarationRegistry.get(base.id);
-    return {
-      ...base,
-      recordSchema: base.schema,
-      access: declaration.access,
-      scope: declaration.scope,
-      storage: declaration.storage,
-      indexes: declaration.indexes,
-      titleField: declaration.titleField,
-      displayFields: declaration.displayFields
-    };
-  });
-}
-var FIELD_TYPE_TO_INPUT = {
-  text: "text",
-  richtext: "markdown",
-  number: "number",
-  boolean: "boolean",
-  // JSON and point have no dedicated control yet; they degrade to text inputs
-  // with a hint, which is honest — the descriptor still names the real type in
-  // the record schema, so a richer control can adopt them without a migration.
-  json: "textarea",
-  point: "text",
-  image: "image",
-  url: "url",
-  ref: "relation",
-  datetime: "datetime"
-};
-function entityAdminForm(declaration) {
-  const fields = Object.entries(declaration.fields).map(([name, field]) => {
-    const def = {
-      key: name,
-      label: field.label ?? name,
-      type: FIELD_TYPE_TO_INPUT[field.type],
-      showInForm: true,
-      showInTable: declaration.displayFields.includes(name)
-    };
-    if (field.required) def.required = true;
-    if (field.help) def.hint = field.help;
-    if (field.default !== void 0) def.defaultValue = field.default;
-    if (field.type === "json") def.hint = field.help ?? "JSON value";
-    if (field.type === "point") def.hint = field.help ?? "lat,lng";
-    if (field.type === "ref" && field.entity) {
-      def.relation = {
-        table: declaration.storage.table,
-        valueField: "id",
-        labelField: "slug",
-        filter: { entity: field.entity }
-      };
-    }
-    return def;
-  });
-  return { entity: declaration.key, title: declaration.title, fields };
-}
-var SIDECAR_REFERENCES = ["product", "category"];
-var sidecarDeclarationRegistry = new Registry("sidecar");
-function defineSidecarFields(reference, fields, meta = {}) {
-  if (!SIDECAR_REFERENCES.includes(reference)) {
-    fail(`defineSidecarFields: "${reference}" is not a sidecar reference.`, SIDECAR_REFERENCES);
-  }
-  for (const [name, field] of Object.entries(fields)) {
-    if (!FIELD_NAME_RE.test(name)) {
-      fail(`defineSidecarFields("${reference}"): "${name}" is not a valid field name (${FIELD_NAME_RE}).`);
-    }
-    if (!ENTITY_FIELD_TYPES.includes(field?.type)) {
-      fail(`defineSidecarFields("${reference}"): field "${name}" has unknown type "${String(field?.type)}".`, ENTITY_FIELD_TYPES);
-    }
-  }
-  const declaration = { reference, fields };
-  sidecarDeclarationRegistry.register(reference, declaration, {
-    title: `Custom fields: ${reference}`,
-    propsSchema: entityRecordSchema({ title: `${reference} custom fields`, fields }),
-    source: meta.source ?? "app",
-    pluginId: meta.pluginId
-  });
-  return declaration;
-}
-function resolveSidecarDeclaration(reference) {
-  const declaration = sidecarDeclarationRegistry.get(reference);
-  if (!declaration) {
-    const declared = sidecarDeclarationRegistry.ids().sort();
-    throw new Error(
-      `No sidecar fields are declared for "${reference}". ${declared.length ? `Declared references: ${declared.join(", ")}` : "Call defineSidecarFields(reference, fields) first."}`
-    );
-  }
-  return declaration;
-}
-function hasSidecarDeclaration(reference) {
-  return sidecarDeclarationRegistry.has(reference);
-}
-function clearSidecarDeclarations() {
-  sidecarDeclarationRegistry.clear();
-}
-
 // src/registry/block-constraints.ts
 function metaFor(type) {
   return blockRegistry.getEntry(type)?.meta;
@@ -751,7 +391,7 @@ function repairBlockTree(nodes) {
 }
 
 // src/registry/schema-check.ts
-function typeOf2(value) {
+function typeOf(value) {
   if (value === null) return "null";
   if (Array.isArray(value)) return "array";
   if (typeof value === "number") return Number.isInteger(value) ? "integer" : "number";
@@ -768,7 +408,7 @@ function checkAgainstSchema(schema, value, path = "") {
   const issues = [];
   const declaredType = schema.type;
   if (declaredType !== void 0) {
-    const actual = typeOf2(value);
+    const actual = typeOf(value);
     const accepted = Array.isArray(declaredType) ? declaredType.map(String) : [String(declaredType)];
     if (!accepted.some((t) => typeMatches(t, actual))) {
       issues.push({ path, message: `expected ${accepted.join(" | ")}, got ${actual}` });
@@ -1538,7 +1178,22 @@ function resolvePluginRuntime({
     const order = { main: 0, secondary: 1, settings: 2 };
     return (order[a.section] ?? 99) - (order[b.section] ?? 99) || a.position - b.position;
   });
-  settingsTabs.sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
+  {
+    const groupAnchor = /* @__PURE__ */ new Map();
+    for (const tab of settingsTabs) {
+      if (!tab.group) continue;
+      const order = tab.order ?? 0;
+      const current = groupAnchor.get(tab.group);
+      if (current === void 0 || order < current) groupAnchor.set(tab.group, order);
+    }
+    settingsTabs.sort((a, b) => {
+      const anchorA = a.group ? groupAnchor.get(a.group) : a.order ?? 0;
+      const anchorB = b.group ? groupAnchor.get(b.group) : b.order ?? 0;
+      if (anchorA !== anchorB) return anchorA - anchorB;
+      if ((a.group ?? "") !== (b.group ?? "")) return (a.group ?? "").localeCompare(b.group ?? "");
+      return (a.order ?? 0) - (b.order ?? 0);
+    });
+  }
   widgets.sort((a, b) => a.zone !== b.zone ? a.zone.localeCompare(b.zone) : a.order - b.order);
   dashboardWidgets.sort((a, b) => a.order - b.order);
   analyticsCards.sort((a, b) => a.order - b.order);
@@ -1587,6 +1242,6 @@ function useConnectorsForPlugin(hostPluginId) {
   return usePluginRuntime().connectorsByHost.get(hostPluginId) ?? [];
 }
 
-export { BLOCK_SETTING_TYPES, ENTITY_FIELD_TYPES, GENERIC_ENTITY_TABLE, PLUGIN_API_VERSION, PluginRuntimeProvider, RESERVED_ENTITY_FIELDS, Registry, SIDECAR_REFERENCES, auditBlocks, blockRegistry, buildEntityDomainEvents, checkAgainstSchema, checkBlockConstraints, checkBlockContext, checkNodePlacement, clearEntityDeclarations, clearExtensionPoints, clearHandles, clearLoaders, clearSidecarDeclarations, componentRegistry, dataNeedKey, defaultPropsFromSettings, defineBlock, defineEntity, defineExtensionPoint, defineLoader, definePlugin, defineSidecarFields, describeBlock, describeBlocks, describeEntities, describeExtensionPoints, describeLoaders, entityAdminForm, entityDeclarationRegistry, entityEventKey, entityRecordSchema, extensionAfterHooks, extensionPointRegistry, formatSchemaIssues, getAnalyticsCards, getBlock, getBlockMeta, getComponent, getDashboardWidgets, getHandle, getMetric, getPage, getPlugin, getPluginFactory, getScaffold, getWidgetsForZone, handleNameFor, handleRegistry, hasEntityDeclaration, hasExtensionPoint, hasHandle, hasLoader, hasSidecarDeclaration, isBlockEnabledOn, isCustomId, isLoaderParamRef, isLoaderPropRef, listBlocks, listEntityDeclarations, listExtensionHandlers, listExtensionPoints, listHandles, listLoaders, listMetrics, listPluginFactories, listPlugins, loaderRegistry, metricRegistry, pageRegistry, pluginFactoryRegistry, pluginRegistry, registerBlock, registerComponent, registerExtensionHandler, registerHandle, registerMetric, registerPage, registerPlugin, registerPluginFactory, registerScaffold, repairBlockTree, resolveEntityDeclaration, resolveHandle, resolveLoader, resolvePluginComponent, resolvePluginRuntime, resolveSidecarDeclaration, runEscapeValve, runExtensionPoint, scaffoldRegistry, settingsToJsonSchema, sidecarDeclarationRegistry, summarizeBlockAudit, unregisterExtensionHandler, useConnectorsForPlugin, usePluginRuntime, usePluginRuntimeOptional, validateEntityRecordData };
-//# sourceMappingURL=chunk-732GZEUI.js.map
-//# sourceMappingURL=chunk-732GZEUI.js.map
+export { BLOCK_SETTING_TYPES, PLUGIN_API_VERSION, PluginRuntimeProvider, auditBlocks, blockRegistry, buildEntityDomainEvents, checkAgainstSchema, checkBlockConstraints, checkBlockContext, checkNodePlacement, clearExtensionPoints, clearHandles, clearLoaders, componentRegistry, dataNeedKey, defaultPropsFromSettings, defineBlock, defineExtensionPoint, defineLoader, definePlugin, describeBlock, describeBlocks, describeExtensionPoints, describeLoaders, entityEventKey, extensionAfterHooks, extensionPointRegistry, formatSchemaIssues, getAnalyticsCards, getBlock, getBlockMeta, getComponent, getDashboardWidgets, getHandle, getMetric, getPage, getPlugin, getPluginFactory, getScaffold, getWidgetsForZone, handleNameFor, handleRegistry, hasExtensionPoint, hasHandle, hasLoader, isBlockEnabledOn, isLoaderParamRef, isLoaderPropRef, listBlocks, listExtensionHandlers, listExtensionPoints, listHandles, listLoaders, listMetrics, listPluginFactories, listPlugins, loaderRegistry, metricRegistry, pageRegistry, pluginFactoryRegistry, pluginRegistry, registerBlock, registerComponent, registerExtensionHandler, registerHandle, registerMetric, registerPage, registerPlugin, registerPluginFactory, registerScaffold, repairBlockTree, resolveHandle, resolveLoader, resolvePluginComponent, resolvePluginRuntime, runEscapeValve, runExtensionPoint, scaffoldRegistry, settingsToJsonSchema, summarizeBlockAudit, unregisterExtensionHandler, useConnectorsForPlugin, usePluginRuntime, usePluginRuntimeOptional };
+//# sourceMappingURL=chunk-RRYFXUQX.js.map
+//# sourceMappingURL=chunk-RRYFXUQX.js.map