yamlite 0.0.0-stage → 0.35.0

package/dist/index-BBHZ8yok.d.mts

@@ -0,0 +1,316 @@
+//#region src/types.d.ts
+type ColumnType = "INTEGER" | "REAL" | "TEXT" | "BOOLEAN" | "JSON";
+type ColumnFormat = "markdown" | "date" | "datetime" | "list" | "map";
+type AllowedValue = string | number | boolean;
+type Bound = number | string;
+type Mode = "files" | "list";
+type Rec = Record<string, unknown>;
+type DbValue = null | number | bigint | string | Uint8Array;
+type DbRow = Record<string, DbValue>;
+interface IndexSpec {
+  columns?: string[];
+  expr?: string;
+  unique: boolean;
+}
+interface Reference {
+  column: string;
+  table: string;
+  target?: string;
+}
+interface ExpandSpec {
+  field: string;
+  name: string;
+  columns: Record<string, ColumnType>;
+  formats: Record<string, ColumnFormat>;
+  references: Reference[];
+  values: Record<string, AllowedValue[]>;
+  required: string[];
+  min: Record<string, Bound>;
+  max: Record<string, Bound>;
+  expand: ExpandSpec[];
+}
+interface ViewRecord {
+  name: string;
+  table: string;
+  parent: string;
+  columns: Record<string, ColumnType>;
+  identity: string[];
+}
+interface Claim {
+  owner: string;
+  path: string;
+  glob: string | null;
+  tie: boolean;
+}
+interface Capture {
+  column: string;
+  segment: number;
+}
+interface TableSpec {
+  name: string;
+  path: string;
+  mode: Mode;
+  glob: string | null;
+  codec: "yaml" | "markdown";
+  body: string | null;
+  key: string;
+  columns: Record<string, ColumnType>;
+  formats: Record<string, ColumnFormat>;
+  indexes: IndexSpec[];
+  references: Reference[];
+  values: Record<string, AllowedValue[]>;
+  required: string[];
+  min: Record<string, Bound>;
+  max: Record<string, Bound>;
+  persisted: boolean;
+  exclude: Claim[];
+  expand: ExpandSpec[];
+  group: string | null;
+  split: string | null;
+  captures: Capture[];
+}
+type PageAccess = "read" | "write";
+interface PageSpec {
+  name: string;
+  path: string;
+  title: string;
+  access: Record<string, PageAccess>;
+  sql: boolean;
+  network: string[];
+  ai: {
+    maxOutputTokens: number;
+  } | null;
+}
+interface SchemaChange {
+  op: "createIndex" | "dropIndex" | "alterColumn" | "dropColumn" | "createView" | "dropView";
+  name: string;
+  definition: string;
+}
+interface ConflictInfo {
+  table: string;
+  key: string;
+  winner: "file" | "db";
+  savedTo: string | null;
+}
+type ChangeOp = "toDb" | "toFile" | "deleteDb" | "deleteFile";
+interface Change {
+  key: string;
+  op: ChangeOp;
+}
+interface FieldChange {
+  path: string;
+  from: unknown;
+  to: unknown;
+}
+interface HistoryEntry {
+  kind: "wip" | "commit";
+  sha: string | null;
+  head: boolean;
+  subject: string | null;
+  author: string | null;
+  date: string;
+  path: string;
+  renamedFrom?: string;
+  event?: "created" | "deleted";
+  unreadable?: boolean;
+  changes: FieldChange[];
+  record: Rec | null;
+}
+type HistoryPage = {
+  state: "nogit" | "untracked";
+} | {
+  state: "error";
+  message: string;
+} | {
+  state: "ok";
+  entries: HistoryEntry[];
+  next: string | null;
+};
+//#endregion
+//#region src/config.d.ts
+interface TableInput {
+  name: string;
+  path?: string;
+  files?: string;
+  key?: string;
+  body?: string;
+  columns?: Record<string, string>;
+  formats?: Record<string, string>;
+  indexes?: unknown[];
+  references?: Record<string, unknown>;
+  values?: unknown;
+  required?: unknown;
+  min?: unknown;
+  max?: unknown;
+  expand?: Record<string, unknown>;
+  group?: string;
+  split?: string;
+}
+interface OpenOptions {
+  root?: string;
+  db?: string;
+  tables?: TableInput[];
+  stateDir?: string;
+  persistConfig?: boolean;
+  configText?: string;
+}
+declare const CONFIG_NAMES: string[];
+type TableLocation = {
+  kind: "file";
+  path: string;
+} | {
+  kind: "files";
+  base: string;
+  glob: string;
+  captures: Capture[];
+} | {
+  kind: "default";
+};
+type DeclaredTable = Omit<TableSpec, "path" | "mode" | "glob" | "captures" | "persisted" | "exclude"> & {
+  location: TableLocation;
+};
+interface Config {
+  tables: DeclaredTable[];
+  pages: PageSpec[];
+}
+declare function readsFile(l: TableLocation, file: string): boolean;
+declare function parseConfig(text: string, name?: string): Config;
+//#endregion
+//#region src/reconcile.d.ts
+interface BaseHashes {
+  f: string | null;
+  d: string | null;
+}
+type Action = "none" | "base" | "drop" | "toDb" | "toFile";
+interface Decision {
+  key: string;
+  action: Action;
+  conflict?: "file" | "db";
+}
+//#endregion
+//#region src/plan.d.ts
+interface Registered {
+  column: string;
+  type: ColumnType;
+}
+//#endregion
+//#region src/engine.d.ts
+interface TableResult {
+  table: string;
+  records: number;
+  changes: Change[];
+  schema: SchemaChange[];
+  registered: Registered[];
+  ok: boolean;
+  error?: string;
+  busy?: boolean;
+  toDb: number;
+  toFile: number;
+  deletedDb: number;
+  deletedFile: number;
+  conflicts: ConflictInfo[];
+  warnings: string[];
+  decisions?: Decision[];
+}
+//#endregion
+//#region src/watch.d.ts
+interface WatchHandlers {
+  onSync?: (result: TableResult) => void;
+  onConflict?: (conflict: ConflictInfo) => void;
+  onError?: (error: Error, table?: string) => void;
+  onReload?: (tables: string[]) => void;
+}
+interface WatchOptions {
+  pollMs?: number;
+  debounceMs?: number;
+}
+interface Watcher {
+  readonly ready: Promise<void>;
+  reloadConfig(): void;
+  close(): Promise<void>;
+}
+//#endregion
+//#region src/check.d.ts
+interface CheckTable {
+  table: string;
+  ok: boolean;
+  error?: string;
+  warnings: string[];
+  unregistered: Registered[];
+}
+interface CheckResult {
+  ok: boolean;
+  tables: CheckTable[];
+  unregisteredTables: string[];
+}
+declare function check(opts: {
+  root: string;
+  tables?: string[];
+}): Promise<CheckResult>;
+//#endregion
+//#region src/export.d.ts
+interface ExportOptions {
+  root: string;
+  out: string;
+  tables?: string[];
+  force?: boolean;
+  uiDir?: string;
+  now?: () => Date;
+}
+interface ExportResult {
+  out: string;
+  tables: string[];
+  warnings: Record<string, string[]>;
+  pages: string[];
+  skippedPages: Record<string, string>;
+}
+declare function exportSite(opts: ExportOptions): Promise<ExportResult>;
+//#endregion
+//#region src/init.d.ts
+interface InitOptions {
+  root: string;
+  db?: string;
+  force?: boolean;
+}
+declare function generateConfig(opts: InitOptions): string;
+declare function init(opts: InitOptions): {
+  path: string;
+  tables: string[];
+};
+//#endregion
+//#region src/query.d.ts
+interface QueryResult {
+  columns: string[];
+  rows: DbValue[][];
+  truncated: boolean;
+  warnings: string[];
+}
+interface QueryOptions {
+  root?: string;
+  db?: string;
+  sql: string;
+  limit?: number;
+}
+declare function query(opts: QueryOptions): Promise<QueryResult>;
+declare function formatTable(r: QueryResult): string;
+declare function formatJson(r: QueryResult): string;
+declare function formatCsv(r: QueryResult): string;
+//#endregion
+//#region src/index.d.ts
+interface Yamlite {
+  readonly tables: readonly TableSpec[];
+  readonly pages: readonly PageSpec[];
+  status(opts?: {
+    tables?: string[];
+  }): Promise<TableResult[]>;
+  sync(opts?: {
+    tables?: string[];
+    force?: boolean;
+    forceConvert?: boolean;
+  }): Promise<TableResult[]>;
+  watch(handlers?: WatchHandlers, options?: WatchOptions): Watcher;
+  close(): Promise<void>;
+}
+declare function open(options: OpenOptions): Promise<Yamlite>;
+//#endregion
+export { parseConfig as A, HistoryEntry as B, Decision as C, OpenOptions as D, DeclaredTable as E, ColumnType as F, Rec as G, IndexSpec as H, ConflictInfo as I, ViewRecord as J, SchemaChange as K, DbRow as L, Capture as M, Change as N, TableInput as O, ChangeOp as P, DbValue as R, BaseHashes as S, Config as T, PageAccess as U, HistoryPage as V, PageSpec as W, check as _, formatCsv as a, Watcher as b, query as c, init as d, ExportOptions as f, CheckTable as g, CheckResult as h, QueryResult as i, readsFile as j, TableLocation as k, InitOptions as l, exportSite as m, open as n, formatJson as o, ExportResult as p, TableSpec as q, QueryOptions as r, formatTable as s, Yamlite as t, generateConfig as u, WatchHandlers as v, CONFIG_NAMES as w, TableResult as x, WatchOptions as y, FieldChange as z };

