flowdular 0.3.2 → 0.4.0

package/dist/distribution.js

@@ -2478,6 +2478,17 @@ var module_spec_schema_default = {
       type: "array",
       items: { $ref: "#/$defs/decision" },
       uniqueItems: true
+    },
+    research: { $ref: "#/$defs/research" },
+    adapters: {
+      type: "array",
+      items: { $ref: "#/$defs/adapter" },
+      uniqueItems: true
+    },
+    templates: {
+      type: "array",
+      items: { $ref: "#/$defs/template" },
+      uniqueItems: true
     }
   },
   allOf: [
@@ -2495,7 +2506,10 @@ var module_spec_schema_default = {
           settings: false,
           agentTools: false,
           outOfScope: false,
-          decisions: false
+          decisions: false,
+          research: false,
+          adapters: false,
+          templates: false
         }
       }
     }
@@ -2701,6 +2715,113 @@ var module_spec_schema_default = {
         answer: { type: "string", minLength: 1 },
         decidedBy: { enum: ["user", "default"] }
       }
+    },
+    domain: {
+      type: "string",
+      maxLength: 253,
+      pattern: "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$"
+    },
+    research: {
+      type: "object",
+      additionalProperties: false,
+      required: ["adapter", "evidenceOwner"],
+      properties: {
+        adapter: {
+          enum: [
+            "model-native",
+            "searxng",
+            "firecrawl",
+            "connector",
+            "recorded"
+          ]
+        },
+        allowDomains: {
+          type: "array",
+          items: { $ref: "#/$defs/domain" },
+          uniqueItems: true
+        },
+        denyDomains: {
+          type: "array",
+          items: { $ref: "#/$defs/domain" },
+          uniqueItems: true
+        },
+        monthlyQueryBudget: { type: "integer", minimum: 1 },
+        evidenceOwner: { $ref: "#/$defs/entityId" }
+      }
+    },
+    adapter: {
+      type: "object",
+      additionalProperties: false,
+      required: [
+        "id",
+        "direction",
+        "connector",
+        "operation",
+        "port",
+        "mapping"
+      ],
+      properties: {
+        id: {
+          type: "string",
+          pattern: "^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+$"
+        },
+        direction: { enum: ["source", "sink"] },
+        connector: { type: "string", pattern: "^[a-z][a-z0-9-]{0,95}$" },
+        operation: { type: "string", pattern: "^[a-z][a-z0-9-]{0,63}$" },
+        port: {
+          type: "string",
+          maxLength: 96,
+          pattern: "^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+$"
+        },
+        schedule: {
+          anyOf: [
+            { type: "null" },
+            {
+              type: "string",
+              maxLength: 100,
+              pattern: "^[0-9a-z*,/-]+( [0-9a-z*,/-]+){4}$"
+            }
+          ]
+        },
+        mapping: {
+          type: "array",
+          minItems: 1,
+          items: { $ref: "#/$defs/adapterMapping" },
+          uniqueItems: true
+        },
+        recorded: {
+          type: "string",
+          pattern: "^adapters/[a-z0-9][a-z0-9-]*\\.recorded\\.json$"
+        }
+      }
+    },
+    adapterMapping: {
+      type: "object",
+      additionalProperties: false,
+      required: ["to", "transform"],
+      properties: {
+        from: { type: "string", minLength: 1 },
+        to: { type: "string", minLength: 1 },
+        transform: { enum: ["rename", "constant", "format", "lookup"] },
+        value: {
+          anyOf: [{ type: "null" }, { type: "string", minLength: 1 }]
+        }
+      }
+    },
+    template: {
+      type: "object",
+      additionalProperties: false,
+      required: ["id", "title", "inputEntity", "format", "body"],
+      properties: {
+        id: { $ref: "#/$defs/entityId" },
+        title: { type: "string", minLength: 1 },
+        inputEntity: { $ref: "#/$defs/entityId" },
+        format: { enum: ["pdf", "docx"] },
+        body: {
+          type: "string",
+          pattern: "^templates/[a-z][a-z0-9-]*\\.md$"
+        }
+      }
     }
   }
 };
@@ -2867,6 +2988,15 @@ var project_schema_default = {
                     $ref: "#/$defs/githubAccount"
                   },
                   uniqueItems: true
+                },
+                labels: {
+                  type: "array",
+                  maxItems: 10,
+                  items: {
+                    type: "string",
+                    pattern: "^[A-Za-z0-9][A-Za-z0-9 ._:-]{0,49}$"
+                  },
+                  uniqueItems: true
                 }
               }
             },
@@ -3114,8 +3244,79 @@ var projectSchema = project_schema_default;
 var moduleCatalogSchema = module_catalog_schema_default;
 var moduleArtifactSchema = module_artifact_schema_default;
 
+// ../contracts/src/translations.ts
+var PLURAL_CATEGORIES = [
+  "zero",
+  "one",
+  "two",
+  "few",
+  "many",
+  "other"
+];
+var WHOLE_NUMBER_SAMPLES = [
+  ...Array.from({ length: 200 }, (_, index) => index),
+  1e3,
+  1e4,
+  1e5,
+  1e6,
+  1e7,
+  1e8,
+  1e9
+];
+function requiredPluralCategories(locale) {
+  const rules = new Intl.PluralRules(locale);
+  const selected = /* @__PURE__ */ new Set(["other"]);
+  for (const sample of WHOLE_NUMBER_SAMPLES) selected.add(rules.select(sample));
+  return PLURAL_CATEGORIES.filter((category) => selected.has(category));
+}
+function pluralMember(bundle, key) {
+  const dot = key.lastIndexOf(".");
+  if (dot <= 0) return null;
+  const category = key.slice(dot + 1);
+  if (!PLURAL_CATEGORIES.includes(category)) return null;
+  const base = key.slice(0, dot);
+  return Object.hasOwn(bundle, base + ".other") ? { base, category } : null;
+}
+function translationKeys(bundle) {
+  const keys = /* @__PURE__ */ new Set();
+  for (const key of Object.keys(bundle)) {
+    keys.add(pluralMember(bundle, key)?.base ?? key);
+  }
+  return [...keys].sort();
+}
+function pluralFamilyIssues(bundle, locale) {
+  const families = /* @__PURE__ */ new Map();
+  for (const key of Object.keys(bundle)) {
+    const member = pluralMember(bundle, key);
+    if (member === null) continue;
+    const categories = families.get(member.base) ?? /* @__PURE__ */ new Set();
+    categories.add(member.category);
+    families.set(member.base, categories);
+  }
+  const required = requiredPluralCategories(locale);
+  const known = new Intl.PluralRules(
+    locale
+  ).resolvedOptions().pluralCategories;
+  const issues = [];
+  for (const base of [...families.keys()].sort()) {
+    const categories = families.get(base);
+    const missing = required.filter((category) => !categories.has(category));
+    if (missing.length > 0) {
+      issues.push(
+        `${base} lacks ${missing.map((category) => base + "." + category).join(", ")} for ${locale}`
+      );
+    }
+    for (const category of categories) {
+      if (!known.includes(category)) {
+        issues.push(`${base}.${category} is never selected for ${locale}`);
+      }
+    }
+  }
+  return issues;
+}
+
 // ../contracts/src/index.ts
