@yamlresume/core 0.4.0 → 0.4.2

package/dist/index.d.ts

@@ -21,20 +21,9 @@
  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
  * IN THE SOFTWARE.
  */
-/**
- * Defines the possible types for inline formatting marks.
- */
-declare enum MarkType {
-    bold = "bold",
-    italic = "italic",
-    underline = "underline",
-    link = "link"
-}
-/** Helper type to get the union of possible MarkType keys. */
-type MarkTypeOptions = keyof typeof MarkType;
 /** Represents a bold formatting mark. */
 type BoldMark = {
-    type: Extract<MarkTypeOptions, 'bold'>;
+    type: 'bold';
 };
 /** Represents a link mark with optional attributes. */
 type LinkMark = {
@@ -47,38 +36,25 @@ type LinkMark = {
         /** Link target attribute (e.g., '_blank'), often null or empty. */
         target: string;
     };
-    type: Extract<MarkTypeOptions, 'link'>;
+    type: 'link';
 };
 /** Represents an italic formatting mark. */
 type ItalicMark = {
-    type: Extract<MarkTypeOptions, 'italic'>;
+    type: 'italic';
 };
 /** Represents an underline formatting mark. */
 type UnderlineMark = {
-    type: Extract<MarkTypeOptions, 'underline'>;
+    type: 'underline';
 };
 /** Represents a union of all possible inline formatting marks. */
 type Mark = BoldMark | ItalicMark | LinkMark | UnderlineMark;
 /** Represents a sequence of child nodes, often used for block node content. */
 type Fragment = Node[] | undefined;
