feat: add plugin-api module for external plugin authors

Exports OstToolsPlugin, PluginContext, ParseResult and related types
via ost-tools/plugin-api so external plugins can import the contract
without depending on internal paths.

Also enables declaration emit so .d.ts files are generated on build.

Author: mindsocket

package.json

@@ -12,6 +12,13 @@
     "dist/",
     "schemas/"
   ],
+  "exports": {
+    ".": "./dist/index.js",
+    "./plugin-api": {
+      "types": "./dist/plugin-api.d.ts",
+      "default": "./dist/plugin-api.js"
+    }
+  },
   "scripts": {
     "clean": "rm -rf dist",
     "generate:schema-meta": "bun run scripts/generate-schema-meta.ts",

src/plugin-api.ts

@@ -0,0 +1,26 @@
+/**
+ * Public API for external ost-tools plugins.
+ *
+ * Import from this module to get the types needed to implement an OstToolsPlugin:
+ *
+ *   import type { OstToolsPlugin, PluginContext, ParseResult } from 'ost-tools/plugin-api';
+ */
+
+export type {
+  OstToolsPlugin,
+  ParseHook,
+  ParseResult,
+  PluginContext,
+  TemplateSyncHook,
+  TemplateSyncOptions,
+} from './plugins/util';
+export { resolveNodeType } from './schema/schema';
+export type {
+  EdgeDefinition,
+  HierarchyLevel,
+  Relationship,
+  SchemaMetadata,
+  SpaceContext,
+  SpaceNode,
+  UnresolvedRef,
+} from './types';

tsconfig.json

@@ -13,6 +13,7 @@
     "moduleResolution": "bundler",
     "verbatimModuleSyntax": true,
     "noEmit": false,
+    "declaration": true,
     "outDir": "dist",
     "rootDir": "src",
     "paths": { "@/*": ["./src/*"], "*": ["./*"] },