-var PLATFORM_API_VERSION = "0.1.9";
+var PLATFORM_API_VERSION = "0.1.21";
 
 // ../kernel/src/module-compatibility.ts
 function satisfiesModuleVersion(version, range) {
@@ -3298,6 +3499,10 @@ var validators = {
   cliExtension: ajv.compile(cliExtensionSchema),
   platformSpec: ajv.compile(platformSpecSchema)
 };
+var MONTH_NAMES = "jan feb mar apr may jun jul aug sep oct nov dec".split(
+  " "
+);
+var WEEKDAY_NAMES = "sun mon tue wed thu fri sat".split(" ");
 var SKIPPED_DIRECTORIES = /* @__PURE__ */ new Set([
   ".git",
   ".flowdular",
@@ -3796,7 +4001,7 @@ import { dirname as dirname6, join as join6, relative as relative5 } from "node:
 import { createRequire } from "node:module";
 import { readFile as readFile5 } from "node:fs/promises";
 import { dirname as dirname4, join as join3 } from "node:path";
-var SDK_VERSION = "0.3.2";
+var SDK_VERSION = "0.4.0";
 function npmPackage(specifier) {
   return specifier.startsWith("@") ? specifier.split("/").slice(0, 2).join("/") : specifier.split("/")[0];
 }
@@ -3900,6 +4105,115 @@ async function findModuleFiles(workspace) {
 import { access as access2, readFile as readFile7, readdir as readdir3 } from "node:fs/promises";
 import { dirname as dirname5, join as join5, relative as relative4 } from "node:path";
 import { parse as parseYaml3 } from "yaml";
+
+// src/dom-properties.ts
+var DOM_PROPERTY_SPELLINGS = [
+  "acceptCharset",
+  "allowFullScreen",
+  "autoCapitalize",
+  "autoComplete",
+  "autoCorrect",
+  "autoFocus",
+  "autoPlay",
+  "charSet",
+  "contentEditable",
+  "crossOrigin",
+  "defaultChecked",
+  "defaultValue",
+  "disablePictureInPicture",
+  "disableRemotePlayback",
+  "encType",
+  "fetchPriority",
+  "formAction",
+  "formEncType",
+  "formMethod",
+  "formNoValidate",
+  "formTarget",
+  "httpEquiv",
+  "imageSizes",
+  "imageSrcSet",
+  "inputMode",
+  "itemID",
+  "itemProp",
+  "itemRef",
+  "itemScope",
+  "itemType",
+  "maxLength",
+  "noModule",
+  "noValidate",
+  "playsInline",
+  "readOnly",
+  "referrerPolicy",
+  "spellCheck",
+  "srcDoc",
+  "srcLang",
+  "srcSet",
+  "tabIndex",
+  "viewBox"
+];
+var SPELLINGS = new Map(
+  DOM_PROPERTY_SPELLINGS.map((name) => [name.toLowerCase(), name])
+);
+function hostTagAttributes(source) {
+  const tags = [];
+  for (const match of source.matchAll(/<[a-z][a-z0-9-]*/g)) {
+    const start = match.index + match[0].length;
+    let depth = 0;
+    let quote = "";
+    let text = "";
+    let end = start;
+    for (; end < source.length; end += 1) {
+      const character = source[end];
+      if (quote !== "") {
+        if (character === quote) quote = "";
+        text += " ";
+        continue;
+      }
+      if (depth > 0) {
+        if (character === "{") depth += 1;
+        else if (character === "}") depth -= 1;
+        text += depth === 0 ? character : " ";
+        continue;
+      }
+      if (character === "{") {
+        depth = 1;
+        text += character;
+        continue;
+      }
+      if (character === '"' || character === "'") {
+        quote = character;
+        text += character;
+        continue;
+      }
+      if (character === ">") break;
+      text += character;
+    }
+    tags.push({ start, text });
+  }
+  return tags;
+}
+function domPropertyMisspellings(source) {
+  const found = [];
+  for (const tag of hostTagAttributes(source)) {
+    for (const attribute of tag.text.matchAll(
+      /(?<=\s)([A-Za-z][A-Za-z-]*)=/g
+    )) {
+      const name = attribute[1];
+      const expected = SPELLINGS.get(name.toLowerCase());
+      if (expected === void 0 || expected === name) continue;
+      const index = tag.start + attribute.index;
+      found.push({
+        name,
+        expected,
+        index,
+        line: source.slice(0, index).split("\n").length
+      });
+    }
+  }
+  return found.sort((left, right) => left.index - right.index);
+}
+
+// src/module-validate.ts
 function issue(code, message, path, severity = "error") {
   return { code, message, path, severity };
 }
@@ -4088,6 +4402,7 @@ async function translationIssues(moduleRoot, manifest, projectLocales) {
   }
   if (!manifest.capabilities.includes("translations")) return issues;
   const keySets = /* @__PURE__ */ new Map();
+  const referenceBundleKeys = /* @__PURE__ */ new Set();
   for (const locale of manifest.locales) {
     const path = `translations/${locale}.json`;
     if (!await exists(join5(moduleRoot, path))) {
@@ -4105,7 +4420,21 @@ async function translationIssues(moduleRoot, manifest, projectLocales) {
       if (!bundle || typeof bundle !== "object" || Array.isArray(bundle)) {
         throw new Error("Expected a JSON object.");
       }
-      keySets.set(locale, Object.keys(bundle).sort());
+      const strings = bundle;
+      keySets.set(locale, translationKeys(strings));
+      if (keySets.size === 1) {
+        for (const key of Object.keys(strings)) referenceBundleKeys.add(key);
+      }
+      const plurals = pluralFamilyIssues(strings, locale);
+      if (plurals.length > 0) {
+        issues.push(
+          issue(
+            "TRANSLATION_PLURAL_INCOMPLETE",
+            `${path} plural families do not match the ${locale} plural rules: ${plurals.join("; ")}.`,
+            path
+          )
+        );
+      }
     } catch (error) {
       issues.push(
         issue(
@@ -4134,7 +4463,7 @@ async function translationIssues(moduleRoot, manifest, projectLocales) {
       )
     );
   }
-  const referenceKeys = new Set(reference[1]);
+  const referenceKeys = /* @__PURE__ */ new Set([...reference[1], ...referenceBundleKeys]);
   const files = await clientSourceFiles(moduleRoot);
   if (files.length > 0) {
     const namespace = manifest.id.split(".")[0] ?? manifest.id;
@@ -4166,6 +4495,21 @@ async function translationIssues(moduleRoot, manifest, projectLocales) {
   }
   return issues;
 }
+function filtersTags(source) {
+  const tags = [];
+  for (const match of source.matchAll(/<Filters\b/g)) {
+    let depth = 0;
+    let end = match.index + match[0].length;
+    for (; end < source.length; end += 1) {
+      const character = source[end];
+      if (character === "{") depth += 1;
+      else if (character === "}") depth -= 1;
+      else if (character === ">" && depth === 0) break;
+    }
+    tags.push(source.slice(match.index, end));
+  }
+  return tags;
+}
 async function userInterfaceIssues(moduleRoot) {
   const issues = [];
   for (const file of await clientSourceFiles(moduleRoot)) {
@@ -4189,6 +4533,27 @@ async function userInterfaceIssues(moduleRoot) {
         )
       );
     }
+    const misspelled = domPropertyMisspellings(source);
+    if (misspelled.length > 0) {
+      issues.push(
+        issue(
+          "DOM_PROPERTY_CASING",
+          "Host elements use Octane's DOM property spelling: " + misspelled.map(
+            (found) => `line ${found.line} ${found.name} as ${found.expected}`
+          ).join(", ") + ".",
+          path
+        )
+      );
+    }
+    if (filtersTags(source).some((tag) => !/\slabel=/.test(tag))) {
+      issues.push(
+        issue(
+          "FILTERS_LABEL_MISSING",
+          'Filters from @flowdular/ui needs a translated label; without one it shows the English word "Filters" in every locale.',
+          path
+        )
+      );
+    }
   }
   return issues;
 }

package/dist/index.js

@@ -2650,6 +2650,17 @@ var module_spec_schema_default = {
       type: "array",
       items: { $ref: "#/$defs/decision" },
       uniqueItems: true
+    },
+    research: { $ref: "#/$defs/research" },
+    adapters: {
+      type: "array",
+      items: { $ref: "#/$defs/adapter" },
+      uniqueItems: true
+    },
+    templates: {
+      type: "array",
+      items: { $ref: "#/$defs/template" },
+      uniqueItems: true
     }
   },
   allOf: [
@@ -2667,7 +2678,10 @@ var module_spec_schema_default = {
           settings: false,
           agentTools: false,
           outOfScope: false,
-          decisions: false
+          decisions: false,
+          research: false,
+          adapters: false,
+          templates: false
         }
       }
     }
@@ -2873,6 +2887,113 @@ var module_spec_schema_default = {
         answer: { type: "string", minLength: 1 },
         decidedBy: { enum: ["user", "default"] }
       }
+    },
+    domain: {
+      type: "string",
+      maxLength: 253,
+      pattern: "^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)+$"
+    },
+    research: {
+      type: "object",
+      additionalProperties: false,
+      required: ["adapter", "evidenceOwner"],
+      properties: {
+        adapter: {
+          enum: [
+            "model-native",
+            "searxng",
+            "firecrawl",
+            "connector",
+            "recorded"
+          ]
+        },
+        allowDomains: {
+          type: "array",
+          items: { $ref: "#/$defs/domain" },
+          uniqueItems: true
+        },
+        denyDomains: {
+          type: "array",
+          items: { $ref: "#/$defs/domain" },
+          uniqueItems: true
+        },
+        monthlyQueryBudget: { type: "integer", minimum: 1 },
+        evidenceOwner: { $ref: "#/$defs/entityId" }
+      }
+    },
+    adapter: {
+      type: "object",
+      additionalProperties: false,
+      required: [
+        "id",
+        "direction",
+        "connector",
+        "operation",
+        "port",
+        "mapping"
+      ],
+      properties: {
+        id: {
+          type: "string",
+          pattern: "^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+$"
+        },
+        direction: { enum: ["source", "sink"] },
+        connector: { type: "string", pattern: "^[a-z][a-z0-9-]{0,95}$" },
+        operation: { type: "string", pattern: "^[a-z][a-z0-9-]{0,63}$" },
+        port: {
+          type: "string",
+          maxLength: 96,
+          pattern: "^[a-z][a-z0-9-]*(\\.[a-z][a-z0-9-]*)+$"
+        },
+        schedule: {
+          anyOf: [
+            { type: "null" },
+            {
+              type: "string",
+              maxLength: 100,
+              pattern: "^[0-9a-z*,/-]+( [0-9a-z*,/-]+){4}$"
+            }
+          ]
+        },
+        mapping: {
+          type: "array",
+          minItems: 1,
+          items: { $ref: "#/$defs/adapterMapping" },
+          uniqueItems: true
+        },
+        recorded: {
+          type: "string",
+          pattern: "^adapters/[a-z0-9][a-z0-9-]*\\.recorded\\.json$"
+        }
+      }
+    },
+    adapterMapping: {
+      type: "object",
+      additionalProperties: false,
+      required: ["to", "transform"],
+      properties: {
+        from: { type: "string", minLength: 1 },
+        to: { type: "string", minLength: 1 },
+        transform: { enum: ["rename", "constant", "format", "lookup"] },
+        value: {
+          anyOf: [{ type: "null" }, { type: "string", minLength: 1 }]
+        }
+      }
+    },
+    template: {
+      type: "object",
+      additionalProperties: false,
+      required: ["id", "title", "inputEntity", "format", "body"],
+      properties: {
+        id: { $ref: "#/$defs/entityId" },
+        title: { type: "string", minLength: 1 },
+        inputEntity: { $ref: "#/$defs/entityId" },
+        format: { enum: ["pdf", "docx"] },
+        body: {
+          type: "string",
+          pattern: "^templates/[a-z][a-z0-9-]*\\.md$"
+        }
+      }
     }
   }
 };
