@rljson/rljson 0.0.72 → 0.0.73

package/dist/content/head.d.ts

@@ -0,0 +1,10 @@
+import { Json } from '@rljson/json';
+import { RljsonTable } from '../rljson.ts';
+import { TableCfg } from './table-cfg.ts';
+export interface Head extends Json {
+    timeId: string;
+    cakeRef: string;
+    _hash: string;
+}
+export type HeadsTable = RljsonTable<Head, 'head'>;
+export declare const createHeadsTableCfg: (cakeKey: string) => TableCfg;

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from './content/buffet.ts';
 export * from './content/cake.ts';
 export * from './content/components.ts';
+export * from './content/head.ts';
 export * from './content/layer.ts';
 export * from './content/revision.ts';
 export * from './content/slice-ids.ts';

package/dist/rljson.d.ts

@@ -2,6 +2,7 @@ import { Json } from '@rljson/json';
 import { BuffetsTable } from './content/buffet.ts';
 import { CakesTable } from './content/cake.ts';
 import { ComponentsTable } from './content/components.ts';
+import { HeadsTable } from './content/head.ts';
 import { LayersTable } from './content/layer.ts';
 import { RevisionsTable } from './content/revision.ts';
 import { SliceIdsTable } from './content/slice-ids.ts';
@@ -16,7 +17,7 @@ export declare const reservedTableKeys: string[];
 /**
  * One of the supported Rljson table types
  */
