@sealcode/sealgen 0.18.10 → 0.19.2

package/@types/page/list.sync-conflict-20250918-222048-TFDLWFG.d.ts

@@ -0,0 +1,48 @@
+import { Context } from "koa";
+import { Templatable, FlatTemplatable } from "tempstream";
+import { Page } from "./page.js";
+import { ShapeToType } from "@sealcode/ts-predicates";
+import { FormControl } from "../forms/controls/controls.js";
+import { FormField } from "../forms/fields/field.js";
+import { NumberField } from "../forms/fields/number.js";
+import { TextBasedSimpleField } from "../forms/fields/simple-form-field.js";
+import { FormDataValue } from "../forms/form-types.js";
+export declare const BasePagePropsShape: {};
+export type BasePageProps = ShapeToType<typeof BasePagePropsShape>;
+export declare const DEFAULT_ITEMS_PER_PAGE = 12;
+export declare const BaseListPageFields: {
+    readonly page: NumberField<1, false>;
+    readonly itemsPerPage: NumberField<12, false>;
+    readonly sort: TextBasedSimpleField<false, import("../forms/controls/simple-input.js").SimpleInput<import("../forms/controls/simple-input.js").SimpleInputOptions>>;
+};
+export type ListSort = {
+    field: string;
+    order: "asc" | "desc";
+};
+export declare abstract class ListPage<ItemType, F extends typeof BaseListPageFields> extends Page<F> {
+    abstract getItems(ctx: Context, page: number, itemsPerPage: number | null, values: Record<string, FormDataValue>): Promise<ItemType[]>;
+    abstract getTotalPages(ctx: Context, itemsPerPage: number, values: Record<string, FormDataValue>): Promise<number>;
+    abstract renderItem(ctx: Context, item: ItemType, index: number): Promise<FlatTemplatable>;
+    filterFields: Record<string, FormField>;
+    filterControls: FormControl[];
+    init(): void;
+    renderListContainer(_: Context, content: Templatable): FlatTemplatable;
+    getPaginationConfig(ctx: Context): Promise<{
+        page: number;
+        itemsPerPage: number | null;
+    }>;
+    renderItems(ctx: Context, values?: Record<string, FormDataValue>, items?: ItemType[]): Promise<FlatTemplatable>;
+    renderPagination(ctx: Context, values: Record<string, FormDataValue>): Promise<FlatTemplatable>;
+    private renderPageButton;
+    getFilterValues(ctx: Context): Promise<Record<string, unknown>>;
+    getSort(ctx: Context): Promise<ListSort | null>;
+    makeSortLink(ctx: Context, field: string, order: "asc" | "desc" | null): string;
+    renderFilters(ctx: Context): Promise<FlatTemplatable>;
+    renderHeading(ctx: Context, field: string, label?: string): Promise<FlatTemplatable>;
+    getDefaultSort(_: Context): ListSort | null;
+    renderTableHead(ctx: Context, fields: {
+        field: string;
+        label?: string;
+    }[]): FlatTemplatable;
+    render(ctx: Context): Promise<FlatTemplatable>;
+}

package/@types/page/mountable-with-fields.d.sync-conflict-20250918-184321-TFDLWFG.ts

