@krizaka/org 0.5.0 → 0.6.0

package/README.md

@@ -19,6 +19,10 @@ Without a build step, read it from the CDN: [krizaka-assets.b-cdn.net/org/v1/org
   (`defaults/v1/<kind>/<id>-<size>.<ext>`, written by krizaka-ui `tools/export-defaults.mjs`). An app never hard-codes or bundles one:
   `listDefaults(kind)` lists them, `defaultFor(kind, seed)` picks one deterministically (FNV-1a of the seed, modulo the list), `defaultUrl(item, size)` gives the URL,
   `fetchDefaults(ORG_URL)` reads the section from the published JSON. A folder is never given a person.
+- **One name per entry of the family.** `org.family` (and `familyName(id)`) is the only place a name is written: the company
+  is « Krizaka », a product goes by its own name (Orazaka, Yomizaka, Akinaza — never « Krizaka Yomizaka »), a library or a tool
+  is « Krizaka <X> » (Krizaka UI, Krizaka Java, Krizaka TypeScript, Krizaka Lab, Krizaka Skills; the short name only under a
+  heading « Open source »). The bar, the switcher and every footer read it; a test holds the rule.
 - **Public facts only.** Never an address, a phone number, figures, a secret, an IP address or an internal host: the test
   scans for them and the schema refuses any field it does not list.
 - **Validated.** `orgSchema` (JSON Schema 2020-12) and the types `Org`, `AppConfig`…; a test validates the data and requests every

package/dist/index.d.ts

@@ -18,6 +18,28 @@ interface OrgSite {
     name: string;
     url: string;
 }
+/** Where an entry of the family sits: the company's own pages, the products, the open-source libraries and tools, GitHub. */
+type FamilyGroup = "krizaka" | "products" | "open-source" | "github";
+/** `released`: open to use. `development`: built in the open, said « In development ». */
+type FamilyStatus = "released" | "development";
+/**
+ * One name of the family, the only place it is written. The naming rule (founder, 2026-10-30): the company is
+ * « Krizaka »; a product goes by its own name (« Yomizaka », never « Krizaka Yomizaka »); a library or a tool is always
+ * « Krizaka <X> » (« Krizaka UI », never « UI » alone outside a group headed « Open source »).
+ */
+interface FamilyEntry {
+    id: string;
+    /** The display name, never translated (« Krizaka TypeScript »). */
+    name: string;
+    /** The short name, only inside its group's heading (« TypeScript » under « Open source »). */
+    short: string;
+    group: FamilyGroup;
+    status: FamilyStatus;
+    /** Its home: the site, or the repository while it has no site. */
+    url: string;
+    /** Its public source repository (`null` for GitHub itself). */
+    repo: string | null;
+}
 interface OrgAvatar {
     id: string;
     /** `person` is a silhouette, `plain` a plain disc. */
@@ -112,6 +134,8 @@ interface Org {
     /** Only the products that are live. */
     products: OrgProduct[];
     sites: OrgSite[];
+    /** Every name of the family, in reading order (group, then order inside it): the bar, the switcher and every footer read it. */
+    family: FamilyEntry[];
     contact: {
         page: Localized;
         /** The public support address; `null` while none is public. */
@@ -207,7 +231,6 @@ declare function fetchDefaults(url: string, fetchImpl?: typeof fetch): Promise<O
 declare const CDN = "https://krizaka-assets.b-cdn.net";
 declare const ORG_URL = "https://krizaka-assets.b-cdn.net/org/v1/org.json";
 declare const ORG_SCHEMA_URL = "https://krizaka-assets.b-cdn.net/org/v1/org.schema.json";
-/** The public facts about Krizaka. Reviewed by pull request; changing a fact is one PR here and a release. */
 declare const org: Org;
 
 /** The JSON Schema of `org/v1/org.json`. Nothing outside it is allowed (`additionalProperties: false` everywhere): a new fact is a new line here first. */
@@ -217,7 +240,7 @@ declare const orgSchema: {
     readonly title: "Krizaka organisation — public facts";
     readonly type: "object";
     readonly additionalProperties: false;
-    readonly required: readonly ["$schema", "schemaVersion", "version", "updatedAt", "company", "brand", "people", "defaults", "products", "sites", "contact", "footer"];
+    readonly required: readonly ["$schema", "schemaVersion", "version", "updatedAt", "company", "brand", "people", "defaults", "products", "sites", "family", "contact", "footer"];
     readonly properties: {
         readonly $schema: {
             readonly type: "string";
@@ -695,6 +718,49 @@ declare const orgSchema: {
                 };
             };
         };
+        readonly family: {
+            readonly type: "array";
+            readonly minItems: 1;
+            readonly items: {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["id", "name", "short", "group", "status", "url", "repo"];
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                        readonly pattern: "^[a-z0-9]+(-[a-z0-9]+)*$";
+                    };
+                    readonly name: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly short: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly group: {
+                        readonly enum: readonly ["krizaka", "products", "open-source", "github"];
+                    };
+                    readonly status: {
+                        readonly enum: readonly ["released", "development"];
+                    };
+                    readonly url: {
+                        readonly type: "string";
+                        readonly format: "uri";
+                        readonly pattern: "^https://";
+                    };
+                    readonly repo: {
+                        readonly anyOf: readonly [{
+                            readonly type: "string";
+                            readonly format: "uri";
+                            readonly pattern: "^https://";
+                        }, {
+                            readonly type: "null";
+                        }];
+                    };
+                };
+            };
+        };
         readonly contact: {
             readonly type: "object";
             readonly additionalProperties: false;
@@ -858,5 +924,8 @@ declare const appSchema: {
 declare const localized: (text: Localized, locale: string) => string;
 /** The footer line of the family, « Une entreprise de Technologies Krizaka · Fait à Montréal ». */
 declare const footerLine: (locale: string) => string;
+/** A name of the family by id (`familyName("ts")` → « Krizaka TypeScript »): the only way a site writes one. */
+declare const familyEntry: (id: string) => FamilyEntry;
+declare const familyName: (id: string) => string;
 
-export { APP_SCHEMA_URL, type AppConfig, type AppEnvironment, CAST, CAST_VERSION, CDN, type CastPersona, type CastProduct, type CastRole, DEFAULT_KINDS, type Localized, ORG_SCHEMA_URL, ORG_URL, type Org, type OrgAvatar, type OrgBanner, type OrgDefaultItem, type OrgDefaultKind, type OrgDefaults, type OrgMark, type OrgProduct, type OrgSite, type ProductStatus, appSchema, apps, castMedia, castOf, defaultFor, defaultUrl, defaults, fetchDefaults, footerLine, listDefaults, localized, org, orgSchema, persona, personaByRole, seedFingerprint, seedHash };
+export { APP_SCHEMA_URL, type AppConfig, type AppEnvironment, CAST, CAST_VERSION, CDN, type CastPersona, type CastProduct, type CastRole, DEFAULT_KINDS, type FamilyEntry, type FamilyGroup, type FamilyStatus, type Localized, ORG_SCHEMA_URL, ORG_URL, type Org, type OrgAvatar, type OrgBanner, type OrgDefaultItem, type OrgDefaultKind, type OrgDefaults, type OrgMark, type OrgProduct, type OrgSite, type ProductStatus, appSchema, apps, castMedia, castOf, defaultFor, defaultUrl, defaults, familyEntry, familyName, fetchDefaults, footerLine, listDefaults, localized, org, orgSchema, persona, personaByRole, seedFingerprint, seedHash };