@fougere/decorators 0.2.0-alpha.1 → 0.4.0-alpha.0

package/README.md

@@ -12,4 +12,4 @@ 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).
+Reference documentation: [the site](https://fougere.dev/) (en/fr).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fougere/decorators",
-  "version": "0.2.0-alpha.1",
+  "version": "0.4.0-alpha.0",
   "description": "Configuration sugar (@config) — declarative, never hidden runtime.",
   "keywords": [
     "fougere",
@@ -25,7 +25,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "src"
   ],
   "publishConfig": {
     "access": "public"

package/src/index.ts

@@ -0,0 +1,48 @@
+/**
+ * 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<object, Set<string>>();
+
+export function expose(target: Function, context: ClassDecoratorContext): void;
+export function expose(target: Function, context: ClassMethodDecoratorContext): void;
+export function expose(
+  target: Function,
+  context: ClassDecoratorContext | ClassMethodDecoratorContext,
+): void {
+  if (context.kind === 'class') {
+    (target as any).__exposed = true;
+  }
+  if (context.kind === 'method') {
+    context.addInitializer(function (this: any) {
+      const ctor = this.constructor;
+      let set = exposedMethods.get(ctor);
+      if (!set) {
+        set = new Set();
+        exposedMethods.set(ctor, set);
+      }
+      set.add(context.name as string);
+    });
+  }
+}
+
+/** Check whether a class has been marked with `@expose`. */
+export function isExposed(cls: Function): boolean {
+  return (cls as any).__exposed === true;
+}
+
+/** Get method names marked with `@expose` on a class. Requires one instantiation to populate. */
+export function getExposedMethods(cls: Function): Set<string> {
+  // Trigger initializers if not already done
+  if (!exposedMethods.has(cls)) {
+    try { new (cls as any)(); } catch { /* best effort */ }
+  }
+  return exposedMethods.get(cls) ?? new Set<string>();
+}