@@ -0,0 +1,42 @@
+import { ShapeToType } from "@sealcode/ts-predicates";
+import { Context } from "koa";
+import { FlatTemplatable } from "tempstream";
+import { FormControl, FormControlContext } from "../forms/controls/form-control.js";
+import type { FieldsToShape, FormField } from "../forms/fields/field.js";
+import type { FormDataValue, FormMessage, FormData } from "../forms/form-types.js";
+import { Mountable } from "./mountable.js";
+export type PageErrorMessage = {
+    type: "access" | "internal";
+    message: string;
+};
+export type Fields = Record<string, FormField<boolean, any>>;
+type Resolved<T> = T extends Promise<infer X> ? X : never;
+type ParsedValue<T extends FormField> = Resolved<ReturnType<T["getParsedValue"]>>["parsed"];
+export declare abstract class MountableWithFields<F extends Fields = Fields> extends Mountable {
+    fields: F;
+    field_names_prefix: string;
+    form_id: string;
+    abstract controls: FormControl[];
+    constructor();
+    init(): void;
+    makeFormControlContext(ctx: Context, data: FormData, validate: boolean, field_name_prefix?: string, form_id?: string): FormControlContext;
+    validateValues(_ctx: Context, _data: Record<string, FormDataValue>): Promise<{
+        valid: boolean;
+        error: string;
+    }>;
+    getInitialValues(_ctx: Context): Promise<Record<string, FormDataValue>>;
+    validate(ctx: Context, values: Record<string, FormDataValue>): Promise<{
+        valid: boolean;
+        field_errors: Partial<Record<keyof Fields, string>>;
+        form_messages: FormMessage[];
+    }>;
+    renderControls(fctx: FormControlContext): FlatTemplatable;
+    renderError(_: Context, error: PageErrorMessage): Promise<FlatTemplatable>;
+    renderMessages(_: Context, data: FormData<keyof Fields>): FlatTemplatable;
+    abstract extractRawValues(ctx: Context): Promise<Record<string, FormDataValue>>;
+    getParsedValues(ctx: Context): Promise<{
+        [field in keyof F]: F[field] extends FormField<true> ? Exclude<ParsedValue<F[field]>, null> : ParsedValue<F[field]>;
+    }>;
+    getDatabaseValues(ctx: Context): Promise<ShapeToType<FieldsToShape<F>>>;
+}
+export {};

package/@types/page/mountable-with-fields.d.sync-conflict-20250918-222046-TFDLWFG.ts

@@ -0,0 +1,42 @@
+import { ShapeToType } from "@sealcode/ts-predicates";
+import { Context } from "koa";
+import { FlatTemplatable } from "tempstream";
+import { FormControl, FormControlContext } from "../forms/controls/form-control.js";
+import type { FieldsToShape, FormField } from "../forms/fields/field.js";
+import type { FormDataValue, FormMessage, FormData } from "../forms/form-types.js";
+import { Mountable } from "./mountable.js";
+export type PageErrorMessage = {
+    type: "access" | "internal";
+    message: string;
+};
+export type Fields = Record<string, FormField<boolean, any>>;
+type Resolved<T> = T extends Promise<infer X> ? X : never;
+type ParsedValue<T extends FormField> = Resolved<ReturnType<T["getParsedValue"]>>["parsed"];
+export declare abstract class MountableWithFields<F extends Fields = Fields> extends Mountable {
+    fields: F;
+    field_names_prefix: string;
+    form_id: string;
+    abstract controls: FormControl[];
+    constructor();
+    init(): void;
+    makeFormControlContext(ctx: Context, data: FormData, validate: boolean, field_name_prefix?: string, form_id?: string): FormControlContext;
+    validateValues(_ctx: Context, _data: Record<string, FormDataValue>): Promise<{
+        valid: boolean;
+        error: string;
+    }>;
+    getInitialValues(_ctx: Context): Promise<Record<string, FormDataValue>>;
+    validate(ctx: Context, values: Record<string, FormDataValue>): Promise<{
+        valid: boolean;
+        field_errors: Partial<Record<keyof Fields, string>>;
+        form_messages: FormMessage[];
+    }>;
+    renderControls(fctx: FormControlContext): FlatTemplatable;
+    renderError(_: Context, error: PageErrorMessage): Promise<FlatTemplatable>;
+    renderMessages(_: Context, data: FormData<keyof Fields>): FlatTemplatable;
+    abstract extractRawValues(ctx: Context): Promise<Record<string, FormDataValue>>;
+    getParsedValues(ctx: Context): Promise<{
+        [field in keyof F]: F[field] extends FormField<true> ? Exclude<ParsedValue<F[field]>, null> : ParsedValue<F[field]>;
+    }>;
+    getDatabaseValues(ctx: Context): Promise<ShapeToType<FieldsToShape<F>>>;
+}
+export {};

