@x12i/catalox 1.1.1 → 2.0.0

package/dist/src/markdown/render-list-markdown.d.ts

@@ -0,0 +1,5 @@
+import type { CatalogListRenderMap } from "../contracts/render-map.js";
+import type { BuildCatalogListMarkdownMapOptions, CatalogListMarkdownMap } from "../contracts/markdown-map.js";
+export declare function buildCatalogListMarkdownMap(map: CatalogListRenderMap, options?: BuildCatalogListMarkdownMapOptions): CatalogListMarkdownMap;
+export declare function renderCatalogListMarkdown(doc: CatalogListMarkdownMap): string;
+//# sourceMappingURL=render-list-markdown.d.ts.map

package/dist/src/markdown/render-list-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-list-markdown.d.ts","sourceRoot":"","sources":["../../../src/markdown/render-list-markdown.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EACV,kCAAkC,EAClC,sBAAsB,EAEvB,MAAM,8BAA8B,CAAC;AAiBtC,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,oBAAoB,EACzB,OAAO,CAAC,EAAE,kCAAkC,GAC3C,sBAAsB,CAoDxB;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,sBAAsB,GAAG,MAAM,CAsB7E"}

package/dist/src/markdown/render-list-markdown.js

@@ -0,0 +1,90 @@
+function mdEscape(s) {
+    return s.replace(/\|/g, "\\|").replace(/\r?\n/g, " ");
+}
+function toStringValue(v) {
+    if (v == null)
+        return "";
+    if (typeof v === "string")
+        return v;
+    if (typeof v === "number" || typeof v === "boolean")
+        return String(v);
+    try {
+        return JSON.stringify(v);
+    }
+    catch {
+        return String(v);
+    }
+}
+export function buildCatalogListMarkdownMap(map, options) {
+    const maxRows = options?.maxRows ?? 50;
+    const blocks = [
+        { type: "heading", level: 1, text: map.label },
+        {
+            type: "paragraph",
+            text: `CatalogId: ${map.catalogId}${map.total != null ? ` • Total: ${map.total}` : ""}`,
+        },
+    ];
+    const columns = map.presentation?.grid?.columns?.map((c) => c.fieldPath) ??
+        map.presentation?.fields?.slice(0, 8).map((f) => f.fieldPath) ??
+        [];
+    const headers = ["itemId", ...(columns.length ? columns : ["title", "subtitle", "status"])];
+    const rows = map.items.slice(0, maxRows).map((it) => {
+        const base = [it.itemId];
+        const fields = headers.slice(1).map((fp) => {
+            if (fp === "title")
+                return toStringValue(it.title);
+            if (fp === "subtitle")
+                return toStringValue(it.subtitle);
+            if (fp === "status")
+                return toStringValue(it.status);
+            const v = it.data?.[fp];
+            return toStringValue(v);
+        });
+        return [...base, ...fields].map((s) => mdEscape(String(s)));
+    });
+    blocks.push({ type: "heading", level: 2, text: "Items" });
+    blocks.push({ type: "table", headers, rows });
+    if (options?.includeMetadata) {
+        blocks.push({ type: "heading", level: 2, text: "Metadata" });
+        blocks.push({
+            type: "code",
+            language: "json",
+            text: JSON.stringify({
+                filters: map.filters?.active ?? {},
+                sort: map.sort,
+                selection: map.selection,
+                context: map.context,
+            }, null, 2),
+        });
+    }
+    return { title: map.label, blocks };
+}
+export function renderCatalogListMarkdown(doc) {
+    const out = [];
+    for (const b of doc.blocks) {
+        if (b.type === "heading")
+            out.push(`${"#".repeat(b.level)} ${b.text}`);
+        else if (b.type === "paragraph")
+            out.push(b.text);
+        else if (b.type === "list") {
+            const ordered = Boolean(b.ordered);
+            b.items.forEach((it, idx) => {
+                out.push(ordered ? `${idx + 1}. ${it}` : `- ${it}`);
+            });
+        }
+        else if (b.type === "code") {
+            out.push(`\`\`\`${b.language ?? ""}`.trimEnd());
+            out.push(b.text);
+            out.push("```");
+        }
+        else if (b.type === "table") {
+            out.push(`| ${b.headers.join(" | ")} |`);
+            out.push(`| ${b.headers.map(() => "---").join(" | ")} |`);
+            for (const r of b.rows)
+                out.push(`| ${r.join(" | ")} |`);
+        }
+        out.push("");
+    }
+    return out.join("\n").trimEnd() + "\n";
+}
+//# sourceMappingURL=render-list-markdown.js.map

