calliope-ts 0.0.2 → 0.0.4

package/src/types.ts

@@ -28,15 +28,35 @@ export interface ClsWord {
   lexicalDetails: string;             // additional morphological info (empty if none)
   lexicalPlural: boolean;             // true if plural
   position: string;                   // textual position (not always used)
-  word: string;                       // the surface form of the word
+  word: string;                       // the surface form of the word (case-normalised for lookups:
+                                      //   a sentence-initial capital is lowered unless proper noun)
+  displayWord?: string;               // the ORIGINAL surface form when it differs from `word`
+                                      //   (set by the parser's de-capitalisation) — what reports
+                                      //   and the phonopoetics show to the reader
   absoluteIndex: number;              // 0‑based index among all words in the text
   isContent: boolean; 
   // extended properties
   syllables: Syllable[];              // array of syllables for the word
   morphSuffix?: string;               // productive suffix split off for OOV stress (e.g. 'est'); guides display syllabification
+  morphPrefix?: string;               // productive prefix split off for OOV stress (e.g. 'dis'); guides display syllabification
   phraseStress: number;               // numeric phrase‑level stress after Nuclear Stress Rule
   dependency?: ClsDependency;         // back‑reference to dependency edge (if any)
   node?: ClsNode;                     // back‑reference to the constituent node (if any)
+  // ─── Calliope engine substrate (additive; ignored by the legacy/Clio path) ───
+  canonicalRel?: string;              // normalised Scenario relation (NOMD/AMOD/VPRT/DOBJ/IOBJ/OBL/…)
+  isPersonName?: boolean;             // token is in the `humannames` list (proper noun = person)
+  isPlaceName?: boolean;              // token is in the `cities-list` list (proper name = place)
+  // ─── Wagner/Krifka substrate (additive; 2026-06-29) ───
+  featsMap?: Record<string, string>; // UD morphological FEATS parsed from lexicalDetails
+                                      // (VerbForm/Voice/PronType/Number/Definite/Degree/Tense/…)
+  discourseGiven?: boolean;          // a content word repeated from an earlier line of the same
+                                      // stanza — set only by the optional stanza-givenness pass
+                                      // (analyzeStanzas / analyzeReadingDocument), never single-line
+  coordinateGiven?: boolean;         // a content word whose lemma is repeated as the HEAD of a
+                                      // coordinate structure within the same line ("young blood and
+                                      // high blood" → the second "blood" is anaphorically given;
+                                      // contrastive focus falls on the modifier "high"). Set by the
+                                      // relativiser's coordinate-givenness pre-pass.
 }
 
 /** A typed dependency edge between two words (as in Antelope’s XML) */
