@lexd/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Harvey Randall
+
+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/dist/ast.d.ts

@@ -0,0 +1,121 @@
+/** Source location for diagnostics. */
+export interface SourceSpan {
+    startOffset: number;
+    endOffset: number;
+    startLine: number;
+    startColumn: number;
+    endLine: number;
+    endColumn: number;
+}
+export interface AstNode {
+    span?: SourceSpan;
+}
+export type AttrValue = string | number | boolean | Array<string | number | boolean>;
+export interface Attribute extends AstNode {
+    name: string;
+    args: AttrValue[];
+}
+export type TypeExpr = {
+    kind: 'primitive';
+    name: PrimitiveName;
+    span?: SourceSpan;
+} | {
+    kind: 'array';
+    element: TypeExpr;
+    span?: SourceSpan;
+} | {
+    kind: 'ref';
+    name: string;
+    span?: SourceSpan;
+} | {
+    kind: 'union';
+    refs: TypeExpr[];
+    closed?: boolean;
+    span?: SourceSpan;
+} | {
+    kind: 'inline';
+    fields: Field[];
+    span?: SourceSpan;
+};
+export type PrimitiveName = 'string' | 'integer' | 'boolean' | 'bytes' | 'cid-link' | 'blob' | 'unknown';
+export interface Field extends AstNode {
+    name: string;
+    optional: boolean;
+    type: TypeExpr;
+    attributes: Attribute[];
+}
+export interface ErrorDecl extends AstNode {
+    name: string;
+    description?: string;
+}
+export type SchemaBody = {
+    kind: 'inline';
+    fields: Field[];
+} | {
+    kind: 'type';
+    type: TypeExpr;
+};
+export interface IoBlock extends AstNode {
+    kind: 'input' | 'output';
+    encoding?: string;
+    schema?: SchemaBody;
+    description?: string;
+}
+export interface ParamsBlock extends AstNode {
+    kind: 'params';
+    fields: Field[];
+}
+export interface MessageBlock extends AstNode {
+    kind: 'message';
+    schema: TypeExpr;
+    description?: string;
+}
+export interface ErrorsBlock extends AstNode {
+    kind: 'errors';
+    errors: ErrorDecl[];
+}
+export interface PermissionEntry extends AstNode {
+    resource: 'rpc' | 'repo';
+    /** string props: aud; boolean: inheritAud; string[]: lxm, collection, action */
+    props: Record<string, string | boolean | string[]>;
+}
+export interface PermissionsBlock extends AstNode {
+    kind: 'permissions';
+    entries: PermissionEntry[];
+}
+export type TypeBlock = ParamsBlock | IoBlock | MessageBlock | ErrorsBlock | PermissionsBlock;
+export interface TypeDecl extends AstNode {
+    name: string;
+    attributes: Attribute[];
+    /** object/record field body */
+    fields: Field[];
+    /** XRPC / permission-set sections */
+    blocks: TypeBlock[];
+    /** True when annotated with a primary attr */
+    primary: boolean;
+    /** True when @token */
+    isToken: boolean;
+    /** True when @scalar(...) */
+    isScalar: boolean;
+}
+export interface NamespaceDecl extends AstNode {
+    name: string;
+    types: TypeDecl[];
+}
+export interface ImportDecl extends AstNode {
+    module: string;
+    kind: 'named' | 'whole';
+    bindings: Array<{
+        local: string;
+        imported: string;
+    }>;
+}
+export interface LexdFile extends AstNode {
+    imports: ImportDecl[];
+    namespaces: NamespaceDecl[];
+    filename?: string;
+}
+export declare const PRIMITIVES: Set<string>;
+export declare const PRIMARY_ATTRS: Set<string>;
+export declare const SECTION_NAMES: Set<string>;
+//# sourceMappingURL=ast.d.ts.map

package/dist/ast.d.ts.map

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

package/dist/ast.js

@@ -0,0 +1,26 @@
+export const PRIMITIVES = new Set([
+    'string',
+    'integer',
+    'boolean',
+    'bytes',
+    'cid-link',
+    'blob',
+    'unknown',
+]);
+export const PRIMARY_ATTRS = new Set([
+    'record',
+    'object',
+    'query',
+    'procedure',
+    'subscription',
+    'permissionSet',
+]);
+export const SECTION_NAMES = new Set([
+    'params',
+    'input',
+    'output',
+    'message',
+    'errors',
+    'permissions',
+]);
+//# sourceMappingURL=ast.js.map

