scribe-cms 0.0.17 → 0.0.20

package/dist/studio/introspect-fields.d.ts

@@ -0,0 +1,111 @@
+import type { z } from "zod";
+import { type SchemaFieldMeta } from "../src/core/introspect-schema.js";
+import type { ContentTypeRuntime } from "../src/core/types.js";
+/**
+ * Studio-only schema introspection: extends the core `SchemaFieldMeta` with the
+ * bits the read-only browser needs — enum options and a scalar/filterable
+ * classification — none of which the loader/validator require. Kept generic:
+ * everything is derived from the zod schema, never from a content-type id.
+ */
+export type FilterKind = "enum" | "relation" | "boolean" | "string";
+export interface StudioFieldMeta extends SchemaFieldMeta {
+    /** Enum options, when the peeled leaf schema is a `z.enum`. */
+    enumOptions?: string[];
+    /** True when the peeled leaf schema is a boolean. */
+    isBoolean?: boolean;
+    /** True when the field is a single-value scalar (string/number/enum/boolean, not array/object). */
+    isScalar?: boolean;
+}
+/** Introspect a content schema for the studio: field kinds plus enum/boolean/scalar hints. */
+export declare function introspectStudioFields(schema: z.ZodTypeAny): StudioFieldMeta[];
+export interface FilterFieldMeta {
+    /** Dotted field path (top-level only; no `*` segments). */
+    key: string;
+    kind: FilterKind;
+    /** Enum options for `kind === "enum"`. */
+    enumOptions?: string[];
+    /** Relation target type id for `kind === "relation"`. */
+    relationTarget?: string;
+}
+/**
+ * Filterable fields for a type's collection browser: top-level enum, relation,
+ * boolean and string fields (no nested `*` array fields — those don't map onto a
+ * single query param cleanly). Order follows schema declaration order.
+ */
+export declare function filterFieldsFor(schema: z.ZodTypeAny): FilterFieldMeta[];
+/**
+ * Key fields to preview in the entry table (first few scalar/enum/relation
+ * top-level fields, excluding assets which get their own gallery treatment).
+ * Generic: picks by kind, never by field name.
+ */
+export declare function keyFieldsFor(schema: z.ZodTypeAny, limit?: number): StudioFieldMeta[];
+/** First top-level asset field of a type, if any (the gallery's primary image). */
+export declare function primaryAssetField(schema: z.ZodTypeAny): SchemaFieldMeta | undefined;
+/** Read a frontmatter value at a dotted/`*` path (top-level flat use only). */
+export declare function valueAtPath(frontmatter: Record<string, unknown>, path: string[]): unknown;
+export interface BackRef {
+    /** Type id of the referring entry. */
+    typeId: string;
+    /** EN slug of the referring entry. */
+    enSlug: string;
+    /** Dotted relation field path on the referring entry. */
+    field: string;
+}
+/** `targetTypeId` → `targetEnSlug` → list of entries referencing it. */
+export type BackRefIndex = Map<string, Map<string, BackRef[]>>;
+interface RelationScanInput {
+    typeId: string;
+    enSlug: string;
+    frontmatter: Record<string, unknown>;
+    relationFields: SchemaFieldMeta[];
+    /** MDX body, scanned for `${{relation:...}}` inline tokens. */
+    body?: string;
+}
+/**
+ * Build a reverse-reference index over every relation field of every EN entry:
+ * "which entries point at (targetType, targetSlug)?". Pure over the provided
+ * document snapshots — no filesystem access — so it's unit-testable.
+ */
+export declare function buildBackRefIndex(inputs: RelationScanInput[]): BackRefIndex;
+/** Look up entries referencing a target entry via any relation field. */
+export declare function backRefsFor(index: BackRefIndex, targetType: string, targetSlug: string): BackRef[];
+export interface AssetRef {
+    typeId: string;
+    enSlug: string;
+    /** Dotted field path, or `"body"`/`"frontmatter"` for heuristic matches. */
+    field: string;
+    /** True when the reference comes from a declared `field.asset()` (carries constraints). */
+    declared: boolean;
+    /** Declared field's `maxKB`, when known. */
+    maxKB?: number;
+    /** Declared field's allowed `formats`, when known. */
+    formats?: string[];
+}
+/** web path (source, unresolved) → list of references. */
+export type AssetRefIndex = Map<string, AssetRef[]>;
+interface AssetScanInput {
+    typeId: string;
+    enSlug: string;
+    /** SOURCE (unresolved) frontmatter — declared asset values are raw web paths. */
+    frontmatter: Record<string, unknown>;
+    body: string;
+    assetFields: SchemaFieldMeta[];
+}
+/**
+ * Build the asset reference graph: every declared asset-field value (all types)
+ * plus the heuristic `collectImagePaths` over frontmatter + MDX bodies. Keyed by
+ * source web path. Pure over the provided snapshots — unit-testable.
+ */
+export declare function buildAssetRefIndex(inputs: AssetScanInput[]): AssetRefIndex;
+/**
+ * Read EN docs of every type and build both indexes. Uses the *source*
+ * (unresolved) frontmatter — the studio builds its own preview URLs and never
+ * relies on site-resolved asset URLs. Runtimes here come from `createProject()`
+ * WITHOUT `resolveAssets`, so `frontmatter` already holds source values.
+ */
+export declare function buildIndexes(types: ContentTypeRuntime[]): {
+    backRefs: BackRefIndex;
+    assetRefs: AssetRefIndex;
+};
+export {};
+//# sourceMappingURL=introspect-fields.d.ts.map