@@ -3039,6 +3160,15 @@ var project_schema_default = {
                     $ref: "#/$defs/githubAccount"
                   },
                   uniqueItems: true
+                },
+                labels: {
+                  type: "array",
+                  maxItems: 10,
+                  items: {
+                    type: "string",
+                    pattern: "^[A-Za-z0-9][A-Za-z0-9 ._:-]{0,49}$"
+                  },
+                  uniqueItems: true
                 }
               }
             },
@@ -3286,8 +3416,79 @@ var projectSchema = project_schema_default;
 var moduleCatalogSchema = module_catalog_schema_default;
 var moduleArtifactSchema = module_artifact_schema_default;
 
+// ../contracts/src/translations.ts
+var PLURAL_CATEGORIES = [
+  "zero",
+  "one",
+  "two",
+  "few",
+  "many",
+  "other"
+];
+var WHOLE_NUMBER_SAMPLES = [
+  ...Array.from({ length: 200 }, (_, index) => index),
+  1e3,
+  1e4,
+  1e5,
+  1e6,
+  1e7,
+  1e8,
+  1e9
+];
+function requiredPluralCategories(locale) {
+  const rules = new Intl.PluralRules(locale);
+  const selected = /* @__PURE__ */ new Set(["other"]);
+  for (const sample of WHOLE_NUMBER_SAMPLES) selected.add(rules.select(sample));
+  return PLURAL_CATEGORIES.filter((category) => selected.has(category));
+}
+function pluralMember(bundle, key) {
+  const dot = key.lastIndexOf(".");
+  if (dot <= 0) return null;
+  const category = key.slice(dot + 1);
+  if (!PLURAL_CATEGORIES.includes(category)) return null;
+  const base = key.slice(0, dot);
+  return Object.hasOwn(bundle, base + ".other") ? { base, category } : null;
+}
+function translationKeys(bundle) {
+  const keys = /* @__PURE__ */ new Set();
+  for (const key of Object.keys(bundle)) {
+    keys.add(pluralMember(bundle, key)?.base ?? key);
+  }
+  return [...keys].sort();
+}
+function pluralFamilyIssues(bundle, locale) {
+  const families = /* @__PURE__ */ new Map();
+  for (const key of Object.keys(bundle)) {
+    const member = pluralMember(bundle, key);
+    if (member === null) continue;
+    const categories = families.get(member.base) ?? /* @__PURE__ */ new Set();
+    categories.add(member.category);
+    families.set(member.base, categories);
+  }
+  const required = requiredPluralCategories(locale);
+  const known = new Intl.PluralRules(
+    locale
+  ).resolvedOptions().pluralCategories;
+  const issues = [];
+  for (const base of [...families.keys()].sort()) {
+    const categories = families.get(base);
+    const missing = required.filter((category) => !categories.has(category));
+    if (missing.length > 0) {
+      issues.push(
+        `${base} lacks ${missing.map((category) => base + "." + category).join(", ")} for ${locale}`
+      );
+    }
+    for (const category of categories) {
+      if (!known.includes(category)) {
+        issues.push(`${base}.${category} is never selected for ${locale}`);
+      }
+    }
+  }
+  return issues;
+}
+
 // ../contracts/src/index.ts
