@ctcstack/ctcdocs-core 0.5.1 → 0.6.0

package/dist/site-configuration.d.ts

@@ -100,6 +100,15 @@ export interface NavigationConfiguration {
      * slugs are reserved either way, so turning this on or off moves no address.
      */
     readonly sectionIndexPages: boolean;
+    /**
+     * The Unicode scripts a letter in a Drive name may belong to, such as
+     * `["Latin"]`, or `null` when any script is accepted. A name becomes a
+     * heading, a sidebar label and, once, a permanent address, so a deployment
+     * whose editors write in one alphabet can refuse a letter typed on the other
+     * keyboard layout before it reaches any of them. Whatever this allows, a
+     * single word never mixes Latin, Cyrillic and Greek letters (ADR-020).
+     */
+    readonly nameScripts: readonly string[] | null;
 }
 export interface SiteConfiguration {
     readonly brand: BrandConfiguration;

package/dist/site-configuration.js

@@ -89,6 +89,36 @@ function flag(source, key, path) {
 function optionalFlag(source, key, path, fallback) {
     return source[key] === undefined ? fallback : flag(source, key, path);
 }
+/**
+ * A list of distinct Unicode script names, as a `\p{Script=…}` property
+ * escape spells them. Each name is proved by compiling that escape, so a typo
+ * fails here rather than letting every letter through, or none.
+ */
+function optionalScriptList(source, key, path) {
+    const value = source[key];
+    if (value === undefined) {
+        return null;
+    }
+    if (!Array.isArray(value) || value.length === 0) {
+        fail(path, 'must be a non-empty array of Unicode script names');
+    }
+    const scripts = value.map((entry, index) => {
+        if (typeof entry !== 'string' || !/^[A-Za-z_]+$/u.test(entry)) {
+            fail(`${path}[${index}]`, 'must be a Unicode script name such as "Latin"');
+        }
+        try {
+            new RegExp(`\\p{Script=${entry}}`, 'u');
+        }
+        catch {
+            fail(`${path}[${index}]`, 'must be a Unicode script name such as "Latin"');
+        }
+        return entry;
+    });
+    if (new Set(scripts).size !== scripts.length) {
+        fail(path, 'must not repeat a script');
+    }
+    return Object.freeze(scripts);
+}
 /**
  * A count of things shown on a page. Zero is rejected along with fractions and
  * negatives: a block configured to show nothing is hidden by the switch that
@@ -190,6 +220,7 @@ export function parseSiteConfiguration(input) {
         navigation: {
             landingDocumentTitles: titleList(navigationSource, 'landingDocumentTitles', 'navigation.landingDocumentTitles'),
             sectionIndexPages: flag(navigationSource, 'sectionIndexPages', 'navigation.sectionIndexPages'),
+            nameScripts: optionalScriptList(navigationSource, 'nameScripts', 'navigation.nameScripts'),
         },
         sync: {
             commitBotName: text(syncSource, 'commitBotName', 'sync.commitBotName'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ctcstack/ctcdocs-core",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Configuration schema, project layout, and generated-path allowlist shared by the CTCDocs platform packages.",
   "keywords": [
     "ctcdocs",

package/src/site-configuration.ts

@@ -125,6 +125,15 @@ export interface NavigationConfiguration {
    * slugs are reserved either way, so turning this on or off moves no address.
    */
   readonly sectionIndexPages: boolean;
+  /**
+   * The Unicode scripts a letter in a Drive name may belong to, such as
+   * `["Latin"]`, or `null` when any script is accepted. A name becomes a
+   * heading, a sidebar label and, once, a permanent address, so a deployment
+   * whose editors write in one alphabet can refuse a letter typed on the other
+   * keyboard layout before it reaches any of them. Whatever this allows, a
+   * single word never mixes Latin, Cyrillic and Greek letters (ADR-020).
+   */
+  readonly nameScripts: readonly string[] | null;
 }
 
 export interface SiteConfiguration {
@@ -242,6 +251,46 @@ function optionalFlag(
   return source[key] === undefined ? fallback : flag(source, key, path);
 }
 
+/**
+ * A list of distinct Unicode script names, as a `\p{Script=…}` property
+ * escape spells them. Each name is proved by compiling that escape, so a typo
+ * fails here rather than letting every letter through, or none.
+ */
+function optionalScriptList(
+  source: Record<string, unknown>,
+  key: string,
+  path: string,
+): readonly string[] | null {
+  const value = source[key];
+  if (value === undefined) {
+    return null;
+  }
+  if (!Array.isArray(value) || value.length === 0) {
+    fail(path, 'must be a non-empty array of Unicode script names');
+  }
+  const scripts = value.map((entry, index) => {
+    if (typeof entry !== 'string' || !/^[A-Za-z_]+$/u.test(entry)) {
+      fail(
+        `${path}[${index}]`,
+        'must be a Unicode script name such as "Latin"',
+      );
+    }
+    try {
+      new RegExp(`\\p{Script=${entry}}`, 'u');
+    } catch {
+      fail(
+        `${path}[${index}]`,
+        'must be a Unicode script name such as "Latin"',
+      );
+    }
+    return entry;
+  });
+  if (new Set(scripts).size !== scripts.length) {
+    fail(path, 'must not repeat a script');
+  }
+  return Object.freeze(scripts);
+}
+
 /**
  * A count of things shown on a page. Zero is rejected along with fractions and
  * negatives: a block configured to show nothing is hidden by the switch that
@@ -396,6 +445,11 @@ export function parseSiteConfiguration(input: unknown): SiteConfiguration {
         'sectionIndexPages',
         'navigation.sectionIndexPages',
       ),
+      nameScripts: optionalScriptList(
+        navigationSource,
+        'nameScripts',
+        'navigation.nameScripts',
+      ),
     },
     sync: {
       commitBotName: text(syncSource, 'commitBotName', 'sync.commitBotName'),