package/@types/page/mountable-with-fields.d.ts

@@ -1,7 +1,7 @@
 import { ShapeToType } from "@sealcode/ts-predicates";
 import { Context } from "koa";
 import { FlatTemplatable } from "tempstream";
-import { FormControl, FormControlContext } from "../forms/controls/form-control.js";
+import { FieldMessages, FormControl, FormControlContext } from "../forms/controls/form-control.js";
 import type { FieldsToShape, FormField } from "../forms/fields/field.js";
 import type { FormDataValue, FormMessage, FormData } from "../forms/form-types.js";
 import { Mountable } from "./mountable.js";
@@ -11,7 +11,7 @@ export type PageErrorMessage = {
 };
 export type Fields = Record<string, FormField<boolean, any>>;
 type Resolved<T> = T extends Promise<infer X> ? X : never;
-type ParsedValue<T extends FormField> = Resolved<ReturnType<T["getValue"]>>["parsed"];
+type ParsedValue<T extends FormField> = Resolved<ReturnType<T["getParsedValue"]>>["parsed"];
 export declare abstract class MountableWithFields<F extends Fields = Fields> extends Mountable {
     fields: F;
     field_names_prefix: string;
@@ -27,7 +27,7 @@ export declare abstract class MountableWithFields<F extends Fields = Fields> ext
     getInitialValues(_ctx: Context): Promise<Record<string, FormDataValue>>;
     validate(ctx: Context, values: Record<string, FormDataValue>): Promise<{
         valid: boolean;
-        field_errors: Partial<Record<keyof Fields, string>>;
+        field_errors: FieldMessages;
         form_messages: FormMessage[];
     }>;
     renderControls(fctx: FormControlContext): FlatTemplatable;

package/@types/page/mountable-with-fields.sync-conflict-20250918-222044-TFDLWFG.d.ts

@@ -0,0 +1,42 @@
+import { ShapeToType } from "@sealcode/ts-predicates";
+import { Context } from "koa";
+import { FlatTemplatable } from "tempstream";
+import { FieldMessages, FormControl, FormControlContext } from "../forms/controls/form-control.js";
+import type { FieldsToShape, FormField } from "../forms/fields/field.js";
+import type { FormDataValue, FormMessage, FormData } from "../forms/form-types.js";
+import { Mountable } from "./mountable.js";
+export type PageErrorMessage = {
+    type: "access" | "internal";
+    message: string;
+};
+export type Fields = Record<string, FormField<boolean, any>>;
+type Resolved<T> = T extends Promise<infer X> ? X : never;
+type ParsedValue<T extends FormField> = Resolved<ReturnType<T["getParsedValue"]>>["parsed"];
+export declare abstract class MountableWithFields<F extends Fields = Fields> extends Mountable {
+    fields: F;
+    field_names_prefix: string;
+    form_id: string;
+    abstract controls: FormControl[];
+    constructor();
+    init(): void;
+    makeFormControlContext(ctx: Context, data: FormData, validate: boolean, field_messages: FieldMessages, field_name_prefix?: string, form_id?: string): FormControlContext;
+    validateValues(_ctx: Context, _data: Record<string, FormDataValue>): Promise<{
+        valid: boolean;
+        error: string;
+    }>;
+    getInitialValues(_ctx: Context): Promise<Record<string, FormDataValue>>;
+    validate(ctx: Context, values: Record<string, FormDataValue>): Promise<{
+        valid: boolean;
+        field_errors: Partial<Record<keyof Fields, string>>;
+        form_messages: FormMessage[];
+    }>;
+    renderControls(fctx: FormControlContext): FlatTemplatable;
+    renderError(_: Context, error: PageErrorMessage): Promise<FlatTemplatable>;
+    renderMessages(_: Context, data: FormData<keyof Fields>): FlatTemplatable;
+    abstract extractRawValues(ctx: Context): Promise<Record<string, FormDataValue>>;
+    getParsedValues(ctx: Context): Promise<{
+        [field in keyof F]: F[field] extends FormField<true> ? Exclude<ParsedValue<F[field]>, null> : ParsedValue<F[field]>;
+    }>;
+    getDatabaseValues(ctx: Context): Promise<ShapeToType<FieldsToShape<F>>>;
+}
+export {};

package/@types/page/mountable.d.sync-conflict-20250918-184306-TFDLWFG.ts

@@ -0,0 +1,10 @@
+import Router from "@koa/router";
+import { Context } from "koa";
+export declare abstract class Mountable {
+    init(): void;
+    abstract mount(router: Router, path: string): void;
+    abstract canAccess(ctx: Context): Promise<{
+        canAccess: boolean;
+        message: string;
+    }>;
+}

package/@types/page/mountable.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="koa__router" resolution-mode="require"/>
 import Router from "@koa/router";
 import { Context } from "koa";
 export declare abstract class Mountable {

package/@types/page/page.d.sync-conflict-20250918-184320-TFDLWFG.ts

@@ -0,0 +1,18 @@
+import Router from "@koa/router";
+import { Context } from "koa";
+import { FlatTemplatable } from "tempstream";
+import type { FormDataValue } from "../forms/form-types.js";
+import { Fields, MountableWithFields, PageErrorMessage } from "./mountable-with-fields.js";
+import { PagePropsParser } from "./props-parser.js";
+export declare abstract class Page<F extends Fields = Record<string, never>> extends MountableWithFields<F> {
+    propsParser: PagePropsParser<Record<keyof Fields, unknown>>;
+    controls: never[];
+    mount(router: Router, path: string): void;
+    canAccess(_: Context): Promise<{
+        canAccess: boolean;
+        message: string;
+    }>;
+    renderError(_: Context, error: PageErrorMessage): Promise<FlatTemplatable>;
+    abstract render(ctx: Context): Promise<FlatTemplatable>;
+    extractRawValues(ctx: Context): Promise<Record<string, FormDataValue>>;
+}

package/@types/page/page.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="koa__router" resolution-mode="require"/>
 import Router from "@koa/router";
 import { Context } from "koa";
 import { FlatTemplatable } from "tempstream";

package/@types/page/props-parser.d.sync-conflict-20250918-184305-TFDLWFG.ts

@@ -0,0 +1,15 @@
+import { Context } from "koa";
+import { FormDataValue } from "../forms/form-types.js";
+import type { BasePageProps } from "./list.js";
+export type EncodedProps = Record<string, unknown>;
+export declare abstract class PagePropsParser<PropsType> {
+    abstract decode(ctx: Context): Record<string, FormDataValue>;
+    abstract encode(props: Record<string, FormData>): EncodedProps;
+    abstract getHTMLInputName(prop_name: string): string;
+    overwriteProp(ctx: Context, new_props: Partial<PropsType>): EncodedProps;
+}
+export declare class AllQueryParams<PropsType extends BasePageProps> extends PagePropsParser<PropsType> {
+    decode(ctx: Context): Record<string, FormDataValue>;
+    encode(props: PropsType): Record<string, unknown>;
+    getHTMLInputName(prop_name: string): string;
+}

package/@types/page/props-parser.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" resolution-mode="require"/>
 import { Context } from "koa";
 import { FormDataValue } from "../forms/form-types.js";
 import type { BasePageProps } from "./list.js";

package/@types/page/stateful-page.d.sync-conflict-20250918-184326-TFDLWFG.ts

@@ -0,0 +1,62 @@
+import Router from "@koa/router";
+import { Context } from "koa";
+import { Templatable } from "tempstream";
+import { Mountable } from "./mountable.js";
+export type StatefulPageActionDescription<ActionName> = {
+    action: ActionName;
+    label?: string;
+    content?: string;
+    disabled?: boolean;
+} | ActionName;
+export type StateAndMetadata<State, Actions> = {
+    state: State;
+    inputs: Record<string, string>;
+    action: keyof Actions;
+    action_args: string;
+} | {
+    state: State;
+    inputs: Record<string, string>;
+    action: null;
+    action_args: null;
+    $: Record<string, unknown>;
+};
+export type StatefulPageActionArgument<State extends Record<string, unknown>, Args extends unknown[] = unknown[]> = {
+    ctx: Context;
+    state: State;
+    inputs: Record<string, string>;
+    args: Args;
+    page: StatefulPage<any, any>;
+};
+export type StatefulPageAction<State extends Record<string, unknown>, Args extends unknown[] = unknown[]> = (obj: StatefulPageActionArgument<State, Args>) => State | Promise<State>;
+export type ExtractStatefulPageActionArgs<X> = X extends StatefulPageAction<any, infer Args> ? Args : never;
+export declare abstract class StatefulPage<State extends Record<string, unknown>, Actions extends Record<string, StatefulPageAction<State>>> extends Mountable {
+    abstract actions: Actions;
+    abstract getInitialState(ctx: Context): State | Promise<State>;
+    abstract render(ctx: Context, state: State, inputs: Record<string, string>): Templatable | Promise<Templatable>;
+    canAccess(_ctx: Context): Promise<{
+        canAccess: boolean;
+        message: string;
+    }>;
+    constructor();
+    abstract wrapInLayout(ctx: Context, content: Templatable, state: State): Templatable;
+    wrapInForm(context: Context, state: State, content: Templatable): Promise<Templatable>;
+    extractActionAndLabel<ActionName extends keyof Actions>(action_description: StatefulPageActionDescription<ActionName>): {
+        action: string;
+        label: string;
+        content: string;
+        disabled: boolean;
+    };
+    makeActionURL<ActionName extends keyof Actions>(action_description: StatefulPageActionDescription<ActionName>, ...args: ExtractStatefulPageActionArgs<Actions[ActionName]>): string;
+    makeActionButton<ActionName extends keyof Actions>(_state: State, action_description: StatefulPageActionDescription<ActionName>, ...args: ExtractStatefulPageActionArgs<Actions[ActionName]>): string;
+    makeActionCallback<ActionName extends keyof Actions>(action_description: {
+        action: ActionName;
+        label?: string;
+    } | ActionName, ...args: ExtractStatefulPageActionArgs<Actions[ActionName]>): string;
+    rerender(): string;
+    preprocessState(values: State): Promise<State>;
+    preprocessOverrides(_context: Context, _state: State, values: Record<string, unknown>): Promise<Record<string, unknown>>;
+    serializeState(_context: Context, state: State): Promise<string>;
+    deserializeState(_context: Context, s: string): Promise<State>;
+    extractState(ctx: Context): Promise<StateAndMetadata<State, Actions>>;
+    mount(router: Router, path: string): void;
+}

package/@types/page/stateful-page.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="koa__router" resolution-mode="require"/>
 import Router from "@koa/router";
 import { Context } from "koa";
 import { Templatable } from "tempstream";

package/@types/register-external.d.ts

@@ -1,2 +1,2 @@
-export declare function registerExternalControllers(args: Record<string, string | boolean>): Promise<void>;
-export declare function registerExternalStyles(args: Record<string, string | boolean>): Promise<void>;
+export declare function registerExternalControllers(_args: Record<string, string | boolean>): Promise<void>;
+export declare function registerExternalStyles(_args: Record<string, string | boolean>): Promise<void>;

package/@types/templates/form.d.ts

@@ -10,7 +10,5 @@ declare const defaults: {
     other_methods: string;
     success_message: string;
 };
-export declare function formTemplate(action_name: string, newfilefullpath: string, _params?: Partial<typeof defaults> & {
-    success_message: string;
-}): Promise<string>;
+export declare function formTemplate(action_name: string, _params?: Partial<typeof defaults>): Promise<string>;
 export {};

package/@types/templates/jdd-component.d.ts

@@ -1 +1 @@
-export declare function jddComponentTemplate(component_name: string): string;
+export declare function jddComponentTemplate(component_name: string): Promise<string>;

package/@types/templates/page.d.ts

@@ -1 +1 @@
-export declare function pageTemplate(action_name: string, newfilefullpath: string): Promise<string>;
+export declare function pageTemplate(action_name: string): Promise<string>;

package/@types/templates/shared/shared-crud-form-fields.d.sync-conflict-20250918-184306-TFDLWFG.ts

@@ -0,0 +1 @@
+export declare function sharedCrudFormFields(collection_name: string, newfilefullpath: string): Promise<string>;

package/@types/templates/shared/shared-crud-form-fields.d.ts

@@ -1,68 +1 @@
-import { ExtractedFieldInfo } from "../../utils/extract-fields-from-collection.js";
-export type FieldHandlerResult = {
-    imports: Partial<{
-        shared: string;
-        edit: string;
-    }>;
-    hide_field: boolean;
-    field: string;
-    hide_control: boolean;
-    controls: string;
-    is_required: boolean;
-    is_required_expr: string;
-    fields_var: string;
-    top_level_shared: string;
-    name: string;
-    hide_initial_value_edit: boolean;
-    initial_value_edit: Partial<{
-        main_value: string;
-        parsed_value: string;
-        fallback_value: string;
-    }> | string;
-    hide_initial_value_create: boolean;
-    initial_value_create: string;
-    pre_edit: string;
-    post_edit: string;
-    pre_create: string;
-    post_create: string;
-    sealious_value: (result: Exclude<FieldHandlerResult, "sealious_value">) => string;
-    hide_sealious_value: boolean;
-    fallback_value_sealious: string;
-    main_value_sealious: string;
-};
-export type FieldHandler<Defaults extends Partial<FieldHandlerResult>, Result extends Partial<FieldHandlerResult>> = (collection_name: string, field: ExtractedFieldInfo, importPath: (path: string) => string, defaults: Defaults, all_other_handlers: Record<string, FieldHandler<FieldHandlerResult, Partial<FieldHandlerResult>> | undefined>, fields_var?: string) => Promise<Result>;
-export declare const field_handlers: Record<Exclude<string, "default">, FieldHandler<FieldHandlerResult, Partial<FieldHandlerResult>> | undefined> & {
-    default: FieldHandler<Record<string, never>, FieldHandlerResult>;
-};
-export declare function getFieldHandler(collection_name: string, field: ExtractedFieldInfo, importPath: (path: string) => string, fields_var?: string): Promise<{
-    imports: Partial<{
-        shared: string;
-        edit: string;
-    }>;
-    hide_field: boolean;
-    field: string;
-    hide_control: boolean;
-    controls: string;
-    is_required: boolean;
-    is_required_expr: string;
-    fields_var: string;
-    top_level_shared: string;
-    name: string;
-    hide_initial_value_edit: boolean;
-    initial_value_edit: string | Partial<{
-        main_value: string;
-        parsed_value: string;
-        fallback_value: string;
-    }>;
-    hide_initial_value_create: boolean;
-    initial_value_create: string;
-    pre_edit: string;
-    post_edit: string;
-    pre_create: string;
-    post_create: string;
-    sealious_value: (result: FieldHandlerResult) => string;
-    hide_sealious_value: boolean;
-    fallback_value_sealious: string;
-    main_value_sealious: string;
-}>;
-export declare function sharedCrudFormFields(collection_name: string, newfilefullpath: string): Promise<string>;
+export declare function sharedCrudFormFields(collection_name: string): Promise<string>;

package/@types/templates/templates.d.ts

@@ -1,21 +1 @@
-import { formTemplate } from "./form.js";
-import { jddComponentTemplate } from "./jdd-component.js";
-import { LongRunningProcessTemplate } from "./long-running-process.js";
-import { multiformTemplate } from "./multiform.js";
-import { pageTemplate } from "./page.js";
-import { postTemplate } from "./post.js";
-import { redirectTemplate } from "./redirect.js";
-import { statefulPageTemplate } from "./stateful-page.js";
-import { jddEditorTemplate } from "./jdd-editor.js";
-export declare const Templates: {
-    page: typeof pageTemplate;
-    form: typeof formTemplate;
-    list: (action_name: string, newfilefullpath: string) => Promise<string>;
-    multiform: typeof multiformTemplate;
-    redirect: typeof redirectTemplate;
-    post: typeof postTemplate;
-    sreact: typeof statefulPageTemplate;
-    lpr: typeof LongRunningProcessTemplate;
-    jdd: typeof jddComponentTemplate;
-    "jdd-editor": typeof jddEditorTemplate;
-};
+export declare const Templates: Record<string, (action: string, params: any) => Promise<string>>;

package/@types/test_utils/test-on-real-app.d.sync-conflict-20250918-184320-TFDLWFG.ts

@@ -0,0 +1,26 @@
+import EventEmitter from "events";
+export declare const callSealgenBin: () => string;
+export declare class RealAppTest {
+    node_pid: number;
+    app_port: number;
+    mongo_port: number;
+    app_path: string;
+    container_name: string;
+    emitter: EventEmitter<[never]>;
+    static init(): Promise<RealAppTest>;
+    start(): Promise<void>;
+    close(): Promise<void>;
+    runSealgenCommand(command: string): Promise<void>;
+    build(): Promise<void>;
+    throwIfItKillsTheApp<T>(cb: () => Promise<T>): Promise<T>;
+    httpGET(path: string): Promise<{
+        status: number;
+        response: string;
+    }>;
+    httpPOST(path: string, body: Record<string, unknown>): Promise<{
+        status: number;
+        response: string;
+    }>;
+    addFile(target_path: string, content: string): Promise<void>;
+    fullURL(path: string): string;
+}

package/@types/test_utils/test-on-real-app.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" resolution-mode="require"/>
 import EventEmitter from "events";
 export declare const callSealgenBin: () => string;
 export declare class RealAppTest {

package/@types/utils/extract-fields-from-collection.d.sync-conflict-20250918-184312-TFDLWFG.ts

@@ -0,0 +1,18 @@
+import { FormField } from "../forms/fields/field.js";
+export type ExtractedFieldInfo = {
+    name: string;
+    type: string;
+    target: string | null;
+    referencing_collection: string | null;
+    referencing_field: string | null;
+    intermediary_field_that_points_there: string | null;
+    is_readonly: boolean;
+    is_required: boolean;
+    subfields: {
+        name: string;
+    }[];
+};
+export type ExtractedFieldInfoWithFormField = ExtractedFieldInfo & {
+    form_field: FormField;
+};
+export default function extract_fields_from_collection(collection_name: string): Promise<ExtractedFieldInfoWithFormField[]>;

package/@types/utils/extract-fields-from-collection.d.ts

@@ -1,3 +1,4 @@
+import { FormField } from "../forms/fields/field.js";
 export type ExtractedFieldInfo = {
     name: string;
     type: string;
@@ -11,4 +12,7 @@ export type ExtractedFieldInfo = {
         name: string;
     }[];
 };
-export default function extract_fields_from_collection(collection_name: string): Promise<ExtractedFieldInfo[]>;
+export type ExtractedFieldInfoWithFormField = ExtractedFieldInfo & {
+    form_field: FormField;
+};
+export default function extract_fields_from_collection(collection_name: string): Promise<ExtractedFieldInfoWithFormField[]>;

package/@types/utils/extract-fields-from-collection.sync-conflict-20250918-222045-TFDLWFG.d.ts

@@ -0,0 +1,18 @@
+import { FormField } from "../forms/fields/field.js";
+export type ExtractedFieldInfo = {
+    name: string;
+    type: string;
+    target: string | null;
+    referencing_collection: string | null;
+    referencing_field: string | null;
+    intermediary_field_that_points_there: string | null;
+    is_readonly: boolean;
+    is_required: boolean;
+    subfields: {
+        name: string;
+    }[];
+};
+export type ExtractedFieldInfoWithFormField = ExtractedFieldInfo & {
+    form_field: FormField;
+};
+export default function extract_fields_from_collection(collection_name: string): Promise<ExtractedFieldInfoWithFormField[]>;

package/@types/utils/wrap-attributes.d.ts

@@ -0,0 +1,3 @@
+export declare function needsQuotes(str: string): boolean;
+export declare function wrapAttribute(name: string): string;
+export declare function wrapKeyName(name: string): string;

package/README.md

@@ -67,3 +67,8 @@ You can add these commands to your module's `package.json` postinstall script to
 5. If the path is already present, it doesn't add a duplicate
 
 This ensures that when your module is installed as a dependency, the parent project will automatically know where to find your controllers and styles.
+
+
+### Attributions
+
+File icon - Gnome Project

package/assets/file-icon.svg

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg height="128px" viewBox="0 0 128 128" width="128px" xmlns="http://www.w3.org/2000/svg">
+    <path d="m 28 8 h 50 l 30.042969 29.917969 v 74.058593 c 0 4.433594 -3.609375 8.023438 -8.042969 8.023438 h -72 c -4.433594 0 -8 -3.566406 -8 -8 v -96 c 0 -4.433594 3.566406 -8 8 -8 z m 0 0" fill="#f6f5f4"/>
+    <path d="m 78 8 v 22 c 0 4.433594 3.609375 7.921875 8.042969 7.921875 l 22 -0.003906 z m 0 0" fill="#deddda"/>
+</svg>

package/eslint.config.mjs

@@ -0,0 +1,56 @@
+import eslint from "@eslint/js";
+import { defineConfig } from "eslint/config";
+import tseslint from "typescript-eslint";
+import eslintConfigPrettier from "eslint-config-prettier";
+
+export default defineConfig(
+	eslint.configs.recommended,
+	tseslint.configs.recommended,
+	tseslint.configs.recommendedTypeChecked,
+	eslintConfigPrettier,
+	{
+		languageOptions: {
+			parserOptions: {
+				projectService: true,
+				tsconfigRootDir: import.meta.dirname,
+			},
+		},
+	},
+	{
+		rules: {
+			"@typescript-eslint/no-unused-vars": "warn",
+			"prefer-const": "warn",
+			"no-console": ["error", { allow: ["warn", "error", "info"] }],
+			"no-await-in-loop": "error",
+			"@typescript-eslint/require-await": "off",
+			"@typescript-eslint/prefer-promise-reject-errors": "off",
+			"@typescript-eslint/no-unused-vars": [
+				"error",
+				{
+					args: "after-used",
+					argsIgnorePattern: "^_",
+					caughtErrorsIgnorePattern: "^_",
+					destructuredArrayIgnorePattern: "^_",
+					varsIgnorePattern: "^_",
+				},
+			],
+		},
+	},
+	defineConfig({
+		files: ["src/**/*.test.ts"],
+		rules: {
+			"no-empty-pattern": "off",
+			"@typescript-eslint/no-unused-vars": "off",
+			"@typescript-eslint/no-empty-object-type": "off",
+			"@typescript-eslint/no-explicit-any": "off",
+			"prefer-const": "off",
+			"@typescript-eslint/no-unsafe-assignment": "off",
+			"@typescript-eslint/no-unsafe-member-access": "off",
+			"@typescript-eslint/no-unsafe-call": "off",
+			"no-await-in-loop": "off",
+			"@typescript-eslint/no-misused-promises": "off",
+			"@typescript-eslint/no-unsafe-argument": "off",
+			"@typescript-eslint/no-unsafe-return": "off",
+		},
+	})
+);