@fougere/decorators 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fougere contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# @fougere/decorators
+> The configuration sugar
+`@config` — a decorator states a **fact**; it never changes the runtime in a
+non-obvious way.
+
+## Installation
+```bash
+pnpm add @fougere/decorators
+```
+
+---
+
+Part of [Fougere](https://github.com/chok/fougere) — one schema, a gradient from
+monolith to distributed, the same user code.
+Reference documentation: [the site](https://chok.github.io/fougere/) (en/fr).

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * TC39 Stage 3 decorator — marks a class or method as part of the frond's
+ * public contract.
+ *
+ * On a class: sets `__exposed = true` (readable via `isExposed()`).
+ * On a method: collects method name in a WeakMap keyed by class (readable via `getExposedMethods()`).
+ *
+ * This is syntactic sugar — the source of truth for exposure can also be
+ * `defineFrond({ expose: [...] })` in `frond.config.ts`, which takes precedence.
+ */
+export declare function expose(target: Function, context: ClassDecoratorContext): void;
+export declare function expose(target: Function, context: ClassMethodDecoratorContext): void;
+/** Check whether a class has been marked with `@expose`. */
+export declare function isExposed(cls: Function): boolean;
+/** Get method names marked with `@expose` on a class. Requires one instantiation to populate. */
+export declare function getExposedMethods(cls: Function): Set<string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,wBAAgB,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;AAC/E,wBAAgB,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,GAAG,IAAI,CAAC;AAqBrF,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAEhD;AAED,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAM5D"}

package/dist/index.js

@@ -0,0 +1,43 @@
+/**
+ * TC39 Stage 3 decorator — marks a class or method as part of the frond's
+ * public contract.
+ *
+ * On a class: sets `__exposed = true` (readable via `isExposed()`).
+ * On a method: collects method name in a WeakMap keyed by class (readable via `getExposedMethods()`).
+ *
+ * This is syntactic sugar — the source of truth for exposure can also be
+ * `defineFrond({ expose: [...] })` in `frond.config.ts`, which takes precedence.
+ */
+const exposedMethods = new WeakMap();
+export function expose(target, context) {
+    if (context.kind === 'class') {
+        target.__exposed = true;
+    }
+    if (context.kind === 'method') {
+        context.addInitializer(function () {
+            const ctor = this.constructor;
+            let set = exposedMethods.get(ctor);
+            if (!set) {
+                set = new Set();
+                exposedMethods.set(ctor, set);
+            }
+            set.add(context.name);
+        });
+    }
+}
+/** Check whether a class has been marked with `@expose`. */
+export function isExposed(cls) {
+    return cls.__exposed === true;
+}
+/** Get method names marked with `@expose` on a class. Requires one instantiation to populate. */
+export function getExposedMethods(cls) {
+    // Trigger initializers if not already done
+    if (!exposedMethods.has(cls)) {
+        try {
+            new cls();
+        }
+        catch { /* best effort */ }
+    }
+    return exposedMethods.get(cls) ?? new Set();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,cAAc,GAAG,IAAI,OAAO,EAAuB,CAAC;AAI1D,MAAM,UAAU,MAAM,CACpB,MAAgB,EAChB,OAA4D;IAE5D,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,MAAc,CAAC,SAAS,GAAG,IAAI,CAAC;IACnC,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,cAAc,CAAC;YACrB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC;YAC9B,IAAI,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;gBAChB,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAChC,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAc,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,SAAS,CAAC,GAAa;IACrC,OAAQ,GAAW,CAAC,SAAS,KAAK,IAAI,CAAC;AACzC,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,iBAAiB,CAAC,GAAa;IAC7C,2CAA2C;IAC3C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YAAC,IAAK,GAAW,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAU,CAAC;AACtD,CAAC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@fougere/decorators",
+  "version": "0.1.0-alpha.0",
+  "description": "Configuration sugar (@config) — declarative, never hidden runtime.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chok/fougere.git",
+    "directory": "packages/decorators"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit -p tsconfig.test.json"
+  }
+}