package/dist/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../src/ast.ts"],"names":[],"mappings":"AAiIA,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS;IACxC,QAAQ;IACR,SAAS;IACT,SAAS;IACT,OAAO;IACP,UAAU;IACV,MAAM;IACN,SAAS;CACV,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IACnC,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,WAAW;IACX,cAAc;IACd,eAAe;CAChB,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IACnC,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,aAAa;CACd,CAAC,CAAA"}

package/dist/codegen.d.ts

@@ -0,0 +1,25 @@
+import type { LexiconDoc } from './lexicon.js';
+export interface LexCodegenOptions {
+    /** Directory where generated artifacts should be written. */
+    outDir: string;
+}
+export interface LexCodegenArtifact {
+    /** Path relative to outDir */
+    path: string;
+    /** File contents */
+    content: string;
+}
+export interface LexCodegenPlan {
+    artifacts: LexCodegenArtifact[];
+}
+/**
+ * Plan codegen output from compiled lexicon documents.
+ * Consumers can write `artifacts` to disk or pipe them to @atproto/lex tooling.
+ */
+export declare function planLexCodegen(docs: LexiconDoc[], _options: LexCodegenOptions): LexCodegenPlan;
+/**
+ * Optional hook for delegating to @atproto/lex-cli when installed in the host project.
+ * Returns false when the package is unavailable so callers can fall back to planLexCodegen.
+ */
+export declare function tryAtprotoLexCodegen(docs: LexiconDoc[], options: LexCodegenOptions): Promise<LexCodegenPlan | false>;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAE9C,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,kBAAkB,EAAE,CAAA;CAChC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,iBAAiB,GAAG,cAAc,CAO9F;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,UAAU,EAAE,EAClB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,cAAc,GAAG,KAAK,CAAC,CAWjC"}

package/dist/codegen.js

@@ -0,0 +1,30 @@
+/**
+ * Plan codegen output from compiled lexicon documents.
+ * Consumers can write `artifacts` to disk or pipe them to @atproto/lex tooling.
+ */
+export function planLexCodegen(docs, _options) {
+    const artifacts = docs.map((doc) => ({
+        path: `${doc.id.replaceAll('.', '/')}.json`,
+        content: `${JSON.stringify(doc, null, 2)}\n`,
+    }));
+    return { artifacts };
+}
+/**
+ * Optional hook for delegating to @atproto/lex-cli when installed in the host project.
+ * Returns false when the package is unavailable so callers can fall back to planLexCodegen.
+ */
+export async function tryAtprotoLexCodegen(docs, options) {
+    let mod;
+    try {
+        const specifier = '@atproto/lex-cli';
+        mod = (await import(specifier));
+    }
+    catch {
+        return false;
+    }
+    if (typeof mod.generate !== 'function')
+        return false;
+    await mod.generate(docs, { outDir: options.outDir });
+    return { artifacts: [] };
+}
+//# sourceMappingURL=codegen.js.map

package/dist/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.js","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAkB,EAAE,QAA2B;IAC5E,MAAM,SAAS,GAAyB,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACzD,IAAI,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO;QAC3C,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;KAC7C,CAAC,CAAC,CAAA;IAEH,OAAO,EAAE,SAAS,EAAE,CAAA;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAkB,EAClB,OAA0B;IAE1B,IAAI,GAAmF,CAAA;IACvF,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,kBAAkB,CAAA;QACpC,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAe,CAAA;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;IACD,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,UAAU;QAAE,OAAO,KAAK,CAAA;IACpD,MAAM,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACpD,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAA;AAC1B,CAAC"}

package/dist/decompile.d.ts

@@ -0,0 +1,11 @@
+import type { LexiconDoc } from './lexicon.js';
+export declare function lastSegment(nsid: string): string;
+export declare function toPascalCase(segment: string): string;
+/**
+ * Decompile a Lexicon JSON document to `.lexd` source.
+ * Formatting is deterministic (2-space indent, stable attribute order).
+ */
+export declare function decompile(doc: LexiconDoc): string;
+/** Read a lexicon JSON file and decompile to `.lexd` source. */
+export declare function decompileFile(path: string): string;
+//# sourceMappingURL=decompile.d.ts.map

package/dist/decompile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decompile.d.ts","sourceRoot":"","sources":["../src/decompile.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAeV,UAAU,EACX,MAAM,cAAc,CAAA;AAsCrB,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD;AAQD,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGpD;AAifD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAkEjD;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD"}