package/dist/studio/introspect-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect-fields.d.ts","sourceRoot":"","sources":["../../studio/introspect-fields.ts"],"names":[],"mappings":"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"}

package/dist/studio/mdx-preview.d.ts

@@ -0,0 +1,3 @@
+import type { PreviewToken } from "./preview-tokens.js";
+export declare function renderMdxApprox(markerBody: string, tokens?: PreviewToken[]): string;
+//# sourceMappingURL=mdx-preview.d.ts.map

package/dist/studio/mdx-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdx-preview.d.ts","sourceRoot":"","sources":["../../studio/mdx-preview.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AA2BxD,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,GAAE,YAAY,EAAO,GAAG,MAAM,CAavF"}

package/dist/studio/preview-tokens.d.ts

@@ -0,0 +1,16 @@
+import type { InlineToken } from "../src/inline/tokens.js";
+import type { ScribeConfig, ScribeProject } from "../src/core/types.js";
+export interface PreviewToken {
+    kind: "static" | "relation" | "asset" | "var";
+    raw: string;
+    studioUrl?: string;
+    label?: string;
+    dangling?: boolean;
+    value?: string;
+}
+export declare function buildPreviewTokens(tokens: InlineToken[], opts: {
+    enFrontmatter: Record<string, unknown>;
+    docExists: (typeId: string, enSlug: string) => boolean;
+}): PreviewToken[];
+export declare function makeDocExists(project: ScribeProject, config: ScribeConfig): (typeId: string, enSlug: string) => boolean;
+//# sourceMappingURL=preview-tokens.d.ts.map

package/dist/studio/preview-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-tokens.d.ts","sourceRoot":"","sources":["../../studio/preview-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGxE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,KAAK,CAAC;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAOD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,WAAW,EAAE,EACrB,IAAI,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAA;CAAE,GACvG,YAAY,EAAE,CAwBhB;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,YAAY,GACnB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAK7C"}

package/dist/studio/search.d.ts

@@ -0,0 +1,34 @@
+import type { ScribeDocument } from "../src/core/types.js";
+/** Minimal structural view of the project so the search is unit-testable with fakes. */
+interface SearchableType {
+    id: string;
+    config: {
+        label: string;
+    };
+    list: (locale?: string) => ScribeDocument[];
+}
+interface SearchableProject {
+    listTypes: () => SearchableType[];
+}
+export interface SearchHit {
+    enSlug: string;
+    slug: string;
+    /** Where the first match landed: a frontmatter field path, `"slug"`, or `"body"`. */
+    field: string;
+    /** Escaped snippet (~160 chars) with the first match wrapped in `<mark>`. */
+    snippet: string;
+}
+export interface SearchGroup {
+    typeId: string;
+    label: string;
+    /** Up to `MAX_HITS_PER_TYPE` hits. */
+    hits: SearchHit[];
+    /** Total matching documents in this type (may exceed `hits.length`). */
+    total: number;
+}
+/** Run the search across every type's EN documents. Returns only types with at least one hit. */
+export declare function searchProject(project: SearchableProject, rawQuery: string): SearchGroup[];
+/** Render the full search results page body (the sidebar form lives in the layout). */
+export declare function renderSearchPage(project: SearchableProject, rawQuery: string): string;
+export {};
+//# sourceMappingURL=search.d.ts.map

package/dist/studio/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../studio/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAc3D,wFAAwF;AACxF,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,cAAc,EAAE,CAAC;CAC7C;AACD,UAAU,iBAAiB;IACzB,SAAS,EAAE,MAAM,cAAc,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;CACf;AAwDD,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CAgBzF;AAuBD,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAarF"}