-var PLATFORM_API_VERSION = "0.1.9";
+var PLATFORM_API_VERSION = "0.1.21";
 
 // src/module-templates.ts
 function packageSuffix(id) {
@@ -3687,6 +3888,7 @@ function packageJson(model) {
       "migrations",
       "translations",
       "spec",
+      ...spec.templates?.length ? ["templates"] : [],
       "README.md"
     ],
     scripts: {
@@ -4530,34 +4732,76 @@ export function create${names.pascal}ClientState() {
 }
 `;
 }
-function columnWidth(index, count) {
-  if (count < 2) return "100%";
-  const rest = Math.max(1, Math.floor(35 / (count - 1)));
-  return index === 0 ? `${Math.max(1, 100 - rest * (count - 1))}%` : `${rest}%`;
-}
-function cellValue(field, namespace) {
+function scaffoldCell(field, namespace, index) {
   const access7 = `record.${field.id}`;
-  if (field.type === "enum") {
-    const label2 = `t('${namespace}.${field.id}.' + ${access7})`;
-    return field.required ? label2 : `${access7} === null ? '' : ${label2}`;
-  }
-  if (field.type === "json") return `JSON.stringify(${access7})`;
-  if (field.type === "integer" || field.type === "boolean") {
-    return field.required ? `String(${access7})` : `${access7} === null ? '' : String(${access7})`;
+  const identity = index === 0;
+  const priority = identity || field.state ? 1 : 2;
+  const cell = (component, props, width, fieldPriority = priority, numeric = false) => ({
+    component,
+    markup: `<${component} ${props} />`,
+    width: identity ? "auto" : width,
+    priority: identity ? 1 : fieldPriority,
+    numeric
+  });
+  switch (field.type) {
+    case "enum":
+      return cell(
+        "CellTag",
+        `label={t('${namespace}.${field.id}.' + ${access7})}` + (field.state ? " dot" : ""),
+        "140px"
+      );
+    case "integer":
+    case "decimal":
+      return cell("CellNumber", `value={${access7}}`, "120px", priority, true);
+    case "boolean":
+      return cell("CellText", `value={String(${access7})}`, "100px");
+    case "date":
+      return cell("CellTime", `value={${access7}} kind="date"`, "140px");
+    case "datetime":
+      return cell("CellTime", `value={${access7}}`, "170px");
+    case "reference":
+      return cell("CellCode", `value={${access7}}`, "160px", 3);
+    case "json":
+      return cell(
+        "CellText",
+        `value={JSON.stringify(${access7})} mono`,
+        "200px",
+        3
+      );
+    case "text":
+      return cell("CellText", `value={${access7}} wrap muted`, "240px", 3);
+    default:
+      return cell(
+        "CellText",
+        `value={${access7}}` + (identity ? " strong" : ""),
+        "200px"
+      );
   }
-  return field.required ? access7 : `${access7} ?? ''`;
+}
+function scaffoldCells(model) {
+  return model.columns.map(
+    (field, index) => scaffoldCell(field, model.names.namespace, index)
+  );
+}
+function cellImports(model) {
+  const names = new Set(scaffoldCells(model).map((cell) => cell.component));
+  if (model.columns.some((field) => !field.required)) names.add("CellMuted");
+  return [...names].sort();
 }
 function tableColumns(model) {
   const { columns, names } = model;
+  const cells = scaffoldCells(model);
   return columns.map((field, index) => {
-    const value = cellValue(field, names.namespace);
-    const cell = index === 0 ? `<b>{${value}}</b>` : value;
-    const numeric = field.type === "integer" || field.type === "decimal" ? "			numeric: true,\n" : "";
+    const cell = cells[index];
+    const markup = field.required ? cell.markup : `record.${field.id} === null
+				? <CellMuted>{t('${names.namespace}.value.none')}</CellMuted>
+				: ${cell.markup}`;
     return `		{
 			key: '${field.id}',
 			header: t('${names.namespace}.table.column.${field.id}'),
-			width: '${columnWidth(index, columns.length)}',
-${numeric}			cell: (record) => ${cell},
+			width: '${cell.width}',
+${cell.priority > 1 ? `			priority: ${cell.priority},
+` : ""}${cell.numeric ? "			numeric: true,\n" : ""}			cell: (record) => ${markup},
 		},
 `;
   }).join("");
@@ -4592,7 +4836,8 @@ import { t } from '@flowdular/client';
 import {
 	Alert,
 	Button,
-	Icon,
+${cellImports(model).map((name) => `	${name},
+`).join("")}	Icon,
 	PageHeader,
 	TableCard,
 	type TableColumn,
@@ -4880,6 +5125,74 @@ export default defineCliExtension({
 });
 `;
 }
+function tsLiteral(value, depth) {
+  if (typeof value === "string") return stringLiteral(value);
+  if (value === null || typeof value !== "object") return String(value);
+  const list = Array.isArray(value);
+  const entries = list ? value.map((item) => tsLiteral(item, depth + 1)) : Object.entries(value).map(
+    ([key, item]) => `${key}: ${tsLiteral(item, depth + 1)}`
+  );
+  if (entries.length === 0) return list ? "[]" : "{}";
+  const indent = "	".repeat(depth + 1);
+  return `${list ? "[" : "{"}
+${entries.map((entry) => `${indent}${entry},
+`).join("")}${"	".repeat(depth)}${list ? "]" : "}"}`;
+}
+function researchFile(model, research) {
+  return `import type { ModuleSpecResearch } from '@flowdular/contracts';
+
+export const RESEARCH_CAPABILITIES = {
+	search: 'research.search.v1',
+	fetch: 'research.fetch.v1',
+	evidence: 'research.evidence.v1',
+} as const;
+
+export const ${model.names.constant}_RESEARCH = ${tsLiteral(research, 0)} as const satisfies ModuleSpecResearch;
+`;
+}
+function researchFixtures(research) {
+  const host = research.allowDomains?.[0] ?? "example.com";
+  const url = `https://${host}/example`;
+  return json({
+    queries: {
+      example: [
+        {
+          url,
+          title: "Example result",
+          snippet: "Replace with a recorded search result.",
+          source: host
+        }
+      ]
+    },
+    pages: {
+      [url]: {
+        title: "Example result",
+        text: "Replace with the text of the recorded page."
+      }
+    }
+  });
+}
+function recordedFixture(adapter) {
+  return json({
+    adapter: adapter.id,
+    operation: adapter.operation,
+    calls: [{ input: {}, body: {} }]
+  });
+}
+function adapterFile(name, adapter) {
+  const constant = name.replace(/-/g, "_").toUpperCase();
+  return `import type { ModuleSpecAdapter } from '@flowdular/contracts';
+
+export const ${constant}_ADAPTER = ${tsLiteral(adapter, 0)} as const satisfies ModuleSpecAdapter;
+`;
+}
+function templateBody(spec, template) {
+  const fields = (spec.entities ?? []).find((entity) => entity.id === template.inputEntity)?.fields.map((field) => field.id).join(", ");
+  return `# ${template.title}
+
+<!-- Rendered as ${template.format} from one ${template.inputEntity} record. Fields: ${fields}. -->
+`;
+}
 var POLISH_LABELS = {
   name: "Nazwa",
   status: "Status",
@@ -4914,6 +5227,7 @@ function valueLabels(model, locale) {
 function translation(locale, name, description, model) {
   const columns = columnLabels(model, locale);
   const values2 = valueLabels(model, locale);
+  const optional = model.columns.some((field) => !field.required);
   if (locale === "pl") {
     return json({
       "module.name": `Modu\u0142 ${name}`,
@@ -4925,12 +5239,16 @@ function translation(locale, name, description, model) {
       "action.refresh": "Od\u015Bwie\u017C",
       "table.title": "Rekordy",
       "table.caption": `Rekordy modu\u0142u ${name}`,
-      "table.count": "Liczba rekord\xF3w: {count}",
+      "table.count.one": "{count} rekord",
+      "table.count.few": "{count} rekordy",
+      "table.count.many": "{count} rekord\xF3w",
+      "table.count.other": "{count} rekordu",
       ...columns,
       "table.loading": "Wczytywanie rekord\xF3w\u2026",
       "table.emptyTitle": "Brak rekord\xF3w",
       "table.emptyHint": "Utworzone rekordy pojawi\u0105 si\u0119 w tym miejscu.",
       ...values2,
+      ...optional ? { "value.none": "Brak" } : {},
       "error.load": "Nie uda\u0142o si\u0119 wczyta\u0107 rekord\xF3w.",
       "error.request": "Operacja na rekordach nie powiod\u0142a si\u0119."
     });
@@ -4945,12 +5263,18 @@ function translation(locale, name, description, model) {
     "action.refresh": "Refresh",
     "table.title": "Records",
     "table.caption": `${name} records`,
-    "table.count": "{count} records",
+    ...Object.fromEntries(
+      requiredPluralCategories(locale).map((category) => [
+        `table.count.${category}`,
+        category === "one" ? "{count} record" : "{count} records"
+      ])
+    ),
     ...columns,
     "table.loading": "Loading records\u2026",
     "table.emptyTitle": "No records yet",
     "table.emptyHint": "Records created in this workspace appear here.",
     ...values2,
+    ...optional ? { "value.none": "None" } : {},
     "error.load": "Could not load records.",
     "error.request": "The records operation failed."
   });
@@ -5012,6 +5336,31 @@ function planScaffold(spec, specSource) {
     files.set("src/cli/commands.json", cliCatalog(model));
     files.set("src/cli/index.ts", cliEntry(model));
   }
+  if (spec.research) {
+    files.set("src/research.ts", researchFile(model, spec.research));
+    files.set("research-fixtures.json", researchFixtures(spec.research));
+  }
+  for (const adapter of spec.adapters ?? []) {
+    const name = adapter.id.slice(spec.id.length + 1).replace(/\./g, "-");
+    const paths = [
+      `src/adapters/${name}.ts`,
+      adapter.recorded ?? `adapters/${name}.recorded.json`
+    ];
+    for (const path of paths) {
+      if (files.has(path)) {
+        throw new Error(
+          `Adapter "${adapter.id}" and another adapter both map to ${path}.`
+        );
+      }
+    }
+    files.set(paths[0], adapterFile(name, adapter));
+    files.set(paths[1], recordedFixture(adapter));
+  }
+  for (const template of spec.templates ?? []) {
+    if (!files.has(template.body)) {
+      files.set(template.body, templateBody(spec, template));
+    }
+  }
   files.set("tests/module.test.ts", testFile(model));
   for (const locale of /* @__PURE__ */ new Set(["en", ...spec.locales])) {
     files.set(
@@ -5068,6 +5417,51 @@ function duplicateIssues(items, key, section) {
   });
   return issues;
 }
+var MONTH_NAMES = "jan feb mar apr may jun jul aug sep oct nov dec".split(
+  " "
+);
+var WEEKDAY_NAMES = "sun mon tue wed thu fri sat".split(" ");
+var CRON_FIELDS = [
+  { name: "minute", min: 0, max: 59 },
+  { name: "hour", min: 0, max: 23 },
+  { name: "day of month", min: 1, max: 31 },
+  { name: "month", min: 1, max: 12, names: MONTH_NAMES },
+  { name: "day of week", min: 0, max: 7, names: WEEKDAY_NAMES }
+];
+function cronIssue(expression) {
+  const fields = expression.split(" ");
+  if (fields.length !== 5) return "it needs five fields";
+  for (const [index, field] of fields.entries()) {
+    const spec = CRON_FIELDS[index];
+    const names = "names" in spec ? spec.names : [];
+    const value = (raw) => {
+      const named = names.indexOf(raw);
+      if (named >= 0) return named + spec.min;
+      const number = /^\d{1,2}$/.test(raw) ? Number(raw) : Number.NaN;
+      return number >= spec.min && number <= spec.max ? number : void 0;
+    };
+    const items = field.split(",");
+    if (items.length > 32) return `${spec.name} lists too many values`;
+    for (const item of items) {
+      const [base = "", step, extra] = item.split("/");
+      if (extra !== void 0 || base === "")
+        return `${spec.name} has an unsupported value`;
+      if (step !== void 0 && (!/^\d{1,2}$/.test(step) || Number(step) < 1 || Number(step) > spec.max - spec.min + 1))
+        return `${spec.name} has an unsupported step`;
+      if (base === "*") continue;
+      const bounds = base.split("-");
+      if (bounds.length > 2) return `${spec.name} has an unsupported range`;
+      const from = value(bounds[0]);
+      const to = bounds.length === 2 ? value(bounds[1]) : from;
+      if (from === void 0 || to === void 0)
+        return `${spec.name} must be between ${spec.min} and ${spec.max}`;
+      if (bounds.length === 1 && step !== void 0)
+        return `${spec.name} needs a range or * before a step`;
+      if (to < from) return `${spec.name} range runs backwards`;
+    }
+  }
+  return void 0;
+}
 function moduleSpecIssues(value) {
   const spec = value;
   if (!spec || typeof spec !== "object" || spec.schemaVersion !== 2) return [];
@@ -5091,7 +5485,9 @@ function moduleSpecIssues(value) {
     ...duplicateIssues(spec.widgets, "id", "widgets"),
     ...duplicateIssues(spec.settings, "key", "settings"),
     ...duplicateIssues(spec.agentTools, "id", "agentTools"),
-    ...duplicateIssues(spec.decisions, "id", "decisions")
+    ...duplicateIssues(spec.decisions, "id", "decisions"),
+    ...duplicateIssues(spec.adapters, "id", "adapters"),
+    ...duplicateIssues(spec.templates, "id", "templates")
   ];
   if (capabilities2.has("database") && entities.length === 0) {
     issues.push(
@@ -5182,12 +5578,12 @@ function moduleSpecIssues(value) {
       });
     }
   });
-  const entityIssue = (entity, path) => {
+  const entityIssue = (entity, path, key = "entity") => {
     if (entity === void 0 || fieldsByEntity.has(entity)) return void 0;
     return specIssue(
       "SPEC_ENTITY_UNKNOWN",
       `"${entity}" is not an entity of this specification.`,
-      `${path}/entity`
+      `${path}/${key}`
     );
   };
   (spec.screens ?? []).forEach((screen, index) => {
@@ -5250,6 +5646,62 @@ function moduleSpecIssues(value) {
       )
     );
   });
+  const evidenceOwner = entityIssue(
+    spec.research?.evidenceOwner,
+    "/research",
+    "evidenceOwner"
+  );
+  if (evidenceOwner) issues.push(evidenceOwner);
+  (spec.templates ?? []).forEach((template, index) => {
+    const unknownEntity = entityIssue(
+      template.inputEntity,
+      `/templates/${index}`,
+      "inputEntity"
+    );
+    if (unknownEntity) issues.push(unknownEntity);
+  });
+  (spec.adapters ?? []).forEach((adapter, index) => {
+    const path = `/adapters/${index}`;
+    if (!adapter.id.startsWith(`${spec.id}.`)) {
+      issues.push(
+        specIssue(
+          "SPEC_ADAPTER_ID_NAMESPACE",
+          `Adapter "${adapter.id}" must start with the module id "${spec.id}.".`,
+          `${path}/id`
+        )
+      );
+    }
+    if (adapter.direction === "source" && ![...modules].some((owner) => adapter.port.startsWith(`${owner}.`))) {
+      issues.push(
+        specIssue(
+          "SPEC_ADAPTER_PORT_UNKNOWN",
+          `Source adapter "${adapter.id}" writes through port "${adapter.port}", which belongs neither to this module nor to a declared dependency.`,
+          `${path}/port`
+        )
+      );
+    }
+    const schedule = typeof adapter.schedule === "string" ? cronIssue(adapter.schedule) : void 0;
+    if (schedule) {
+      issues.push(
+        specIssue(
+          "SPEC_ADAPTER_SCHEDULE_INVALID",
+          `Schedule of adapter "${adapter.id}" is not a five-field cron: ${schedule}.`,
+          `${path}/schedule`
+        )
+      );
+    }
+    adapter.mapping.forEach((entry, entryIndex) => {
+      const missing = entry.transform !== "constant" && entry.from === void 0 ? "from" : entry.transform !== "rename" && typeof entry.value !== "string" ? "value" : void 0;
+      if (!missing) return;
+      issues.push(
+        specIssue(
+          "SPEC_ADAPTER_MAPPING_INVALID",
+          `A ${entry.transform} mapping of adapter "${adapter.id}" needs "${missing}".`,
+          `${path}/mapping/${entryIndex}/${missing}`
+        )
+      );
+    });
+  });
   if (capabilities2.has("client") && !(spec.screens ?? []).some(
     (screen) => RENDERABLE_SCREEN_KINDS.has(screen.kind)
   )) {
@@ -5391,19 +5843,14 @@ var ALLOWED = Object.freeze({ allowed: true });
 var NO_POLICIES = Object.freeze([]);
 
 // ../kernel/src/approval-grant.ts
-import { createHash as createHash2, createHmac, timingSafeEqual } from "node:crypto";
+import * as nodeCrypto2 from "node:crypto";
 
 // ../kernel/src/keyring.ts
-import {
-  createCipheriv,
-  createDecipheriv,
-  createHash,
-  randomBytes
-} from "node:crypto";
+import * as nodeCrypto from "node:crypto";
 var KEYRING_KEY_BYTES = 32;
 var KEYRING_MAX_PREVIOUS_KEYS = 8;
 function keyFingerprint(key) {
-  return createHash("sha256").update(key).digest("hex").slice(0, 16);
+  return nodeCrypto.createHash("sha256").update(key).digest("hex").slice(0, 16);
 }
 function parsePreviousKeys(value, decode) {
   if (!value) return [];
@@ -5475,7 +5922,7 @@ function canonical(value) {
   return `{${entries.map(([key, entry]) => `${JSON.stringify(key)}:${canonical(entry)}`).join(",")}}`;
 }
 function approvalInputDigest(input) {
-  return createHash2("sha256").update(canonical(input), "utf8").digest("hex");
+  return nodeCrypto2.createHash("sha256").update(canonical(input), "utf8").digest("hex");
 }
 function claimString(value, maximum = MAX_CLAIM_LENGTH) {
   return typeof value === "string" && value.length >= 1 && value.length <= maximum && !/[\s\u0000]/.test(value) ? value : void 0;
@@ -5513,7 +5960,7 @@ function readClaims(value) {
   };
 }
 function signature(key, signed) {
-  return createHmac("sha256", key).update(signed, "utf8").digest();
+  return nodeCrypto2.createHmac("sha256", key).update(signed, "utf8").digest();
 }
 function invalid(message) {
   return { ok: false, reason: "APPROVAL_GRANT_INVALID", message };
@@ -5534,7 +5981,7 @@ function verifyApprovalGrant(keyring, token, expected, now = Date.now()) {
   }
   const expectedSignature = signature(key, `${prefix}.${keyId}.${payload}`);
   const suppliedSignature = Buffer.from(supplied, "base64url");
-  if (suppliedSignature.byteLength !== expectedSignature.byteLength || !timingSafeEqual(suppliedSignature, expectedSignature)) {
+  if (suppliedSignature.byteLength !== expectedSignature.byteLength || !nodeCrypto2.timingSafeEqual(suppliedSignature, expectedSignature)) {
     return invalid("The approval grant signature does not verify.");
   }
   let parsed;
@@ -6137,7 +6584,7 @@ import { dirname as dirname6, join as join5, relative as relative5 } from "node:
 import { createRequire } from "node:module";
 import { readFile as readFile4 } from "node:fs/promises";
 import { dirname as dirname4, join as join2 } from "node:path";
-var SDK_VERSION = "0.3.2";
+var SDK_VERSION = "0.4.0";
 var LIBRARIES = /* @__PURE__ */ new Set([
   "ai-provider",
   "cli-protocol",
@@ -6317,6 +6764,113 @@ function failure(code, message, details) {
   };
 }
 
+// src/dom-properties.ts
+var DOM_PROPERTY_SPELLINGS = [
+  "acceptCharset",
+  "allowFullScreen",
+  "autoCapitalize",
+  "autoComplete",
+  "autoCorrect",
+  "autoFocus",
+  "autoPlay",
+  "charSet",
+  "contentEditable",
+  "crossOrigin",
+  "defaultChecked",
+  "defaultValue",
+  "disablePictureInPicture",
+  "disableRemotePlayback",
+  "encType",
+  "fetchPriority",
+  "formAction",
+  "formEncType",
+  "formMethod",
+  "formNoValidate",
+  "formTarget",
+  "httpEquiv",
+  "imageSizes",
+  "imageSrcSet",
+  "inputMode",
+  "itemID",
+  "itemProp",
+  "itemRef",
+  "itemScope",
+  "itemType",
+  "maxLength",
+  "noModule",
+  "noValidate",
+  "playsInline",
+  "readOnly",
+  "referrerPolicy",
+  "spellCheck",
+  "srcDoc",
+  "srcLang",
+  "srcSet",
+  "tabIndex",
+  "viewBox"
+];
+var SPELLINGS = new Map(
+  DOM_PROPERTY_SPELLINGS.map((name) => [name.toLowerCase(), name])
+);
+function hostTagAttributes(source) {
+  const tags = [];
+  for (const match of source.matchAll(/<[a-z][a-z0-9-]*/g)) {
+    const start = match.index + match[0].length;
+    let depth = 0;
+    let quote = "";
+    let text = "";
+    let end = start;
+    for (; end < source.length; end += 1) {
+      const character = source[end];
+      if (quote !== "") {
+        if (character === quote) quote = "";
+        text += " ";
+        continue;
+      }
+      if (depth > 0) {
+        if (character === "{") depth += 1;
+        else if (character === "}") depth -= 1;
+        text += depth === 0 ? character : " ";
+        continue;
+      }
+      if (character === "{") {
+        depth = 1;
+        text += character;
+        continue;
+      }
+      if (character === '"' || character === "'") {
+        quote = character;
+        text += character;
+        continue;
+      }
+      if (character === ">") break;
+      text += character;
+    }
+    tags.push({ start, text });
+  }
+  return tags;
+}
+function domPropertyMisspellings(source) {
+  const found = [];
+  for (const tag of hostTagAttributes(source)) {
+    for (const attribute of tag.text.matchAll(
+      /(?<=\s)([A-Za-z][A-Za-z-]*)=/g
+    )) {
+      const name = attribute[1];
+      const expected = SPELLINGS.get(name.toLowerCase());
+      if (expected === void 0 || expected === name) continue;
+      const index = tag.start + attribute.index;
+      found.push({
+        name,
+        expected,
+        index,
+        line: source.slice(0, index).split("\n").length
+      });
+    }
+  }
+  return found.sort((left, right) => left.index - right.index);
+}
+
 // src/module-validate.ts
 function issue(code, message, path, severity = "error") {
   return { code, message, path, severity };
@@ -6506,6 +7060,7 @@ async function translationIssues(moduleRoot, manifest2, projectLocales) {
   }
   if (!manifest2.capabilities.includes("translations")) return issues;
   const keySets = /* @__PURE__ */ new Map();
+  const referenceBundleKeys = /* @__PURE__ */ new Set();
   for (const locale of manifest2.locales) {
     const path = `translations/${locale}.json`;
     if (!await exists(join4(moduleRoot, path))) {
@@ -6523,7 +7078,21 @@ async function translationIssues(moduleRoot, manifest2, projectLocales) {
       if (!bundle || typeof bundle !== "object" || Array.isArray(bundle)) {
         throw new Error("Expected a JSON object.");
       }
-      keySets.set(locale, Object.keys(bundle).sort());
+      const strings = bundle;
+      keySets.set(locale, translationKeys(strings));
+      if (keySets.size === 1) {
+        for (const key of Object.keys(strings)) referenceBundleKeys.add(key);
+      }
+      const plurals = pluralFamilyIssues(strings, locale);
+      if (plurals.length > 0) {
+        issues.push(
+          issue(
+            "TRANSLATION_PLURAL_INCOMPLETE",
+            `${path} plural families do not match the ${locale} plural rules: ${plurals.join("; ")}.`,
+            path
+          )
+        );
+      }
     } catch (error) {
       issues.push(
         issue(
@@ -6552,7 +7121,7 @@ async function translationIssues(moduleRoot, manifest2, projectLocales) {
       )
     );
   }
-  const referenceKeys = new Set(reference[1]);
+  const referenceKeys = /* @__PURE__ */ new Set([...reference[1], ...referenceBundleKeys]);
   const files = await clientSourceFiles(moduleRoot);
   if (files.length > 0) {
     const namespace = manifest2.id.split(".")[0] ?? manifest2.id;
@@ -6584,6 +7153,21 @@ async function translationIssues(moduleRoot, manifest2, projectLocales) {
   }
   return issues;
 }
+function filtersTags(source) {
+  const tags = [];
+  for (const match of source.matchAll(/<Filters\b/g)) {
+    let depth = 0;
+    let end = match.index + match[0].length;
+    for (; end < source.length; end += 1) {
+      const character = source[end];
+      if (character === "{") depth += 1;
+      else if (character === "}") depth -= 1;
+      else if (character === ">" && depth === 0) break;
+    }
+    tags.push(source.slice(match.index, end));
+  }
+  return tags;
+}
 async function userInterfaceIssues(moduleRoot) {
   const issues = [];
   for (const file of await clientSourceFiles(moduleRoot)) {
@@ -6607,6 +7191,27 @@ async function userInterfaceIssues(moduleRoot) {
         )
       );
     }
+    const misspelled = domPropertyMisspellings(source);
+    if (misspelled.length > 0) {
+      issues.push(
+        issue(
+          "DOM_PROPERTY_CASING",
+          "Host elements use Octane's DOM property spelling: " + misspelled.map(
+            (found) => `line ${found.line} ${found.name} as ${found.expected}`
+          ).join(", ") + ".",
+          path
+        )
+      );
+    }
+    if (filtersTags(source).some((tag) => !/\slabel=/.test(tag))) {
+      issues.push(
+        issue(
+          "FILTERS_LABEL_MISSING",
+          'Filters from @flowdular/ui needs a translated label; without one it shows the English word "Filters" in every locale.',
+          path
+        )
+      );
+    }
   }
   return issues;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "flowdular",
-	"version": "0.3.2",
+	"version": "0.4.0",
 	"type": "module",
 	"bin": {
 		"flowdular": "./dist/index.js",
@@ -16,7 +16,7 @@
 		"ajv": "8.20.0",
 		"pg": "8.23.0",
 		"yaml": "2.9.0",
-		"@flowdular/sdk": "0.3.2"
+		"@flowdular/sdk": "0.4.0"
 	},
 	"license": "MIT",
 	"repository": {