-/**
- * Defines the possible types for block or inline nodes in the document tree.
- */
-declare enum NodeType {
-    bulletList = "bulletList",
-    doc = "doc",
-    listItem = "listItem",
-    orderedList = "orderedList",
-    paragraph = "paragraph",
-    text = "text"
-}
-/** Helper type to get the union of possible NodeType keys. */
-type NodeTypeOptions = keyof typeof NodeType;
 /** Represents a bullet list node (unordered list). */
 type BulletListNode = {
     /** Child nodes (typically ListItemNode) contained within this list. */
     content?: Fragment;
-    type: Extract<NodeTypeOptions, 'bulletList'>;
+    type: 'bulletList';
     /** Optional attributes, typically only includes 'start' which defaults to 1
      * but isn't semantically used for bullet lists. */
     attrs?: {
@@ -90,19 +66,19 @@ type DocNode = {
     /** The top-level block nodes (like ParagraphNode, BulletListNode, etc.) of the
      * document. */
     content?: Fragment;
-    type: Extract<NodeTypeOptions, 'doc'>;
+    type: 'doc';
 };
 /** Represents an item within a list (either bullet or ordered). */
 type ListItemNode = {
     /** Child nodes (like ParagraphNode) contained within this list item. */
     content?: Fragment;
-    type: Extract<NodeTypeOptions, 'listItem'>;
+    type: 'listItem';
 };
 /** Represents an ordered list node. */
 type OrderedListNode = {
     /** Child nodes (typically ListItemNode) contained within this list. */
     content?: Fragment;
-    type: Extract<NodeTypeOptions, 'orderedList'>;
+    type: 'orderedList';
     /** Optional attributes for the list. */
     attrs?: {
         /** The starting number for the ordered list. */
@@ -113,7 +89,7 @@ type OrderedListNode = {
 type ParagraphNode = {
     /** Inline child nodes (like TextNode) contained within this paragraph. */
     content?: Fragment;
-    type: Extract<NodeTypeOptions, 'paragraph'>;
+    type: 'paragraph';
 };
 /** Represents a plain text node, with optional associated formatting marks. */
 type TextNode = {
@@ -122,9 +98,15 @@ type TextNode = {
     marks?: Mark[];
     /** The actual text content. */
     text: string;
-    type: Extract<NodeTypeOptions, 'text'>;
+    type: 'text';
 };
-/** Represents a union of all possible node types in the document tree. */
+/**
+ * Represents a union of all possible node types in the document tree.
+ *
+ * These node types are inspired by the Tiptap editor.
+ *
+ * @see {@link https://tiptap.dev/docs/editor/core-concepts/schema}
+ **/
 type Node = BulletListNode | DocNode | ListItemNode | OrderedListNode | ParagraphNode | TextNode;
 
 /**
@@ -279,63 +261,19 @@ interface Parser {
  */
 
 /**
- * This parser is used to parse the tiptap JSON format to the AST.
- *
- * Under the hood the implementation is pretty naive, it just parses the JSON
- * string to a DocNode because we use tiptap editor in frontend, so it is
- * guaranteed that the JSON stored by tiptap editor is valid as a tiptap
- * document.
- *
- * @see https://tiptap.dev/docs/editor/core-concepts/schema#parse
- */
-declare class TiptapParser implements Parser {
-    /**
-     * Parse a tiptap JSON string into an AST node.
-     *
-     * @param input - The tiptap JSON string to parse.
-     * @returns The parsed AST node.
-     */
-    parse(input: string): DocNode;
-}
-
-/**
- * MIT License
- *
- * Copyright (c) 2023–Present PPResume (https://ppresume.com)
- *
- * 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.
- */
-
-/**
- * Parse markdown to tiptap nodes
+ * Parse markdown to ast node
  *
  * Under the hood this class first parse the markdown to mdast and then
- * transform the mdast to tiptap nodes.
+ * transform the mdast to ast node.
  *
  * @see {@link Parser}
  */
 declare class MarkdownParser implements Parser {
     /**
-     * Parse markdown to tiptap nodes
+     * Parse markdown to ast node
      *
      * @param input - The markdown input to parse
-     * @returns The tiptap node
+     * @returns The ast node
      */
     parse(input: string): Node;
 }
@@ -364,285 +302,38 @@ declare class MarkdownParser implements Parser {
  * IN THE SOFTWARE.
  */
 /**
- * Represents all possible countries & regions.
- */
-declare enum Country {
-    Afghanistan = "Afghanistan",
-    AlandIslands = "Aland Islands",
-    Albania = "Albania",
-    Algeria = "Algeria",
-    AmericanSamoa = "American Samoa",
-    Andorra = "Andorra",
-    Angola = "Angola",
-    Anguilla = "Anguilla",
-    Antarctica = "Antarctica",
-    AntiguaAndBarbuda = "Antigua And Barbuda",
-    Argentina = "Argentina",
-    Armenia = "Armenia",
-    Aruba = "Aruba",
-    Australia = "Australia",
-    Austria = "Austria",
-    Azerbaijan = "Azerbaijan",
-    Bahrain = "Bahrain",
-    Bangladesh = "Bangladesh",
-    Barbados = "Barbados",
-    Belarus = "Belarus",
-    Belgium = "Belgium",
-    Belize = "Belize",
-    Benin = "Benin",
-    Bermuda = "Bermuda",
-    Bhutan = "Bhutan",
-    Bolivia = "Bolivia",
-    BonaireSintEustatiusAndSaba = "Bonaire, Sint Eustatius and Saba",
-    BosniaAndHerzegovina = "Bosnia and Herzegovina",
-    Botswana = "Botswana",
-    BouvetIsland = "Bouvet Island",
-    Brazil = "Brazil",
-    BritishIndianOceanTerritory = "British Indian Ocean Territory",
-    Brunei = "Brunei",
-    Bulgaria = "Bulgaria",
-    BurkinaFaso = "Burkina Faso",
-    Burundi = "Burundi",
-    Cambodia = "Cambodia",
-    Cameroon = "Cameroon",
-    Canada = "Canada",
-    CapeVerde = "Cape Verde",
-    CaymanIslands = "Cayman Islands",
-    CentralAfricanRepublic = "Central African Republic",
-    Chad = "Chad",
-    Chile = "Chile",
-    China = "China",
-    ChristmasIsland = "Christmas Island",
-    CocosKeelingIslands = "Cocos (Keeling) Islands",
-    Colombia = "Colombia",
-    Comoros = "Comoros",
-    Congo = "Congo",
-    CookIslands = "Cook Islands",
-    CostaRica = "Costa Rica",
-    CoteDIvoireIvoryCoast = "Cote D'Ivoire (Ivory Coast)",
-    Croatia = "Croatia",
-    Cuba = "Cuba",
-    Curaçao = "Cura\u00E7ao",
-    Cyprus = "Cyprus",
-    CzechRepublic = "Czech Republic",
-    DemocraticRepublicoftheCongo = "Democratic Republic of the Congo",
-    Denmark = "Denmark",
-    Djibouti = "Djibouti",
-    Dominica = "Dominica",
-    DominicanRepublic = "Dominican Republic",
-    EastTimor = "East Timor",
-    Ecuador = "Ecuador",
-    Egypt = "Egypt",
-    ElSalvador = "El Salvador",
-    EquatorialGuinea = "Equatorial Guinea",
-    Eritrea = "Eritrea",
-    Estonia = "Estonia",
-    Ethiopia = "Ethiopia",
-    FalklandIslands = "Falkland Islands",
-    FaroeIslands = "Faroe Islands",
-    FijiIslands = "Fiji Islands",
-    Finland = "Finland",
-    France = "France",
-    FrenchGuiana = "French Guiana",
-    FrenchPolynesia = "French Polynesia",
-    FrenchSouthernTerritories = "French Southern Territories",
-    Gabon = "Gabon",
-    GambiaThe = "Gambia The",
-    Georgia = "Georgia",
-    Germany = "Germany",
-    Ghana = "Ghana",
-    Gibraltar = "Gibraltar",
-    Greece = "Greece",
-    Greenland = "Greenland",
-    Grenada = "Grenada",
-    Guadeloupe = "Guadeloupe",
-    Guam = "Guam",
-    Guatemala = "Guatemala",
-    GuernseyAndAlderney = "Guernsey and Alderney",
-    Guinea = "Guinea",
-    GuineaBissau = "Guinea-Bissau",
-    Guyana = "Guyana",
-    Haiti = "Haiti",
-    HeardIslandAndMcDonaldIslands = "Heard Island and McDonald Islands",
-    Honduras = "Honduras",
-    HongKongSAR = "Hong Kong S.A.R.",
-    Hungary = "Hungary",
-    Iceland = "Iceland",
-    India = "India",
-    Indonesia = "Indonesia",
-    Iran = "Iran",
-    Iraq = "Iraq",
-    Ireland = "Ireland",
-    Israel = "Israel",
-    Italy = "Italy",
-    Jamaica = "Jamaica",
-    Japan = "Japan",
-    Jersey = "Jersey",
-    Jordan = "Jordan",
-    Kazakhstan = "Kazakhstan",
-    Kenya = "Kenya",
-    Kiribati = "Kiribati",
-    Kosovo = "Kosovo",
-    Kuwait = "Kuwait",
-    Kyrgyzstan = "Kyrgyzstan",
-    Laos = "Laos",
-    Latvia = "Latvia",
-    Lebanon = "Lebanon",
-    Lesotho = "Lesotho",
-    Liberia = "Liberia",
-    Libya = "Libya",
-    Liechtenstein = "Liechtenstein",
-    Lithuania = "Lithuania",
-    Luxembourg = "Luxembourg",
-    MacauSAR = "Macau S.A.R.",
-    Madagascar = "Madagascar",
-    Malawi = "Malawi",
-    Malaysia = "Malaysia",
-    Maldives = "Maldives",
-    Mali = "Mali",
-    Malta = "Malta",
-    ManIsleof = "Man (Isle of)",
-    MarshallIslands = "Marshall Islands",
-    Martinique = "Martinique",
-    Mauritania = "Mauritania",
-    Mauritius = "Mauritius",
-    Mayotte = "Mayotte",
-    Mexico = "Mexico",
-    Micronesia = "Micronesia",
-    Moldova = "Moldova",
-    Monaco = "Monaco",
-    Mongolia = "Mongolia",
-    Montenegro = "Montenegro",
-    Montserrat = "Montserrat",
-    Morocco = "Morocco",
-    Mozambique = "Mozambique",
-    Myanmar = "Myanmar",
-    Namibia = "Namibia",
-    Nauru = "Nauru",
-    Nepal = "Nepal",
-    Netherlands = "Netherlands",
-    NewCaledonia = "New Caledonia",
-    NewZealand = "New Zealand",
-    Nicaragua = "Nicaragua",
-    Niger = "Niger",
-    Nigeria = "Nigeria",
-    Niue = "Niue",
-    NorfolkIsland = "Norfolk Island",
-    NorthKorea = "North Korea",
-    NorthMacedonia = "North Macedonia",
-    NorthernMarianaIslands = "Northern Mariana Islands",
-    Norway = "Norway",
-    Oman = "Oman",
-    Pakistan = "Pakistan",
-    Palau = "Palau",
-    PalestinianTerritoryOccupied = "Palestinian Territory Occupied",
-    Panama = "Panama",
-    PapuanewGuinea = "Papua new Guinea",
-    Paraguay = "Paraguay",
-    Peru = "Peru",
-    Philippines = "Philippines",
-    PitcairnIsland = "Pitcairn Island",
-    Poland = "Poland",
-    Portugal = "Portugal",
-    PuertoRico = "Puerto Rico",
-    Qatar = "Qatar",
-    Reunion = "Reunion",
-    Romania = "Romania",
-    Russia = "Russia",
-    Rwanda = "Rwanda",
-    SaintHelena = "Saint Helena",
-    SaintKittsAndNevis = "Saint Kitts And Nevis",
-    SaintLucia = "Saint Lucia",
-    SaintPierreAndMiquelon = "Saint Pierre and Miquelon",
-    SaintVincentAndTheGrenadines = "Saint Vincent And The Grenadines",
-    SaintBarthelemy = "Saint-Barthelemy",
-    SaintMartinFrenchpart = "Saint-Martin (French part)",
-    Samoa = "Samoa",
-    SanMarino = "San Marino",
-    SaoTomeAndPrincipe = "Sao Tome and Principe",
-    SaudiArabia = "Saudi Arabia",
-    Senegal = "Senegal",
-    Serbia = "Serbia",
-    Seychelles = "Seychelles",
-    SierraLeone = "Sierra Leone",
-    Singapore = "Singapore",
-    SintMaartenDutchpart = "Sint Maarten (Dutch part)",
-    Slovakia = "Slovakia",
-    Slovenia = "Slovenia",
-    SolomonIslands = "Solomon Islands",
-    Somalia = "Somalia",
-    SouthAfrica = "South Africa",
-    SouthGeorgia = "South Georgia",
-    SouthKorea = "South Korea",
-    SouthSudan = "South Sudan",
-    Spain = "Spain",
-    SriLanka = "Sri Lanka",
-    Sudan = "Sudan",
-    Suriname = "Suriname",
-    SvalbardAndJanMayenIslands = "Svalbard And Jan Mayen Islands",
-    Swaziland = "Swaziland",
-    Sweden = "Sweden",
-    Switzerland = "Switzerland",
-    Syria = "Syria",
-    Taiwan = "Taiwan",
-    Tajikistan = "Tajikistan",
-    Tanzania = "Tanzania",
-    Thailand = "Thailand",
-    TheBahamas = "The Bahamas",
-    Togo = "Togo",
-    Tokelau = "Tokelau",
-    Tonga = "Tonga",
-    TrinidadAndTobago = "Trinidad And Tobago",
-    Tunisia = "Tunisia",
-    Turkey = "Turkey",
-    Turkmenistan = "Turkmenistan",
-    TurksAndCaicosIslands = "Turks And Caicos Islands",
-    Tuvalu = "Tuvalu",
-    Uganda = "Uganda",
-    Ukraine = "Ukraine",
-    UnitedArabEmirates = "United Arab Emirates",
-    UnitedKingdom = "United Kingdom",
-    UnitedStates = "United States",
-    UnitedStatesMinorOutlyingIslands = "United States Minor Outlying Islands",
-    Uruguay = "Uruguay",
-    Uzbekistan = "Uzbekistan",
-    Vanuatu = "Vanuatu",
-    VaticanCityStateHolySee = "Vatican City State (Holy See)",
-    Venezuela = "Venezuela",
-    Vietnam = "Vietnam",
-    VirginIslandsBritish = "Virgin Islands (British)",
-    VirginIslandsUS = "Virgin Islands (US)",
-    WallisAndFutunaIslands = "Wallis And Futuna Islands",
-    WesternSahara = "Western Sahara",
-    Yemen = "Yemen",
-    Zambia = "Zambia",
-    Zimbabwe = "Zimbabwe"
-}
+ * All possible countries and regions in the world.
+ */
+declare const COUNTRY_OPTIONS: readonly ["Afghanistan", "Aland Islands", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua And Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bonaire, Sint Eustatius and Saba", "Bosnia and Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "Brunei", "Bulgaria", "Burkina Faso", "Burundi", "Cambodia", "Cameroon", "Canada", "Cape Verde", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Christmas Island", "Cocos (Keeling) Islands", "Colombia", "Comoros", "Congo", "Cook Islands", "Costa Rica", "Cote D'Ivoire (Ivory Coast)", "Croatia", "Cuba", "Curaçao", "Cyprus", "Czech Republic", "Democratic Republic of the Congo", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "East Timor", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Ethiopia", "Falkland Islands", "Faroe Islands", "Fiji Islands", "Finland", "France", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Gambia The", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey and Alderney", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Heard Island and McDonald Islands", "Honduras", "Hong Kong S.A.R.", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kosovo", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macau S.A.R.", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Man (Isle of)", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia", "Moldova", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "North Korea", "North Macedonia", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Palestinian Territory Occupied", "Panama", "Papua new Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn Island", "Poland", "Portugal", "Puerto Rico", "Qatar", "Reunion", "Romania", "Russia", "Rwanda", "Saint Helena", "Saint Kitts And Nevis", "Saint Lucia", "Saint Pierre and Miquelon", "Saint Vincent And The Grenadines", "Saint-Barthelemy", "Saint-Martin (French part)", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Sint Maarten (Dutch part)", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Georgia", "South Korea", "South Sudan", "Spain", "Sri Lanka", "Sudan", "Suriname", "Svalbard And Jan Mayen Islands", "Swaziland", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "The Bahamas", "Togo", "Tokelau", "Tonga", "Trinidad And Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks And Caicos Islands", "Tuvalu", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "United States Minor Outlying Islands", "Uruguay", "Uzbekistan", "Vanuatu", "Vatican City State (Holy See)", "Venezuela", "Vietnam", "Virgin Islands (British)", "Virgin Islands (US)", "Wallis And Futuna Islands", "Western Sahara", "Yemen", "Zambia", "Zimbabwe"];
+/**
+ * Type for all possible countries and regions in the world.
+ */
+type Country = (typeof COUNTRY_OPTIONS)[number];
 /**
  * Represents all possible countries & regions with their corresponding English
  * names.
  */
-declare const englishCountryNames: Record<Country, string>;
+declare const EnglishCountryNames: Record<Country, string>;
 /**
  * Represents all possible countries & regions with their corresponding
  * Simplified Chinese names.
  */
-declare const simplifiedChineseCountryNames: Record<Country, string>;
+declare const SimplifiedChineseCountryNames: Record<Country, string>;
 /**
  * Represents all possible countries & regions with their corresponding
  * Traditional Chinese HK names.
  */
-declare const traditionalChineseCountryHKNames: Record<Country, string>;
+declare const TraditionalChineseCountryHKNames: Record<Country, string>;
 /**
  * Represents all possible countries & regions with their corresponding
  * Traditional Chinese TW names.
  */
-declare const traditionalChineseCountryTWNames: Record<Country, string>;
+declare const TraditionalChineseCountryTWNames: Record<Country, string>;
 /**
  * Represents all possible countries & regions with their corresponding
  * Spanish names.
  */
-declare const spanishCountryNames: Record<Country, string>;
+declare const SpanishCountryNames: Record<Country, string>;
 
 /**
  * MIT License
@@ -1133,18 +824,18 @@ type ResumeLayoutMargins = {
     /** Right margin value (e.g., "1.5cm"). */
     right: string;
 };
-/** Defines the available styles for rendering numbers in the font spec. */
-declare enum FontSpecNumbersStyle {
-    /** Standard lining figures (default for CJK languages). */
-    Lining = "Lining",
-    /** Old-style figures with varying heights (default for Latin languages). */
-    OldStyle = "OldStyle",
-    /**
-     * Represents an undefined state, allowing the style to be automatically
-     * determined based on the selected `LocaleLanguage`.
-     */
-    Auto = "Auto"
-}
+/** The options for the font spec numbers style. */
+declare const FONT_SPEC_NUMBERS_STYLE_OPTIONS: readonly ["Lining", "OldStyle", "Auto"];
+/**
+ * The type of font spec numbers style.
+ *
+ * - `Lining` - standard lining figures (default for CJK languages)
+ * - `OldStyle` - old style figures with varying heights (default for Latin
+ *   languages)
+ * - `Auto` - an undefined state, allowing the style to be automatically
+ *   determined based on the selected `LocaleLanguage`
+ */
+type FontSpecNumbersStyle = (typeof FONT_SPEC_NUMBERS_STYLE_OPTIONS)[number];
 /** Defines typography settings like font size and number style. */
 type ResumeLayoutTypography = {
     /** Base font size for the document (e.g., "10pt", "11pt"). */
@@ -1230,90 +921,44 @@ type Resume = {
  * IN THE SOFTWARE.
  */
 
-/** Represents a Tiptap editor JSON string for a single empty paragraph. */
-declare const emptyParagraph = "{\"type\":\"doc\",\"content\":[{\"type\":\"paragraph\"}]}";
-/** Defines standard academic degree types. */
-declare enum Degree {
-    MiddleSchool = "Middle School",
-    HighSchool = "High School",
-    Diploma = "Diploma",
-    Associate = "Associate",
-    Bachelor = "Bachelor",
-    Master = "Master",
-    Doctor = "Doctor"
-}
-/** An array containing all possible values from the `Degree` enum. */
-declare const degreeOptions: Degree[];
-/** Defines common world languages.
+/**
+ * Defines all possible degrees.
+ */
+declare const DEGREE_OPTIONS: readonly ["Middle School", "High School", "Diploma", "Associate", "Bachelor", "Master", "Doctor"];
+/**
+ * Type for all possible degrees.
+ */
+type Degree = (typeof DEGREE_OPTIONS)[number];
+/**
+ * Defines common world languages.
  *
  * This list contains the most used languages in the world.
  *
  * TODO: allow users to add their own languages
  */
-declare enum Language {
-    Arabic = "Arabic",
-    Bengali = "Bengali",
-    Bhojpuri = "Bhojpuri",
-    Cantonese = "Cantonese",
-    Chinese = "Chinese",
-    Dutch = "Dutch",
-    English = "English",
-    French = "French",
-    German = "German",
-    Gujarati = "Gujarati",
-    Hausa = "Hausa",
-    Hindi = "Hindi",
-    Indonesian = "Indonesian",
-    Italian = "Italian",
-    Japanese = "Japanese",
-    Javanese = "Javanese",
-    Korean = "Korean",
-    Marathi = "Marathi",
-    Mandarin = "Mandarin",
-    Portuguese = "Portuguese",
-    Russian = "Russian",
-    Spanish = "Spanish",
-    Tamil = "Tamil",
-    Turkish = "Turkish",
-    Urdu = "Urdu",
-    Vietnamese = "Vietnamese"
-}
-/** An array containing all possible values from the `Language` enum. */
-declare const languagesOptions: Language[];
-/** Defines levels of language proficiency.
- *
- * This list of options is coming from LinkedIn.
- */
-declare enum LanguageFluency {
-    ElementaryProficiency = "Elementary Proficiency",
-    LimitedWorkingProficiency = "Limited Working Proficiency",
-    MinimumProfessionalProficiency = "Minimum Professional Proficiency",
-    FullProfessionalProficiency = "Full Professional Proficiency",
-    NativeOrBilingualProficiency = "Native or Bilingual Proficiency"
-}
-/** An array containing all possible values from the `LanguageFluency` enum. */
-declare const languageFluenciesOptions: LanguageFluency[];
-/** Defines levels of skill proficiency. */
-declare enum SkillLevel {
-    Novice = "Novice",
-    Beginner = "Beginner",
-    Intermediate = "Intermediate",
-    Advanced = "Advanced",
-    Expert = "Expert",
-    Master = "Master"
-}
-/** An array containing all possible values from the `SkillLevel` enum. */
-declare const skillLevelOptions: SkillLevel[];
+declare const LANGUAGE_OPTIONS: readonly ["Afrikaans", "Albanian", "Amharic", "Arabic", "Azerbaijani", "Belarusian", "Bengali", "Bhojpuri", "Bulgarian", "Burmese", "Cantonese", "Catalan", "Chinese", "Croatian", "Czech", "Danish", "Dutch", "English", "Estonian", "Farsi", "Filipino", "Finnish", "French", "German", "Greek", "Gujarati", "Hausa", "Hebrew", "Hindi", "Hungarian", "Icelandic", "Igbo", "Indonesian", "Irish", "Italian", "Japanese", "Javanese", "Kazakh", "Khmer", "Korean", "Lahnda", "Latvian", "Lithuanian", "Malay", "Mandarin", "Marathi", "Nepali", "Norwegian", "Oromo", "Pashto", "Polish", "Portuguese", "Romanian", "Russian", "Serbian", "Shona", "Sinhala", "Slovak", "Slovene", "Somali", "Spanish", "Sundanese", "Swahili", "Swedish", "Tagalog", "Tamil", "Telugu", "Thai", "Turkish", "Ukrainian", "Urdu", "Uzbek", "Vietnamese", "Yoruba", "Zulu"];
+type Language = (typeof LANGUAGE_OPTIONS)[number];
+/**
+ * Defines language fluency levels.
+ *
+ * Based on the Interagency Language Roundtable (ILR) scale.
+ */
+declare const LANGUAGE_FLUENCIE_OPTIONS: readonly ["Elementary Proficiency", "Limited Working Proficiency", "Minimum Professional Proficiency", "Full Professional Proficiency", "Native or Bilingual Proficiency"];
+type LanguageFluency = (typeof LANGUAGE_FLUENCIE_OPTIONS)[number];
+/**
+ * Defines skill proficiency levels.
+ *
+ * Based on common industry standards for skill assessment.
+ */
+declare const SKILL_LEVEL_OPTIONS: readonly ["Novice", "Beginner", "Intermediate", "Advanced", "Expert", "Master"];
+type SkillLevel = (typeof SKILL_LEVEL_OPTIONS)[number];
 /** Defines identifiers for the available resume templates. */
-declare enum TemplateOption {
-    ModerncvBanking = "moderncv-banking",
-    ModerncvCasual = "moderncv-casual",
-    ModerncvClassic = "moderncv-classic"
-}
+declare const TEMPLATE_OPTIONS: readonly ["moderncv-banking", "moderncv-casual", "moderncv-classic"];
+type TemplateOption = (typeof TEMPLATE_OPTIONS)[number];
 declare function getTemplateOptionDetail(templateOption: TemplateOption): {
     name: string;
     description: string;
-    id: TemplateOption;
+    id: "moderncv-banking" | "moderncv-casual" | "moderncv-classic";
 };
 /** Provides default, empty item structures for each resume section type. */
 declare const resumeItems: ResumeItem;
@@ -1337,13 +982,9 @@ declare const marginOptions: string[];
  *
  * @see {@link https://en.wikipedia.org/wiki/IETF_language_tag}
  */
-declare enum LocaleLanguageOption {
-    English = "en",
-    SimplifiedChinese = "zh-hans",
-    TraditionalChineseHK = "zh-hant-hk",
-    TraditionalChineseTW = "zh-hant-tw",
-    Spanish = "es"
-}
+declare const LOCALE_LANGUAGE_OPTIONS: readonly ["en", "zh-hans", "zh-hant-hk", "zh-hant-tw", "es"];
+/** Type for all possible locale languages. */
+type LocaleLanguageOption = (typeof LOCALE_LANGUAGE_OPTIONS)[number];
 /**
  * Get the language code and name of the given locale language.
  *
@@ -1351,7 +992,7 @@ declare enum LocaleLanguageOption {
  * @returns The language code and name of the given locale language.
  */
 declare function getLocaleLanguageOptionDetail(localeLanguage: LocaleLanguageOption): {
-    localeLanguage: LocaleLanguageOption;
+    localeLanguage: "en" | "zh-hans" | "zh-hant-hk" | "zh-hant-tw" | "es";
     name: string;
 };
 /** Default layout configuration for a new resume. */
@@ -1677,9 +1318,11 @@ declare abstract class Renderer {
  * Get the appropriate resume renderer based on the provided resume.
  *
  * @param {Resume} resume - The resume object
+ * @param {Parser} summaryParser - The parser instance for the summary field.
+ * Default to `MarkdownParser` if not provided.
  * @returns {Renderer} The renderer instance for the specified template.
  */
-declare function getResumeRenderer(resume: Resume, summaryParser: Parser): Renderer;
+declare function getResumeRenderer(resume: Resume, summaryParser?: Parser): Renderer;
 
 /**
  * MIT License
@@ -1705,28 +1348,22 @@ declare function getResumeRenderer(resume: Resume, summaryParser: Parser): Rende
  * IN THE SOFTWARE.
  */
 
-/** Specific terms used within resume sections that require translation. */
-declare enum ResumeTerms {
-    /** The term for academic score or GPA. */
-    Score = "Score"
-}
 /** Defines the structure for translated terms for a single language. */
-type TermsTranslationValue = {
+type OptionTranslation = {
     /** Translations for degree types. */
-    education: Record<Degree, string>;
+    degrees: Record<Degree, string>;
     /** Translations for language names. */
     languages: Record<Language, string>;
     /** Translations for language fluency levels. */
     languageFluencies: Record<LanguageFluency, string>;
     /** Translations for country names. */
-    location: Record<Country, string>;
+    countries: Record<Country, string>;
     /** Translations for resume section titles. */
     sections: Record<SectionID, string>;
     /** Translations for skill proficiency levels. */
     skills: Record<SkillLevel, string>;
-    /** Translations for specific resume terms defined in `ResumeTerms`. */
-    terms: Record<ResumeTerms, string>;
 };
+type OptionCategory = keyof OptionTranslation;
 /**
  * Retrieves the translated terms for a specific locale language.
  *
@@ -1738,7 +1375,7 @@ type TermsTranslationValue = {
  * @returns An object containing the translated terms for the specified
  * language.
  */
-declare function getTermsTranslations(language?: LocaleLanguageOption): TermsTranslationValue;
+declare function getOptionTranslation<K extends OptionCategory>(language: LocaleLanguageOption, category: K, option: keyof OptionTranslation[K]): string;
 
 /**
  * MIT License
@@ -1765,28 +1402,19 @@ declare function getTermsTranslations(language?: LocaleLanguageOption): TermsTra
  */
 
 /** Specific punctuation types used for formatting within templates. */
-declare enum Punctuation {
-    /** Standard comma, often used between items in a sentence. */
-    Comma = "Comma",
-    /** Standard colon, often used before lists or details. */
-    Colon = "Colon",
-    /** Separator used specifically for lists of items (e.g., keywords, courses),
-     * which might differ from a standard comma in some languages. */
-    Separator = "Separator"
-}
+declare const PUNCTUATIONS: readonly ["comma", "colon", "separator"];
+/** The type of punctuation. */
+type Punctuation = (typeof PUNCTUATIONS)[number];
 /** Specific terms used within the template structure that need translation. */
-declare enum TemplateTerms {
-    /** The heading or label for a list of courses. */
-    Courses = "Courses",
-    /** The heading or label for a list of keywords. */
-    Keywords = "Keywords"
-}
+declare const TERMS: readonly ["courses", "keywords", "score"];
+/** The type of term. */
+type Term = (typeof TERMS)[number];
 /** The structure for template-specific translations (punctuations and terms) */
 type TemplateTranslationValue = {
     /** Translations for punctuation types defined in `Punctuation`. */
     punctuations: Record<Punctuation, string>;
-    /** Translations for template terms defined in `TemplateTerms`. */
-    terms: Record<TemplateTerms, string>;
+    /** Translations for template terms defined in `Term`. */
+    terms: Record<Term, string>;
 };
 /**
  * Retrieves template-specific translations (punctuations and terms) for a given
@@ -1846,7 +1474,7 @@ declare function localizeDate(date: string, language: LocaleLanguageOption | str
  * @param language - The language to localize the date string to.
  * @returns The date range.
  */
-declare function getDateRange(startDate: string, endDate: string, language: LocaleLanguageOption | string): string;
+declare function getDateRange(startDate: string, endDate: string, language: LocaleLanguageOption): string;
 /**
  * The number of seconds in one day
  */
@@ -1943,6 +1571,33 @@ declare function isEmptyValue(value: undefined | null | object | string): boolea
  * @returns The object with the specified keys removed
  */
 declare function removeKeysFromObject<T extends object>(obj: T, keysToRemove: (string | number | symbol)[]): T;
+/**
+ * Tree walker function to collect all possible keys from an object recursively
+ *
+ * This function traverses an object tree and collects all property keys at any
+ * depth.  It handles arrays, nested objects, and prevents infinite loops from
+ * circular references.
+ *
+ * @param obj - The object to walk through
+ * @param keys - Set to collect all keys (optional, used for recursion)
+ * @param visited - Set to track visited objects to prevent circular references
+ * (optional, used for recursion)
+ * @returns Set containing all keys found in the object tree
+ *
+ * @example
+ * ```typescript
+ * const obj = {
+ *   a: 1,
+ *   b: {
+ *     c: 2,
+ *     d: [{ e: 3 }]
+ *   }
+ * }
+ * const keys = collectAllKeys(obj)
+ * // keys will contain: Set(['a', 'b', 'c', 'd', 'e'])
+ * ```
+ */
+declare function collectAllKeys(obj: unknown, keys?: Set<string | number | symbol>, visited?: WeakSet<object>): Set<string | number | symbol>;
 
 /**
  * MIT License
@@ -1999,4 +1654,4 @@ declare function joinNonEmptyString(codes: string[], separator?: string): string
  */
 declare function toCodeBlock(code?: string, lang?: string): string;
 
-export { type Awards, type Basics, type BulletListNode, type Certificates, Country, Degree, type DocNode, type Education, ErrorType, FontSpecNumbersStyle, type Interests, Language, LanguageFluency, type LanguageItem, type Languages, LatexCodeGenerator, LocaleLanguageOption, type Location, MarkdownParser, type Node, type OrderedListNode, type ParagraphNode, type Parser, type ProfileItem, type Profiles, type Projects, type Publications, Punctuation, type References, type Resume, type ResumeContent, type ResumeItem, type ResumeLayout, ResumeTerms, SECTION_IDS, type SectionDefaultValues, type SectionID, SkillLevel, type Skills, type SocialNetwork, type SocialNetworkGroup, TemplateOption, TemplateTerms, type TextNode, TiptapParser, type Volunteer, type Work, YAMLResumeError, defaultResume, defaultResumeContent, defaultResumeLayout, degreeOptions, emptyParagraph, englishCountryNames, epochSecondsToLocaleDateString, escapeLatex, filledResume, filledResumeContent, fontSizeOptions, getDateRange, getLocaleLanguageOptionDetail, getResumeRenderer, getTemplateOptionDetail, getTemplateTranslations, getTermsTranslations, isEmptyString, isEmptyValue, joinNonEmptyString, languageFluenciesOptions, languagesOptions, localizeDate, marginOptions, milliSecondsToSeconds, nowInUTCSeconds, oneDay, parseDate, removeKeysFromObject, resumeItems, showIf, simplifiedChineseCountryNames, skillLevelOptions, spanishCountryNames, toCodeBlock, traditionalChineseCountryHKNames, traditionalChineseCountryTWNames, transformResume };
+export { type Awards, type Basics, type BulletListNode, type Certificates, type Country, DEGREE_OPTIONS, type Degree, type DocNode, type Education, EnglishCountryNames, ErrorType, FONT_SPEC_NUMBERS_STYLE_OPTIONS, type FontSpecNumbersStyle, type Interests, LANGUAGE_FLUENCIE_OPTIONS, LANGUAGE_OPTIONS, LOCALE_LANGUAGE_OPTIONS, type Language, type LanguageFluency, type LanguageItem, type Languages, LatexCodeGenerator, type LocaleLanguageOption, type Location, MarkdownParser, type Node, type OrderedListNode, PUNCTUATIONS, type ParagraphNode, type Parser, type ProfileItem, type Profiles, type Projects, type Publications, type Punctuation, type References, type Resume, type ResumeContent, type ResumeItem, type ResumeLayout, SECTION_IDS, SKILL_LEVEL_OPTIONS, type SectionDefaultValues, type SectionID, SimplifiedChineseCountryNames, type SkillLevel, type Skills, type SocialNetwork, type SocialNetworkGroup, SpanishCountryNames, TEMPLATE_OPTIONS, TERMS, type TemplateOption, type Term, type TextNode, TraditionalChineseCountryHKNames, TraditionalChineseCountryTWNames, type Volunteer, type Work, YAMLResumeError, collectAllKeys, defaultResume, defaultResumeContent, defaultResumeLayout, epochSecondsToLocaleDateString, escapeLatex, filledResume, filledResumeContent, fontSizeOptions, getDateRange, getLocaleLanguageOptionDetail, getOptionTranslation, getResumeRenderer, getTemplateOptionDetail, getTemplateTranslations, isEmptyString, isEmptyValue, joinNonEmptyString, localizeDate, marginOptions, milliSecondsToSeconds, nowInUTCSeconds, oneDay, parseDate, removeKeysFromObject, resumeItems, showIf, toCodeBlock, transformResume };