package/dist/src/markdown/render-list-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-list-markdown.js","sourceRoot":"","sources":["../../../src/markdown/render-list-markdown.ts"],"names":[],"mappings":"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"}

package/dist/src/validation/index.d.ts

@@ -1,2 +1,4 @@
-export {};
+export { validateCatalogDescriptorUiSpec, validateCatalogFilterSpec, validateCatalogPresentationSpec, validateCatalogCustomRenderer, validateCatalogListRenderMap, validateCatalogItemRenderMap, } from "./ui-spec-validate.js";
+export type { UiSpecValidationError, UiSpecValidationResult } from "./ui-spec-validate.js";
+export { fieldSourceSchema, catalogFilterSpecSchema, catalogPresentationSpecSchema, catalogCustomRendererSchema, catalogListRenderMapSchema, catalogItemRenderMapSchema, } from "./ui-spec-schema.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/validation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,EACzB,+BAA+B,EAC/B,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE3F,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC"}

package/dist/src/validation/index.js

@@ -1,3 +1,3 @@
-// Validation utilities will live here.
-export {};
+export { validateCatalogDescriptorUiSpec, validateCatalogFilterSpec, validateCatalogPresentationSpec, validateCatalogCustomRenderer, validateCatalogListRenderMap, validateCatalogItemRenderMap, } from "./ui-spec-validate.js";
+export { fieldSourceSchema, catalogFilterSpecSchema, catalogPresentationSpecSchema, catalogCustomRendererSchema, catalogListRenderMapSchema, catalogItemRenderMapSchema, } from "./ui-spec-schema.js";
 //# sourceMappingURL=index.js.map

package/dist/src/validation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,EACzB,+BAA+B,EAC/B,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,GAC7B,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,6BAA6B,EAC7B,2BAA2B,EAC3B,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC"}

package/dist/src/validation/ui-spec-schema.d.ts

@@ -0,0 +1,19 @@
+import type { AnySchema } from "ajv";
+/**
+ * JSON Schemas for validating descriptor UI specs and renderer maps.
+ *
+ * These schemas are intended for server/backoffice systems validating JSON
+ * loaded from databases or API calls.
+ *
+ * Design goals:
+ * - validate discriminated unions (e.g. FieldSource.type)
+ * - validate required keys and primitive types
+ * - remain forward-compatible (allow unknown keys where safe)
+ */
+export declare const fieldSourceSchema: AnySchema;
+export declare const catalogFilterSpecSchema: AnySchema;
+export declare const catalogPresentationSpecSchema: AnySchema;
+export declare const catalogCustomRendererSchema: AnySchema;
+export declare const catalogListRenderMapSchema: AnySchema;
+export declare const catalogItemRenderMapSchema: AnySchema;
+//# sourceMappingURL=ui-spec-schema.d.ts.map

package/dist/src/validation/ui-spec-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-spec-schema.d.ts","sourceRoot":"","sources":["../../../src/validation/ui-spec-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAErC;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,iBAAiB,EAAE,SA2DtB,CAAC;AAEX,eAAO,MAAM,uBAAuB,EAAE,SA4D5B,CAAC;AAEX,eAAO,MAAM,6BAA6B,EAAE,SAyPlC,CAAC;AAEX,eAAO,MAAM,2BAA2B,EAAE,SA0BhC,CAAC;AAEX,eAAO,MAAM,0BAA0B,EAAE,SAwF/B,CAAC;AAEX,eAAO,MAAM,0BAA0B,EAAE,SA+C/B,CAAC"}