@alisio/plugin-thesis 0.1.0

package/dist/styles/profile.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Declarative presentation profiles (spec 10.4.1). A profile is format-neutral data with a closed
+ * schema: no raw Typst, no code. Shipped profiles live in `templates/profiles/*.profile.yaml`;
+ * workspace profiles in `thesis/styles/*.profile.yaml` may `extends` a shipped one and override
+ * any key. Each output adapter maps the resolved profile to its own settings (the Typst adapter
+ * does it in `adapters/typst-pdf/profile.ts`); nothing here mentions a concrete format.
+ */
+export type Length = string;
+export type Align = "left" | "center" | "right";
+export type CoverField = "institution" | "faculty" | "program" | "title" | "subtitle" | "workType" | "authors" | "advisors" | "cityYear";
+export type FrontPart = "dedication" | "acknowledgments" | "ai-declaration" | "abstract" | "toc";
+export interface HeadingStyle {
+    size: number;
+    weight: "regular" | "bold";
+    case: "none" | "upper" | "lower";
+    /** Counter pattern for the heading number, for example `1.1`. */
+    numbering: string;
+    align: "left" | "center";
+    spaceBefore: Length;
+    spaceAfter: Length;
+    newPage: boolean;
+    /** The heading runs into the first line of the following paragraph. */
+    runIn: boolean;
+    /** Text appended to the title, for example `.` for run-in headings. */
+    endsWith: string;
+}
+export interface PresentationProfile {
+    id: string;
+    extends: string | null;
+    paper: "letter" | "a4" | null;
+    margins: {
+        top: Length;
+        bottom: Length;
+        inside: Length;
+        outside: Length;
+    };
+    binding: "left" | "mirrored";
+    font: {
+        body: string | null;
+        headings: string | null;
+        mono: string | null;
+        size: number;
+    };
+    lineSpacing: number;
+    paragraph: {
+        indent: Length;
+        spacing: Length;
+        justify: boolean;
+    };
+    /** Always four entries, level 1 first. */
+    headings: HeadingStyle[];
+    captions: {
+        figurePosition: "top" | "bottom";
+        tablePosition: "top" | "bottom";
+        labelStyle: "plain" | "bold" | "italic";
+        separator: string;
+        sourceBelow: boolean;
+        numbering: "chapter" | "continuous";
+    };
+    pageNumbers: {
+        front: "roman" | "arabic" | "none";
+        body: "arabic" | "none";
+        position: Align;
+        /** Numbering continues from the cover instead of restarting in each part. */
+        continuous: boolean;
+    };
+    cover: {
+        fields: CoverField[];
+        layout: "centered" | "left";
+    };
+    frontMatter: FrontPart[];
+    footnotes: {
+        size: number;
+    };
+    toc: {
+        depth: 1 | 2 | 3 | 4;
+        pageLabel: boolean;
+    };
+    header: "chapter" | "none";
+    annexNumbering: string;
+    /** Rule ids that justify values, for traceability comments. */
+    ruleIds: string[];
+}
+export interface ProfileIssue {
+    code: "PRF-001";
+    /** Dotted path of the offending key. */
+    path: string;
+    message: string;
+}
+/** A partially specified profile as written in YAML, after validation. */
+export type ProfileInput = Record<string, unknown>;
+/** Validate a parsed YAML document against the closed profile schema (PRF-001). */
+export declare function validateProfile(raw: unknown): {
+    input: ProfileInput;
+    issues: ProfileIssue[];
+    ruleIds: string[];
+};
+export interface ParsedProfile {
+    input?: ProfileInput;
+    ruleIds: string[];
+    issues: ProfileIssue[];
+}
+/** Parse profile YAML text. Anchors, merge keys and custom tags are refused (no aliasing games). */
+export declare function parseProfileText(text: string): ParsedProfile;
+/** Ids of the profiles shipped in `templates/profiles/`. */
+export declare function shippedProfileIds(): string[];
+/**
+ * Load a shipped profile by id. A shipped profile is a complete one (every key present) or it
+ * extends another shipped profile; either way the result is fully populated.
+ */
+export declare function loadShippedProfile(id: string): PresentationProfile | undefined;
+/** The root of every `extends` chain: a plain, conservative thesis layout. */
+export declare function baseline(): PresentationProfile;
+export interface WorkspaceProfileFile {
+    /** File stem, which is the profile id. */
+    id: string;
+    file: string;
+    text: string;
+}
+export interface ResolvedWorkspaceProfile {
+    profile?: PresentationProfile;
+    issues: ProfileIssue[];
+}
+/** PRF-001 for one workspace profile file: id rules, no shadowing, schema, resolvable extends. */
+export declare function resolveWorkspaceProfile(file: WorkspaceProfileFile): ResolvedWorkspaceProfile;
+//# sourceMappingURL=profile.d.ts.map

package/dist/styles/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/styles/profile.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAC5B,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAChD,MAAM,MAAM,UAAU,GAClB,aAAa,GACb,SAAS,GACT,SAAS,GACT,OAAO,GACP,UAAU,GACV,UAAU,GACV,SAAS,GACT,UAAU,GACV,UAAU,CAAC;AACf,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,UAAU,GAAG,KAAK,CAAC;AAEjG,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACjC,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,uEAAuE;IACvE,KAAK,EAAE,OAAO,CAAC;IACf,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1F,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IACjE,0CAA0C;IAC1C,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,QAAQ,EAAE;QACR,cAAc,EAAE,KAAK,GAAG,QAAQ,CAAC;QACjC,aAAa,EAAE,KAAK,GAAG,QAAQ,CAAC;QAChC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;QACxC,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,OAAO,CAAC;QACrB,SAAS,EAAE,SAAS,GAAG,YAAY,CAAC;KACrC,CAAC;IACF,WAAW,EAAE;QACX,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;QACnC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;QACxB,QAAQ,EAAE,KAAK,CAAC;QAChB,6EAA6E;QAC7E,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;IACF,KAAK,EAAE;QAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAA;KAAE,CAAC;IAC7D,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5B,GAAG,EAAE;QAAE,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAClD,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AA2BD,0EAA0E;AAC1E,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA2GnD,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG;IAC7C,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAkRA;AAMD,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,oGAAoG;AACpG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAqC5D;AAID,4DAA4D;AAC5D,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAK5C;AA4BD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAwB9E;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,IAAI,mBAAmB,CAoD9C;AAED,MAAM,WAAW,oBAAoB;IACnC,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,kGAAkG;AAClG,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,GAAG,wBAAwB,CA4C5F"}