@stonecrop/schema 0.31.0 → 0.32.0

package/dist/src/naming.js

@@ -1,106 +0,0 @@
-/**
- * Naming Convention Utilities
- * Converts between various naming conventions (snake_case, camelCase, PascalCase, kebab-case)
- * @packageDocumentation
- */
-/**
- * Converts snake_case to camelCase
- * @param snakeCase - Snake case string
- * @returns Camel case string
- * @public
- * @example
- * ```typescript
- * snakeToCamel('user_email') // 'userEmail'
- * snakeToCamel('created_at') // 'createdAt'
- * ```
- */
-export function snakeToCamel(snakeCase) {
-    return snakeCase.replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
-}
-/**
- * Converts camelCase to snake_case
- * @param camelCase - Camel case string
- * @returns Snake case string
- * @public
- * @example
- * ```typescript
- * camelToSnake('userEmail') // 'user_email'
- * camelToSnake('createdAt') // 'created_at'
- * ```
- */
-export function camelToSnake(camelCase) {
-    return camelCase.replace(/[A-Z]/g, letter => `_${letter.toLowerCase()}`);
-}
-/**
- * Converts snake_case to Title Case label
- * @param snakeCase - Snake case string
- * @returns Title case label
- * @public
- * @example
- * ```typescript
- * snakeToLabel('user_email') // 'User Email'
- * snakeToLabel('first_name') // 'First Name'
- * ```
- */
-export function snakeToLabel(snakeCase) {
-    return snakeCase
-        .split('_')
-        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
-        .join(' ');
-}
-/**
- * Converts camelCase to Title Case label
- * @param camelCase - Camel case string
- * @returns Title case label
- * @public
- * @example
- * ```typescript
- * camelToLabel('userEmail') // 'User Email'
- * camelToLabel('firstName') // 'First Name'
- * ```
- */
-export function camelToLabel(camelCase) {
-    const withSpaces = camelCase.replace(/([A-Z])/g, ' $1').trim();
-    return withSpaces.charAt(0).toUpperCase() + withSpaces.slice(1);
-}
-/**
- * Convert table name to PascalCase doctype name
- * @param tableName - SQL table name (snake_case)
- * @returns PascalCase name
- * @public
- */
-export function toPascalCase(tableName) {
-    return tableName
-        .split(/[-_\s]+/)
-        .map(word => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
-        .join('');
-}
-/**
- * Convert to kebab-case slug
- * @param name - Name to convert
- * @returns kebab-case slug
- * @public
- */
-export function toSlug(name) {
-    return name
-        .replace(/([a-z])([A-Z])/g, '$1-$2')
-        .replace(/[\s_]+/g, '-')
-        .toLowerCase();
-}
-/**
- * Convert PascalCase to snake_case (e.g., for deriving table names from type names)
- * @param pascal - PascalCase string
- * @returns snake_case string
- * @public
- * @example
- * ```typescript
- * pascalToSnake('SalesOrder') // 'sales_order'
- * pascalToSnake('SalesOrderItem') // 'sales_order_item'
- * ```
- */
-export function pascalToSnake(pascal) {
-    return pascal
-        .replace(/([a-z])([A-Z])/g, '$1_$2')
-        .replace(/[\s-]+/g, '_')
-        .toLowerCase();
-}

package/dist/src/record.d.ts

@@ -1,29 +0,0 @@
-import type { DoctypeField } from './field';
-/**
- * Reduce a record's *inline* link values to the ids that get persisted.
- *
- * The adapter returns an inline link as `{ id, displayText }`, so that is what a record holds
- * everywhere it is read — the store, a list row, a form field. A column takes the id alone, so
- * this is the single definition of the shape a record leaves in, and it belongs at the boundary
- * a record crosses on its way to the server, never on the way into the store.
- *
- * Doing it on the way in destroys the text the adapter looked up: nothing else holds it, so the
- * field that resolved a moment ago renders its raw id, and the same record then renders
- * differently depending on whether anything had edited the form yet. That is the bug this exists
- * to prevent, and its damage is a wrong render, not a throw.
- *
- * Only *inline* links may be reduced. An inline link's value is indistinguishable by inspection
- * from an expanded one (`{ id, ...the whole target record }`), so `component` — which states
- * which of the two a field is — is what tells them apart, via {@link componentLinkExpansion}.
- * Reducing an expanded link would send the id in place of the record.
- *
- * Fieldsets are descended into in both shapes a record appears in: flat, as the store and the
- * server hold it, and nested under the fieldset's own key, as a form emits it.
- *
- * @param fields - the doctype's top-level fields
- * @param record - the record to reduce; not mutated
- * @returns a shallow copy with every inline link reduced to its id
- * @public
- */
-export declare function unwrapInlineLinks(fields: readonly DoctypeField[], record: Record<string, any>): Record<string, any>;
-//# sourceMappingURL=record.d.ts.map

package/dist/src/record.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/record.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAG3C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAWnH"}

package/dist/src/record.js

@@ -1,55 +0,0 @@
-import { componentLinkExpansion } from './component-meta';
-import { flattenFields } from './flatten';
-/**
- * Reduce a record's *inline* link values to the ids that get persisted.
- *
- * The adapter returns an inline link as `{ id, displayText }`, so that is what a record holds
- * everywhere it is read — the store, a list row, a form field. A column takes the id alone, so
- * this is the single definition of the shape a record leaves in, and it belongs at the boundary
- * a record crosses on its way to the server, never on the way into the store.
- *
- * Doing it on the way in destroys the text the adapter looked up: nothing else holds it, so the
- * field that resolved a moment ago renders its raw id, and the same record then renders
- * differently depending on whether anything had edited the form yet. That is the bug this exists
- * to prevent, and its damage is a wrong render, not a throw.
- *
- * Only *inline* links may be reduced. An inline link's value is indistinguishable by inspection
- * from an expanded one (`{ id, ...the whole target record }`), so `component` — which states
- * which of the two a field is — is what tells them apart, via {@link componentLinkExpansion}.
- * Reducing an expanded link would send the id in place of the record.
- *
- * Fieldsets are descended into in both shapes a record appears in: flat, as the store and the
- * server hold it, and nested under the fieldset's own key, as a form emits it.
- *
- * @param fields - the doctype's top-level fields
- * @param record - the record to reduce; not mutated
- * @returns a shallow copy with every inline link reduced to its id
- * @public
- */
-export function unwrapInlineLinks(fields, record) {
-    const inline = new Set(flattenFields(fields)
-        .filter(field => field.kind === 'field' && Boolean(field.doctype))
-        .filter(field => componentLinkExpansion(field.component) === 'inline')
-        .map(field => field.fieldname));
-    if (inline.size === 0)
-        return record;
-    const fieldsets = new Set(fields.filter(field => field.kind === 'fieldset').map(field => field.fieldname));
-    return unwrapWith(inline, fieldsets, record);
-}
-function unwrapWith(inline, fieldsets, record) {
-    const result = { ...record };
-    for (const [key, value] of Object.entries(result)) {
-        if (value === null || typeof value !== 'object' || Array.isArray(value))
-            continue;
-        if (inline.has(key)) {
-            // `'id' in value` rather than a truthiness test: an inline link that was never resolved
-            // is still a bare scalar, and reducing it a second time would be a no-op at best.
-            if ('id' in value)
-                result[key] = value.id;
-        }
-        else if (fieldsets.has(key)) {
-            result[key] = unwrapWith(inline, fieldsets, value);
-        }
-    }
-    return result;
-}

package/dist/src/table.d.ts

@@ -1,33 +0,0 @@
-import { z } from 'zod';
-/**
- * JSON-safe view configuration for table fields in doctype authoring.
- *
- * This is the authoring-time subset of `@stonecrop/atable`'s `TableConfig`. It covers
- * the view discriminator and structural options that can be expressed in static JSON.
- * `rowActions` (which requires function-typed handlers) stays in the runtime `TableConfig`.
- *
- * @public
- */
-export declare const TableViewConfig: z.ZodObject<{
-    view: z.ZodOptional<z.ZodEnum<{
-        list: "list";
-        uncounted: "uncounted";
-        "list-expansion": "list-expansion";
-        tree: "tree";
-        gantt: "gantt";
-        "tree-gantt": "tree-gantt";
-    }>>;
-    fullWidth: z.ZodOptional<z.ZodBoolean>;
-    defaultTreeExpansion: z.ZodOptional<z.ZodEnum<{
-        root: "root";
-        branch: "branch";
-        leaf: "leaf";
-    }>>;
-    dependencyGraph: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>;
-/**
- * Table view configuration type inferred from Zod schema
- * @public
- */
-export type TableViewConfig = z.infer<typeof TableViewConfig>;
-//# sourceMappingURL=table.d.ts.map

package/dist/src/table.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/table.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;iBAiBzB,CAAA;AAEH;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA"}

package/dist/src/table.js

@@ -1,25 +0,0 @@
-import { z } from 'zod';
-/**
- * JSON-safe view configuration for table fields in doctype authoring.
- *
- * This is the authoring-time subset of `@stonecrop/atable`'s `TableConfig`. It covers
- * the view discriminator and structural options that can be expressed in static JSON.
- * `rowActions` (which requires function-typed handlers) stays in the runtime `TableConfig`.
- *
- * @public
- */
-export const TableViewConfig = z
-    .object({
-    /** The table view type */
-    view: z.enum(['list', 'uncounted', 'list-expansion', 'tree', 'gantt', 'tree-gantt']).optional(),
-    /** Allow the table to use the full width of its container */
-    fullWidth: z.boolean().optional(),
-    /** Default expansion state for tree views */
-    defaultTreeExpansion: z.enum(['root', 'branch', 'leaf']).optional(),
-    /** Enable dependency graph connections for Gantt views */
-    dependencyGraph: z.boolean().optional(),
-})
-    .meta({
-    title: 'TableViewConfig',
-    description: 'JSON-safe view configuration for table fields in doctype authoring',
-});

package/dist/src/validation.d.ts

@@ -1,54 +0,0 @@
-import { DoctypeMeta } from './doctype';
-/**
- * Validation error with path information
- * @public
- */
-export interface ValidationError {
-    /** Path to the invalid property */
-    path: PropertyKey[];
-    /** Error message */
-    message: string;
-}
-/**
- * Result of a validation operation
- * @public
- */
-export interface ValidationResult {
-    /** Whether validation passed */
-    success: boolean;
-    /** List of validation errors (empty if success) */
-    errors: ValidationError[];
-}
-/**
- * Validate a field definition against the DoctypeField discriminated union
- * @param data - Data to validate
- * @returns Validation result
- * @public
- */
-export declare function validateField(data: unknown): ValidationResult;
-/**
- * Validate a doctype definition
- * @param data - Data to validate
- * @returns Validation result
- * @public
- */
-export declare function validateDoctype(data: unknown): ValidationResult;
-/**
- * Parse and validate a field, throwing on failure
- * @param data - Data to parse
- * @returns Validated DoctypeField
- * @throws ZodError if validation fails
- * @public
- */
-export declare function parseField(data: unknown): import('./field').DoctypeField;
-/**
- * Parse and validate a doctype, throwing on failure
- * @param data - Data to parse
- * @returns Validated DoctypeMeta
- * @throws ZodError if validation fails
- * @public
- */
-export declare function parseDoctype(data: unknown): DoctypeMeta;
-export type { DoctypeField, ValueField, FieldsetField, TableField } from './field';
-export type { DoctypeMeta } from './doctype';
-//# sourceMappingURL=validation.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAEvC;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC/B,mCAAmC;IACnC,IAAI,EAAE,WAAW,EAAE,CAAA;IAEnB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAChC,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAA;IAEhB,mDAAmD;IACnD,MAAM,EAAE,eAAe,EAAE,CAAA;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAc7D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAc/D;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,SAAS,EAAE,YAAY,CAExE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAEvD;AAGD,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAClF,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA"}

package/dist/src/validation.js

@@ -1,60 +0,0 @@
-import { DoctypeFieldSchema } from './field';
-import { DoctypeMeta } from './doctype';
-/**
- * Validate a field definition against the DoctypeField discriminated union
- * @param data - Data to validate
- * @returns Validation result
- * @public
- */
-export function validateField(data) {
-    const result = DoctypeFieldSchema.safeParse(data);
-    if (result.success) {
-        return { success: true, errors: [] };
-    }
-    return {
-        success: false,
-        errors: result.error.issues.map(issue => ({
-            path: issue.path,
-            message: issue.message,
-        })),
-    };
-}
-/**
- * Validate a doctype definition
- * @param data - Data to validate
- * @returns Validation result
- * @public
- */
-export function validateDoctype(data) {
-    const result = DoctypeMeta.safeParse(data);
-    if (result.success) {
-        return { success: true, errors: [] };
-    }
-    return {
-        success: false,
-        errors: result.error.issues.map(issue => ({
-            path: issue.path,
-            message: issue.message,
-        })),
-    };
-}
-/**
- * Parse and validate a field, throwing on failure
- * @param data - Data to parse
- * @returns Validated DoctypeField
- * @throws ZodError if validation fails
- * @public
- */
-export function parseField(data) {
-    return DoctypeFieldSchema.parse(data);
-}
-/**
- * Parse and validate a doctype, throwing on failure
- * @param data - Data to parse
- * @returns Validated DoctypeMeta
- * @throws ZodError if validation fails
- * @public
- */
-export function parseDoctype(data) {
-    return DoctypeMeta.parse(data);
-}