package/dist/index.d.mts

@@ -0,0 +1,2 @@
+import { C as Decision, D as OpenOptions, F as ColumnType, H as IndexSpec, I as ConflictInfo, K as SchemaChange, N as Change, O as TableInput, P as ChangeOp, W as PageSpec, _ as check, a as formatCsv, b as Watcher, c as query, d as init, f as ExportOptions, g as CheckTable, h as CheckResult, i as QueryResult, l as InitOptions, m as exportSite, n as open, o as formatJson, p as ExportResult, q as TableSpec, r as QueryOptions, s as formatTable, t as Yamlite, u as generateConfig, v as WatchHandlers, x as TableResult, y as WatchOptions } from "./index-BBHZ8yok.mjs";
+export { type Change, type ChangeOp, type CheckResult, type CheckTable, type ColumnType, type ConflictInfo, type Decision, type ExportOptions, type ExportResult, type IndexSpec, type InitOptions, type OpenOptions, type PageSpec, type QueryOptions, type QueryResult, type SchemaChange, type TableInput, type TableResult, type TableSpec, type WatchHandlers, type WatchOptions, type Watcher, Yamlite, check, exportSite, formatCsv, formatJson, formatTable, generateConfig, init, open, query };

package/dist/index.mjs

@@ -0,0 +1 @@
+export { R as check, c as exportSite, n as formatCsv, r as formatJson, i as formatTable, o as generateConfig, s as init, t as open, a as query } from "./src-DKu7thkC.mjs";