@@ -167,12 +187,27 @@ export interface PhonologicalScansionDetail {
                            // classical meter dominates; or per-line to refine a free-verse
                            // reading.  NOT a form verdict: "ballad" etc. belong to the
                            // rhyme-aware form layer (rhyme.ts).
-  rhyme?: {                // end-rhyme annotation (rhyme.ts), LYRICAL-compatible typology
+  metricalityNote?: string; // advisory prose-likeness hedge (scansion.ts), set when
+                           // a long, non-committal, weak-fit line reads as plausible
+                           // prose: "No consistent metered rhythm(s) discerned. …".
+                           // Display-only — never alters meter/scansion/certainty.
+  rhyme?: {                // rhyme annotation (rhyme.ts), LYRICAL-compatible typology.
+                           // Letters are assigned POEM-WIDE (a rhyme sound keeps its
+                           // letter across stanza breaks), in reading order.
     endWord: string;
-    letter: string;        // scheme letter 'A'/'B'/…, or '·' when unrhymed
+    letter: string;        // END-rhyme scheme letter 'A'/'B'/…, or '·' when unrhymed
     type?: string;         // perfect/rich/family/assonant/consonant/augmented/
                            // diminished/wrenched/eye/identical
-    matchedLine?: number;  // 0-based stanza line this one rhymes with
+    matchedLine?: number;  // 0-based poem line index this end-rhyme first binds to
+    internal?: {           // pre-caesural INTERNAL rhymes on this line (strong-tier
+                           // only), in left-to-right order; share the poem-wide
+                           // letter space with the end rhymes.
+      word: string;
+      letter: string;
+      type?: string;
+    }[];
+    notation?: string;     // assembled scheme cell: internal letters parenthesised
+                           // then the end letter — e.g. "(A)B", "(C)C", "A", "·".
   };
   formNote?: string;       // stanza/poem FORM verdict (rhyme-aware): "ballad stanza
                            // (ABCB, 4·3)", "blank verse", "Shakespearean Sonnet",

package/tests/DataForHayesLinesOnly.txt

@@ -0,0 +1,364 @@
+O, I am a bachelor, I live by myself
+And the only, only thing that I ever did was wrong
+I wooed her in the summer time
+And many, many times I held her in my arms
+One night she came to my bedside
+She threw her arms around my neck
+So all night long I held her in my arms
+Again I'm a bachelor, I live with my son
+And ev'ry ev'ry time I look into his eyes
+He reminds me of the summer time
+And the many, many times I held her in my arms
+O what should I spy but my own father's ship
+O what is the matter my daughter Jane
+I fear you have had some ill sickness
+O no! I've not had an ill sickness
+But I have been sick and sick to my heart
+Or is it by chance that reckish lad
+O no! It is not a noble noble knight
+If you will marry my daughter Jane
+This day you shall sup and dine with me
+O I will marry your daughter Jane
+And today I will sup and dine with you
+For I have houses and I have land
+And had it not been for your daughter Jane
+And downstairs ran this a-lady, O!
+One sang high and the other sang low
+And the other sang bonny, bonny Biscay, O!
+And put on hose of leather, O!
+The ragged, ragged rags about our door
+She's gone with the wraggle taggle gypsies, O!
+It was late last night when my lord came home
+Enquiring for his a-lady, O!
+O, saddle to me my milk-white steed
+Go and fetch me my pony, O!
+That I may ride and seek my bride
+Who is gone with the wraggle-taggle gypsies, O!
+O, he rode high and he rode low
+He rode through woods and copses, too
+Until he came to an open field
+And there he espied his a-lady, O!
+What makes you leave your house and land?
+What care I for my house and my land?
+What care I for my new wedded lord
+Last night you slept on a goose-feather bed
+With the sheet turned down so bravely, O!
+And tonight you'll sleep in a cold open field
+Along with the wraggle taggle gypsies, O!
+What care I for a goose-feather bed
+For tonight I shall sleep in a cold open field
+I'd just as soon be a beggar as a king
+A king cannot swagger, nor drink like a beggar
+Let the back and the sides go bare, my boys
+But give to the belly, boys, beer enough
+Sometimes we are lame, sometimes we are blind
+The keeper did a shooting go
+And under his coat he carried a bow
+All for to shoot at a merry little doe
+Hey down / ho down / derry derry down
+To my hey, down, down / To my ho, down, down
+The fourth doe she did cross the plain
+The keeper fetch'd her back again
+Where she is now she may remain
+The keeper fetch'd her back with his crook
+But he with his hounds did turn her again
+And it's there he did hunt in a merry, merry vein
+There was a farmer had three sons
+And he came home tight in the middle of the night
+The first he was a stout millard
+And the third to be sure was a little tailor
+The stout millard he stole the corn
+And the tailor went forth and he stole broadcloth
+And the devil ran away with the tailor one day
+Bold Nelson's praise I'm go-ing to sing
+(Not forgetting our glorious King)
+There was Sydney Smith and Duncan too
+Lord Howe and all the glorious crew
+They were the men that were true blue
+Full of care, yet I swear
+None with Nelson could compare
+Bold Buonaparte he threaten'd war
+A man who fear'd not wound nor scar
+Lord Nelson's actions made him quake
+And all French pow'rs he made to shake
+He said his king he'd ne'er forsake
+These last words Thus he spake
+Stand true my lads like hearts of oak
+Lord Nelson bold, though threaten'd wide
+And many a time he had been tried
+He fought like a hero till he died
+But the day was won, their line was broke
+While all around was lost in smoke
+And Nelson he got his death-stroke
+He faced his foe with his sword in hand
+I am a sailor stout and bold,
+I fight for my king and country too
+I travel'd the country through and through,
+If you should want to know my name,
+I've got permission from the King
+I said:  my dear, what will you do?
+Here's ale and wine and brandy too;
+Besides a pair of new silk shoes,
+The king's permission granted me
+From Bristol Town to Liverpool,
+And in whatever town I went,
+To court young maidens I was bent;
+And marry none was my intent,
+My man John, what can the matter be,
+She won't be my joy, my joy nor my dear
+And you will win the lady in the space of half a year;
+And she shall take a walk with you anywhere.
+O Madam, I will give to you a little greyhound,
+And ev'ry hair upon its back shall cost a thousand pound,
+O Sir, I won't accept of you a little greyhound,
+O Madam, I will give to you a fine iv'ry comb,
+To fasten up your silver locks when I am not at home,
+O Madam, I will give to you a cushion full of pins,
+O Madam, I will give to you the keys of my heart,
+To lock it up for ever that we never more shall part,
+O sir, I will accept of you the keys of your heart,
+There was a little man and he had a little wife
+And he loved her as dear as he loved his life
+Was just to put her lips to a little crabfish
+Then up her man arose and he girt him in his clothes,
+And down to the seaside he follow'd his nose
+O fisherman, O fisherman, O come and tell me
+Have you a little crabfish you can sell me?
+O yes, and O yes, I have one, two and three,
+And the best of them all I will sell to thee
+O wife put thy lips to this little crabfish
+Then the wife just to smell him popped up from the clothes,
+When up got the crabfish and nipp'd her by the nose.
+Hey man and ho man, come hither do ye hear?
+But the crabfish was ready and caught him by the ear.
+Come and I will sing to you.
+I will sing you one-ery
+Eleven and eleven are the keys of heaven,
+Nine are the nine that brightly shine,
+Seven are the seven stars in the sky,
+Five are the flamboys under the boat,
+And two and two are lily-white babes
+One and One is all alone,
+There was a star in David's land
+That a Princely Babe was born that night,
+If this be the truth, King Herod said,
+The roasted cock that lies in the dish
+O the cock soon thrustened and feathered well,
+And he did crow full senses three
+Oh! don't you see the turtle dove
+Sitting under the yonder tree
+Lamenting for her own true love?
+And I will mourn for thee, my dear,
+If you must suffer grief and pain,
+For, though I go away, I'll return again,
+If I row ten thousand mile, my dear,
+Ten thousand mile is very far
+With a heavy, heavy sigh and a bitter, bitter cry;
+No one to hear my moan, my dear,
+I may not stay your grievous moan,
+Yet I will love but thee alone;
+Till the streams run from the seas, my dear,
+The tides shall cease to beat the shore,
+Yet I will love thee more and more
+Until the day I die, my dear,
+Then let the seas run dry, sweetheart,
+Yet here I will stay, nor ever from thee part,
+Till all my days are done, my dear,
+There was an old fox and he had a loving wife
+And he went out one moonshiny night
+He swore the fattest should grease his beard,
+He took the grey goose by the neck,
+And as he went along she went, "Quack, quack,"
+Where he had little ones, eight, nine and ten,
+I placed my back against the old garden gate,
+To hear my true love sing, my boys,
+'Tis now very near three quarters of a year
+Since you and I together did stay."
+Come now my love and sit down by me,
+Since you and I together have been.
+I will not come and sit down by you
+Since you have been courting some other young girl
+O the Chesapeake so bold out of Boston she was towed
+To take an English frigate neat and handy, O;
+And the people all in port, they came out to see the sport,
+There was a lady near the town;
+She walked all night and all around,
+First she leant against an oak;
+First it bent and then it broke.
+Next she leaned against a thorn
+Two sweet little babes to her were born.
+She got a rope so long and neat,
+And tied them down both hands and feet.
+She got a knife so keen and sharp,
+And pierced it through each tender heart.
+She walked out one moonlit night;
+She saw her babes all dressed in white.
+Babes, O babes, if you were mine
+I'd dress you up in silk so fine.
+Mother, O Mother, when we were thine
+You neither dressed us coarse nor fine.
+In seven years you'll hear a bell,
+In seven years you'll land in hell.
+It was late in the night when the Squire came home
+His servant made a sure reply:
+O go catch up my milk-white steed,
+I'll ride all night till broad daylight,
+He rode and he rode till he came to the town,
+The tears came rolling down his cheeks
+It's come go back, my dearest dear,
+I won't go back, my dearest dear,
+For I wouldn't give a kiss from gipsum's lips
+It's go pull off those snow-white gloves
+And give to me your lily-white hand
+It's she pull�d off those snow-white gloves
+She soon ran through her gay clothing
+Her gold ring off her finger's gone,
+O once I had a house and land,
+But now I've come to an old straw pad
+There were three kings came from the West
+And they have taken a solemn oath
+They took a plow and plowed him in
+So there he lay for a full fortnight
+Then Barleycorn sprang up again
+There he remained till midsummer
+Then Barleycorn he got a beard
+And then poor Johnny Barleycorn
+O Barleycorn is the choicest grain
+It will do more than any grain
+There was a man lived in the West
+He married a wife--she was not of the best;
+She was Ruggleton's daughter of Iero.
+Said he, when he came in from plow:
+Ho!  Is my dinner ready now?
+O if your dinner you must have,
+Then get it yourself; I am not your slave,
+For I won't brew and I won't bake,
+And I won't make my white hands black,
+May the Heavens be your guide, my love
+Oh, the lad that you have sent to sea
+I'm married to the lad I love
+The King he wrote a long letter
+And sent it to my Lord Dunwaters
+The first two lines that he did read
+The next two lines Lord Dunwaters read
+He goes out to his stable groom
+There he espied a fair pretty maid
+'Twas eighteen hundred and twenty four
+We hoist our colors to the top of the mast
+And to Greenland bore away, brave boys
+A fine young man it was indeed
+He was mounted on his milk-white steed
+He rode, he rode, himself all alone
+Until he came to lovely Joan.
+It's of a man of Burningham town,
+And she did love bad company
+As dear as she loved her life, boys, life
+Mother, mother, make my bed
+And wrap me in a milk-white sheet
+And wrap me in a cloak of gold
+On Monday morning I married a wife
+Thinking to live and a sober life
+But as she turned out, I'd better been dead,
+The remarkable day that I was wed.
+When I was young I lived in a ha'
+Ye'd better be a maiden as a poor man's wife
+Ye'd better be a maiden a' the days of your life.
+Young Emma was a servant maid
+He plowed the main, much gold to gain
+For your cage shall be made of the very best of gold
+O where have you been roving, Henery my son?
+I've been roving for my sweetheart, mother, make my bed soon
+For I'm sick to my heart and I wants to lie down.
+A squire, a squire, he lived in the woods
+A little while and he pass�d a joke
+I'll do as much for my true love
+I'll sit and mourn all on her grave
+There was a youth and a well beloved youth
+He loved the bailiff's daughter dear
+It's of a farmer's daughter dear
+Yesterday was a high holiday
+And all the little school-fellows went out to play
+Come bridle me my milk-white steed
+And a strange hat on the stairs he found
+One Good Friday morning our ship set sail.
+There I espied a fair pretty lass
+With a comb and a brush in her hand, her hand, her hand,
+When the stormy winds did blow rough, rough,
+While we poor sailors are up and to the top
+And the landlubbers lying down below, below, below,
+My father bound me a prentice boy,
+In Cambridge town there lived a lass
+A young man came a-courting her,
+I promised her I'd marry her
+Instead of that I was content
+You virgins all, I pray draw near,
+It's of a Turkish lady brave
+Who fell in love with an English slave,
+As I walked out one midsummer morn
+Who should I see but my own true love
+The birds of love so sweetly sing
+There's none but her, but her alone
+The sweet month of May is now a-coming in
+And the trees are in full bloom and the birds are in full tune
+So the maidens and their sweethearts like lambkins they do play
+And welcome in young shepherd in the month of May
+In the month of May, in the month of May.
+O where are you going to, my pretty maid,
+With your red rosy cheek and your coal-black hair?
+For it's dabbling in the dew makes the milkmaids fair.
+With the trimming and the bobbings a-trailing on the ground.
+O madam, will you marry me, me, me,
+There's none but you I've often said
+Come write me down ye pow�rs above.
+The first I fancied was a young man's love.
+It is a jew�l all in my eyes
+And where my joy and comfort lies.
+Come change your ring with me, my love,
+It shall be a token of true love
+Come rise you English colors, love
+'Twas early in the month of May
+Down on the banks of daisy fair
+She did appear like Venus fair
+She was the neck and bosom fine
+So the greenest field shall be my bed
+A flow'ry pillow for my head,
+And the leaves which blow from tree to tree
+Shall be the covering over me.
+As I walked out one May morning
+Who should I spy but a fair pretty maid
+O Valentine's day comes but once a year.
+A pretty fair maid came to my bedside
+Come all young lovers, I pray draw near,
+Some shocking news you soon shall hear,
+And when the same to you I've told
+Shall make your very blood run cold.
+Jack Tar being sick and like to die,
+He had no place his head to lie,
+And all the people when they passed by
+And among them all was a rich young squire
+A brisk young lass so buck and gay,
+She went into the mill one day.
+From London town I went astray,
+'Twas in Oxford City I lost my way.
+The finest girl that I did meet
+She treated me with kisses sweet.
+He's up to the rigs, he's down to the rigs,
+He's up to the rigs of London town.
+As I was a-riding over the moor
+I saw the lawyer just before,
+O he is the valiant Turpin, O.
+Come all that's around me and listen awhile,
+I will sing you a ditty that will cause you to smile
+Concerning the wondrous sights I do declare,
+That you have all seen today at Bridgwater Fair.
+Our orders came on board, my boys,
+All for to cruise and never refuse
+From the Liverpool docks I bid adieu
+To Sally, Kate and Molly too,
+With our sails unfurled, our anchor weighed,
+We're bound for to plow the watery main.
+When I was young and in my prime
+They gave to me the very best corn
+The lady at the window high
+O lady gay, take pity I pray
+Where all young lads and swaggering blades