@webda/content-mapper 0.0.0-stage → 4.0.0-beta.5

package/LICENSE

@@ -0,0 +1,166 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.
+

package/lib/coercions.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Defines the widened setter type for a coercible property type.
+ *
+ * When the compiler's morpher transforms `createdAt: Date` into a getter/setter pair,
+ * the setter accepts `string | number | Date`. This registry tells the language service
+ * plugin which types get this treatment, so the IDE can:
+ * - Show the widened setter type on hover
+ * - Suppress false TS2322 errors when assigning e.g. a string to a Date field
+ *
+ * This mirrors the COERCION_REGISTRY in @webda/compiler's accessors.ts.
+ */
+export interface CoercionRule {
+    /** The wider type accepted by the setter (e.g. "string | number | Date" for Date fields). */
+    setterType: string;
+}
+export type CoercionRegistry = Record<string, CoercionRule>;
+/**
+ * Default coercion rules matching @webda/compiler's COERCION_REGISTRY.
+ * Extend via the plugin config in tsconfig.json.
+ */
+export declare const DEFAULT_COERCIONS: CoercionRegistry;
+//# sourceMappingURL=coercions.d.ts.map

package/lib/coercions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coercions.d.ts","sourceRoot":"","sources":["../src/coercions.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,YAAY;IAC3B,6FAA6F;IAC7F,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,gBAI/B,CAAC"}

package/lib/coercions.js

@@ -0,0 +1,10 @@
+/**
+ * Default coercion rules matching @webda/compiler's COERCION_REGISTRY.
+ * Extend via the plugin config in tsconfig.json.
+ */
+export const DEFAULT_COERCIONS = {
+    Date: {
+        setterType: "string | number | Date"
+    }
+};
+//# sourceMappingURL=coercions.js.map

package/lib/coercions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coercions.js","sourceRoot":"","sources":["../src/coercions.ts"],"names":[],"mappings":"AAoBA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAqB;IACjD,IAAI,EAAE;QACJ,UAAU,EAAE,wBAAwB;KACrC;CACF,CAAC"}

package/lib/context.d.ts

@@ -0,0 +1,56 @@
+import type { Node, SourceFile } from "typescript/unstable/ast";
+import type { AnalysisContext } from "./plan.ts";
+/**
+ * Read a node's source text, skipping leading trivia.
+ * @param sf - containing source file
+ * @param node - the node
+ * @returns exact source text
+ */
+export declare function textOf(sf: SourceFile, node: Node): string;
+/**
+ * Read a node's leading trivia (comments), used to find JSDoc tags. The TS7 AST
+ * package exposes no `getJSDocTags` helper, so tags are matched on trivia text.
+ * @param sf - containing source file
+ * @param node - the node
+ * @returns raw trivia text
+ */
+export declare function triviaOf(sf: SourceFile, node: Node): string;
+/**
+ * Names appearing in a class's `extends` clause.
+ * @param sf - containing source file
+ * @param cls - class declaration
+ * @returns base class names, usually one
+ */
+export declare function baseNames(sf: SourceFile, cls: any): string[];
+/** A live analysis session; dispose to shut down the server process. */
+export interface Session {
+    ctx: AnalysisContext;
+    dispose(): void;
+}
+/**
+ * Open a project and build an analysis context over it.
+ * @param configFile - absolute tsconfig path
+ * @param rootDir - source root; only files beneath it are analysed
+ * @param fs - optional virtual filesystem callbacks (used by pass 2)
+ * @returns the session
+ */
+export declare function openSession(configFile: string, rootDir: string, fs?: any): Session;
+/**
+ * Iterate class declarations in a source file.
+ * @param sf - the source file
+ * @returns class declarations
+ */
+export declare function classesOf(sf: SourceFile): any[];
+/**
+ * Member name as written, or undefined for computed names.
+ * @param member - a class element
+ * @returns the member name
+ */
+export declare function memberName(member: any): string | undefined;
+/**
+ * Whether a class element carries the `static` modifier.
+ * @param member - a class element
+ * @returns true when static
+ */
+export declare function isStatic(member: any): boolean;
+//# sourceMappingURL=context.d.ts.map

package/lib/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAGzD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAG3D;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,GAAG,MAAM,EAAE,CAW5D;AAED,wEAAwE;AACxE,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,eAAe,CAAC;IACrB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,GAAG,GAAG,OAAO,CAyBlF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,UAAU,GAAG,GAAG,EAAE,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAG7C"}