-export type TableType = BuffetsTable | ComponentsTable<any> | LayersTable | SliceIdsTable | CakesTable | RevisionsTable | TablesCfgTable | InsertHistoryTable<any> | EditsTable | MultiEditsTable | EditHistoryTable;
+export type TableType = BuffetsTable | ComponentsTable<any> | LayersTable | SliceIdsTable | CakesTable | RevisionsTable | TablesCfgTable | InsertHistoryTable<any> | EditsTable | MultiEditsTable | EditHistoryTable | HeadsTable;
 /** The rljson data format */
 export interface Rljson extends Json {
     [tableId: TableKey]: TableType;

package/dist/rljson.js

@@ -527,6 +527,36 @@ const createCakeTableCfg = (cakeKey) => ({
 });
 const exampleCakesTable = () => bakeryExample().cakes;
 const exampleComponentsTable = () => bakeryExample().nutritionalValues;
+const createHeadsTableCfg = (cakeKey) => ({
+  key: `${cakeKey}Heads`,
+  type: "head",
+  columns: [
+    {
+      key: "_hash",
+      type: "string",
+      titleLong: "Hash",
+      titleShort: "Hash"
+    },
+    {
+      key: "timeId",
+      type: "string",
+      titleLong: "Time Identifier",
+      titleShort: "Time ID"
+    },
+    {
+      key: "cakeRef",
+      type: "string",
+      titleLong: "Cake Reference",
+      titleShort: "Cake Ref",
+      ref: {
+        tableKey: `${cakeKey}`
+      }
+    }
+  ],
+  isHead: false,
+  isRoot: false,
+  isShared: true
+});
 const createLayerTableCfg = (layerKey) => ({
   key: layerKey,
   type: "layers",
@@ -1509,7 +1539,7 @@ const createEditHistoryTableCfg = (cakeKey) => ({
       titleLong: "Multi Edit Reference",
       titleShort: "Multi Edit Ref",
       ref: {
-        tableKey: `${cakeKey}MultiEdit`
+        tableKey: `${cakeKey}MultiEdits`
       }
     },
     {
@@ -1527,7 +1557,10 @@ const createEditHistoryTableCfg = (cakeKey) => ({
       titleLong: "Previous Values",
       titleShort: "Previous"
     }
-  ]
+  ],
+  isHead: false,
+  isRoot: false,
+  isShared: true
 });
 const createEditTableCfg = (cakeKey) => ({
   key: `${cakeKey}Edits`,
@@ -1551,7 +1584,10 @@ const createEditTableCfg = (cakeKey) => ({
       titleLong: "Edit Action Data",
       titleShort: "Action"
     }
-  ]
+  ],
+  isHead: false,
+  isRoot: false,
+  isShared: true
 });
 const createMultiEditTableCfg = (cakeKey) => ({
   key: `${cakeKey}MultiEdits`,
@@ -1578,7 +1614,10 @@ const createMultiEditTableCfg = (cakeKey) => ({
         tableKey: `${cakeKey}Edits`
       }
     }
-  ]
+  ],
+  isHead: false,
+  isRoot: false,
+  isShared: true
 });
 const objectDepth = (o) => Object(o) === o ? 1 + Math.max(-1, ...Object.values(o).map(objectDepth)) : 0;
 class InsertValidator {
@@ -1809,7 +1848,8 @@ const contentTypes = [
   "insertHistory",
   "edits",
   "multiEdits",
-  "editHistory"
+  "editHistory",
+  "head"
 ];
 const exampleTypedefs = () => {
   return {
@@ -2663,6 +2703,7 @@ export {
   createCakeTableCfg,
   createEditHistoryTableCfg,
   createEditTableCfg,
+  createHeadsTableCfg,
   createInsertHistoryTableCfg,
   createLayerTableCfg,
   createMultiEditTableCfg,

package/dist/tools/time-id.d.ts

@@ -1,16 +1,16 @@
 /**
  * Generates a new TimeId.
- * A TimeId is a string in the format "xxxx:timestamp" where:
- * - "xxxx" is a 4-character unique identifier
+ * A TimeId has the format "timestamp:xxxx" where:
  * - "timestamp" is the current time in milliseconds since epoch
+ * - "xxxx" is a 4-character unique identifier
  * @returns A new TimeId string
  */
 export declare const timeId: () => string;
 /**
  * Checks if a given id is a valid TimeId.
- * A valid TimeId has the format "xxxx:timestamp" where:
- * - "xxxx" is a 4-character string
- * - "timestamp" is a valid number representing milliseconds since epoch
+ * A TimeId has the format "timestamp:xxxx" where:
+ * - "timestamp" is the current time in milliseconds since epoch
+ * - "xxxx" is a 4-character unique identifier
  * @param id - The id to check
  * @returns True if the id is a valid TimeId, false otherwise
  */

package/dist/typedefs.d.ts

@@ -26,7 +26,7 @@ export type ColumnKey = JsonKey;
  * - `ids` Tables containing slice ids
  * - `components` Tables containing slice components
  */
-export declare const contentTypes: readonly ["buffets", "cakes", "layers", "sliceIds", "components", "revisions", "tableCfgs", "insertHistory", "edits", "multiEdits", "editHistory"];
+export declare const contentTypes: readonly ["buffets", "cakes", "layers", "sliceIds", "components", "revisions", "tableCfgs", "insertHistory", "edits", "multiEdits", "editHistory", "head"];
 export type ContentType = (typeof contentTypes)[number];
 /**
  * An example object using the typedefs

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rljson/rljson",
-  "version": "0.0.72",
+  "version": "0.0.73",
   "description": "The RLJSON data format specification",
   "homepage": "https://github.com/rljson/rljson",
   "bugs": "https://github.com/rljson/rljson/issues",
@@ -21,23 +21,23 @@
   "type": "module",
   "devDependencies": {
     "@types/node": "^24.10.1",
-    "@typescript-eslint/eslint-plugin": "^8.46.4",
-    "@typescript-eslint/parser": "^8.46.4",
-    "@vitest/coverage-v8": "^4.0.9",
+    "@typescript-eslint/eslint-plugin": "^8.48.1",
+    "@typescript-eslint/parser": "^8.48.1",
+    "@vitest/coverage-v8": "^4.0.15",
     "cross-env": "^10.1.0",
     "eslint": "^9.39.1",
-    "eslint-plugin-jsdoc": "^61.2.1",
+    "eslint-plugin-jsdoc": "^61.4.1",
     "eslint-plugin-tsdoc": "^0.5.0",
     "globals": "^16.5.0",
     "jsdoc": "^4.0.5",
     "read-pkg": "^10.0.0",
     "typescript": "~5.9.3",
-    "typescript-eslint": "^8.46.4",
-    "vite": "^7.2.2",
-    "vite-node": "^5.1.0",
+    "typescript-eslint": "^8.48.1",
+    "vite": "^7.2.6",
+    "vite-node": "^5.2.0",
     "vite-plugin-dts": "^4.5.4",
     "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "^4.0.9",
+    "vitest": "^4.0.15",
     "vitest-dom": "^0.1.1"
   },
   "dependencies": {