package/lib/context.js

@@ -0,0 +1,111 @@
+/**
+ * Builds the typed {@link AnalysisContext} for pass 1.
+ *
+ * This is the part the scanner-based prototype could not do. Detecting the
+ * dominant coercion kinds in this codebase — `ManyToOne` -> `ModelLink` with a
+ * `@WebdaAutoSetter` `set`, and `OneToMany` -> `ModelRelated` — requires
+ * following type aliases through the checker. Roughly 100 such declarations
+ * exist in `the packages source tree` versus ~4 plain `Date` fields, so a syntactic pass
+ * covers the rare case and misses the common one.
+ */
+import { API } from "typescript/unstable/sync";
+import * as is from "typescript/unstable/ast/is";
+/**
+ * Read a node's source text, skipping leading trivia.
+ * @param sf - containing source file
+ * @param node - the node
+ * @returns exact source text
+ */
+export function textOf(sf, node) {
+    const start = typeof node.getStart === "function" ? node.getStart() : node.pos;
+    return sf.text.slice(start, node.end);
+}
+/**
+ * Read a node's leading trivia (comments), used to find JSDoc tags. The TS7 AST
+ * package exposes no `getJSDocTags` helper, so tags are matched on trivia text.
+ * @param sf - containing source file
+ * @param node - the node
+ * @returns raw trivia text
+ */
+export function triviaOf(sf, node) {
+    const start = typeof node.getStart === "function" ? node.getStart() : node.pos;
+    return sf.text.slice(node.pos, start);
+}
+/**
+ * Names appearing in a class's `extends` clause.
+ * @param sf - containing source file
+ * @param cls - class declaration
+ * @returns base class names, usually one
+ */
+export function baseNames(sf, cls) {
+    const out = [];
+    for (const clause of cls.heritageClauses ?? []) {
+        // 95 === SyntaxKind.ExtendsKeyword
+        if (clause.token !== 95)
+            continue;
+        for (const t of clause.types) {
+            const expr = t.expression ?? t;
+            out.push(expr?.text ?? textOf(sf, expr));
+        }
+    }
+    return out;
+}
+/**
+ * Open a project and build an analysis context over it.
+ * @param configFile - absolute tsconfig path
+ * @param rootDir - source root; only files beneath it are analysed
+ * @param fs - optional virtual filesystem callbacks (used by pass 2)
+ * @returns the session
+ */
+export function openSession(configFile, rootDir, fs) {
+    const api = new API({ cwd: rootDir, ...(fs ? { fs } : {}) });
+    const snapshot = api.createSnapshot({ openProjects: [configFile] });
+    const project = snapshot.getProjects()[0];
+    if (!project) {
+        api.close();
+        throw new Error(`No project loaded for ${configFile}`);
+    }
+    const program = project.program;
+    const checker = project.checker;
+    const sourceFiles = [];
+    for (const fileName of program.getSourceFileNames()) {
+        if (!fileName.startsWith(rootDir))
+            continue;
+        if (fileName.endsWith(".d.ts"))
+            continue;
+        const sf = program.getSourceFile(fileName);
+        if (sf)
+            sourceFiles.push(sf);
+    }
+    sourceFiles.sort((a, b) => (a.fileName < b.fileName ? -1 : 1));
+    return {
+        ctx: { project, program, checker, sourceFiles, textOf, triviaOf, baseNames },
+        dispose: () => api.close()
+    };
+}
+/**
+ * Iterate class declarations in a source file.
+ * @param sf - the source file
+ * @returns class declarations
+ */
+export function classesOf(sf) {
+    return sf.statements.filter(s => is.isClassDeclaration(s) && s.name);
+}
+/**
+ * Member name as written, or undefined for computed names.
+ * @param member - a class element
+ * @returns the member name
+ */
+export function memberName(member) {
+    return member?.name?.text;
+}
+/**
+ * Whether a class element carries the `static` modifier.
+ * @param member - a class element
+ * @returns true when static
+ */
+export function isStatic(member) {
+    // 125 === SyntaxKind.StaticKeyword
+    return !!member.modifiers?.some((m) => m.kind === 125);
+}
+//# sourceMappingURL=context.js.map

package/lib/context.js.map

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

package/lib/defaults.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The generator set both hosts run by default.
+ *
+ * One list, not two. The editor ({@link WarmSession}) and the build
+ * ({@link runTwoPass}) must produce the same text, or hover and diagnostics
+ * describe code that is not the code that ships. Keeping two literal lists
+ * equal by hand is exactly how that drifts.
+ *
+ * `loadParametersGenerator` is deliberately **not** here. Nothing in the
+ * framework calls `loadParameters`: a service's parameters are built by
+ * `createConfiguration`, which `Application` installs from the
+ * `Configuration` entry in `webda.module.json`. The TypeScript 6 pipeline
+ * never generated it either — that was `webdac code`, which walked zero
+ * files. Generating it would add a dead method to every service and break
+ * emit parity with what ships today. It stays exported for callers who
+ * still want it.
+ */
+import { type AccessorOptions } from "./generators/accessors.ts";
+import type { Generator } from "./plan.ts";
+/** Options the default generators accept. */
+export interface DefaultGeneratorOptions extends AccessorOptions {
+    /** Module specifier providing the WebdaQL `escape` helper. */
+    qlModule?: string;
+}
+/**
+ * Build the default generator set.
+ * @param options - storage and WebdaQL module specifiers
+ * @returns the generators, in the order they run
+ */
+export declare function defaultGenerators(options?: DefaultGeneratorOptions): Generator[];
+//# sourceMappingURL=defaults.d.ts.map

package/lib/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGrF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,6CAA6C;AAC7C,MAAM,WAAW,uBAAwB,SAAQ,eAAe;IAC9D,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,uBAA4B,GAAG,SAAS,EAAE,CAMpF"}

package/lib/defaults.js

@@ -0,0 +1,33 @@
+/**
+ * The generator set both hosts run by default.
+ *
+ * One list, not two. The editor ({@link WarmSession}) and the build
+ * ({@link runTwoPass}) must produce the same text, or hover and diagnostics
+ * describe code that is not the code that ships. Keeping two literal lists
+ * equal by hand is exactly how that drifts.
+ *
+ * `loadParametersGenerator` is deliberately **not** here. Nothing in the
+ * framework calls `loadParameters`: a service's parameters are built by
+ * `createConfiguration`, which `Application` installs from the
+ * `Configuration` entry in `webda.module.json`. The TypeScript 6 pipeline
+ * never generated it either — that was `webdac code`, which walked zero
+ * files. Generating it would add a dead method to every service and break
+ * emit parity with what ships today. It stays exported for callers who
+ * still want it.
+ */
+import { accessorsGenerator } from "./generators/accessors.js";
+import { behaviorsGenerator } from "./generators/behaviors.js";
+import { qlValidatorGenerator } from "./generators/qlvalidator.js";
+/**
+ * Build the default generator set.
+ * @param options - storage and WebdaQL module specifiers
+ * @returns the generators, in the order they run
+ */
+export function defaultGenerators(options = {}) {
+    return [
+        accessorsGenerator({ accessorsForAll: options.accessorsForAll, storageModule: options.storageModule }),
+        behaviorsGenerator({ storageModule: options.storageModule }),
+        qlValidatorGenerator({ qlModule: options.qlModule })
+    ];
+}
+//# sourceMappingURL=defaults.js.map

package/lib/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,kBAAkB,EAAwB,MAAM,2BAA2B,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AASnE;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAO,GAA4B,EAAE;IACrE,OAAO;QACL,kBAAkB,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;QACtG,kBAAkB,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC;QAC5D,oBAAoB,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;KACrD,CAAC;AACJ,CAAC"}

package/lib/generators/accessors.d.ts

@@ -0,0 +1,15 @@
+import type { Generator } from "../plan.ts";
+/** Options for the accessor generator. */
+export interface AccessorOptions {
+    /** Treat every class as eligible, not just models. */
+    accessorsForAll?: boolean;
+    /** Module specifier providing `WEBDA_STORAGE`. */
+    storageModule?: string;
+}
+/**
+ * Create the accessor generator.
+ * @param options - generator options
+ * @returns a generator
+ */
+export declare function accessorsGenerator(options?: AccessorOptions): Generator;
+//# sourceMappingURL=accessors.d.ts.map

package/lib/generators/accessors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessors.d.ts","sourceRoot":"","sources":["../../src/generators/accessors.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAoC,SAAS,EAAE,MAAM,YAAY,CAAC;AAwF9E,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAmWD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,eAAoB,GAAG,SAAS,CA2J3E"}