%D \module
%D   [       file=page-brk,   % moved from page-ini
%D        version=2011.12.07, % 2000.10.20,
%D          title=\CONTEXT\ Page Macros,
%D       subtitle=Breaks,
%D         author=Hans Hagen,
%D           date=\currentdate,
%D      copyright={PRAGMA ADE \& \CONTEXT\ Development Team}]
%C
%C This module is part of the \CONTEXT\ macro||package and is
%C therefore copyrighted by \PRAGMA. See mreadme.pdf for
%C details.

\writestatus{loading}{ConTeXt Page Macros / Breaks}

\unprotect

\ifdefined\resetcurrentstructuremarkswithpage \else \let\resetcurrentstructuremarkswithpage\relax \fi
\ifdefined\noheaderandfooterlines             \else \let\noheaderandfooterlines            \relax \fi

%D Page breaks.

% \definepagebreak
%   [chapter]
%   [yes,header,right]
%
% \setuphead
%   [chapter]
%   [page=chapter,
%    header=empty,
%    footer=chapter]
%
% \definepagebreak % untested
%   [lastpage]
%   [left,{empty,right},{empty,left}]

% public page handler, beware: definepage already in use (core-ref)
%
% \definepagebreak[instance][forsure]
% \definepagebreak[forsure][yes,+4]

\newconditional\c_page_breaks_enabled   \c_page_breaks_enabled\conditionaltrue
\newinteger    \c_page_breaks_prevpage

\newtoks\everybeforepagebreak
\newtoks\everyafterpagebreak

\lettonothing\page_breaks_current_option
\lettonothing\page_breaks_current_options

\installcorenamespace{pagebreakmethod}
\installcorenamespace{pagebreaks}

\def\page_breaks_handle#1%
  {\edef\page_breaks_current_options{#1}% handy for tracing
   \processcommacommand[\page_breaks_current_options]\page_breaks_handle_step}

\def\page_breaks_handle_step#1%
  {\edef\page_breaks_current_option{#1}% can be used in handler
   \ifcsname\??pagebreakmethod\page_breaks_current_option\endcsname
     \lastnamedcs
   \orelse\ifcsname\??pagebreaks\page_breaks_current_option\endcsname
     \expandafter\page_breaks_handle\lastnamedcs
   \else
     \page_breaks_unknown
   \fi}

\def\page_breaks_handle_direct#1%
  {\begincsname\??pagebreakmethod#1\endcsname}

\permanent\protected\def\installpagebreakmethod#1#2% low level definer
  {\defcsname\??pagebreakmethod#1\endcsname{#2}}

\aliased\let\installpagebreakhandler\installpagebreakmethod % will go

\permanent\tolerant\protected\def\definepagebreak[#1]#*[#2]%
  {\defcsname\??pagebreaks#1\endcsname{#2}}

\appendtoks
    \flushnotes
\to \everybeforepagebreak

\permanent\tolerant\protected\def\pagebreak[#1]
  {\par % else no vertical penalties, always before group so that we clear hangs etc (as in side floats)
   \ifvmode % extra check
     \begingroup
     \expand\everybeforepagebreak
     \c_page_breaks_prevpage\realpageno
     \ifcase\pageornamentstate \or
       % disable reset after shipout
       \global\pageornamentstate\plustwo
     \fi
     % maybe \ifempty{#1}%
     \ifparameter#1\or
       \page_breaks_handle{#1}%
     \else % so, no pagebreak when \pagebreak[] ! ! !
       \page_breaks_handle_direct\v!yes
     \fi
     \relax
     \ifnum\c_page_breaks_prevpage<\realpageno
       \global\pageornamentstate\zerocount
     \fi
     \expand\everyafterpagebreak
     \endgroup
   \fi}

\aliased\let\page\pagebreak

\lettonothing\m_page_breaks_asked

\permanent\protected\def\usepageparameter#1%
  {\edef\m_page_breaks_asked{#1\c!page}%
   \ifempty\m_page_breaks_asked\else
     \pagebreak[\m_page_breaks_asked]%
   \fi}

\permanent\protected\def\dousepageparameter#1%
  {\edef\m_page_breaks_asked{#1}%
   \ifempty\m_spac_align_asked\else
     \pagebreak[\m_page_breaks_asked]%
   \fi}

\permanent\protected\def\resetpagebreak % used elsewhere too
  {\global\c_page_breaks_enabled\conditionaltrue}

\permanent\protected\def\simplifypagebreak % to be used grouped !
  {\enforced\permanent\protected\def\pagebreak[##1]{\goodbreak}}

\permanent\protected\def\disablepagebreaks % to be used grouped !
  {\enforced\let\pagebreak\gobbleoneoptional}

\installpagebreakmethod \s!dummy
  {\page_otr_command_flush_all_floats
   \page_otr_command_next_page
   \page_otr_insert_dummy_page}

\installpagebreakmethod \v!frame
  {\page
   \begingroup
   \showframe
   \page[\v!empty]
   \endgroup}

\protected\def\page_breaks_unknown % how often called ?
  {\ifhastok+\page_breaks_current_option
     \page_otr_command_flush_all_floats
     \page_otr_command_next_page
     \dorecurse\page_breaks_current_option\page_otr_insert_dummy_page
   \orelse\ifchknum\page_breaks_current_option\or
      \page_otr_command_flush_all_floats
      \page_otr_command_next_page
%       \localcontrolledrepeating
      \localcontrolledendless
        {\ifnum\userpageno<\page_breaks_current_option\relax
           \page_otr_insert_dummy_page
         \else
           \quitloop
         \fi}%
   \fi}

\installpagebreakmethod \s!unknown
  {\page_breaks_unknown}

\installpagebreakmethod \s!default
  {} % do nothing if empty

\installpagebreakmethod \v!reset
  {% better not: \global\pageornamentstate\zerocount
   \resetpagebreak}

\installpagebreakmethod \v!disable
  {\global\c_page_breaks_enabled\conditionalfalse}

\installpagebreakmethod \v!yes
  {\ifconditional\c_page_breaks_enabled
     \page_otr_command_flush_all_floats
     \page_otr_command_next_page
     \ifinsidecolumns       % this will move to MUL
       \page_otr_eject_page % otherwise sometimes no change
     \fi
   \fi}

\installpagebreakmethod \v!makeup
  {\ifconditional\c_page_breaks_enabled
     \page_otr_fill_and_eject_page
   \fi}

\installpagebreakmethod \v!blank
  {\ifcase\pageornamentstate
     \global\pageornamentstate\plusone
   \fi}

% also needed: \page \doifoddpageelse\relax{\page[\v!blank,\v!right]

\installpagebreakmethod \v!no
  {\ifconditional\c_page_breaks_enabled
     \dosomebreak\nobreak
   \fi}

\installpagebreakmethod \v!preference
  {\ifconditional\c_page_breaks_enabled
     \ifinsidecolumns % this will move to MUL
       \dosomebreak\goodbreak
     \else
       \testpage[3][\zeropoint]%
     \fi
   \fi}

\installpagebreakmethod \v!bigpreference
  {\ifconditional\c_page_breaks_enabled
     \ifinsidecolumns % this will move to MUL
       \dosomebreak\goodbreak
     \else
       \testpage[5][\zeropoint]%
     \fi
   \fi}

% \installpagebreakmethod \v!empty {} % defined in page-txt.mkiv
% \installpagebreakmethod \v!header{} % defined in page-txt.mkiv
% \installpagebreakmethod \v!footer{} % defined in page-txt.mkiv

\def\page_reset_marks_and_insert_dummy
  {\resetcurrentstructuremarkswithpage\page_otr_insert_dummy_page}

\installpagebreakmethod \v!left
  {\page_otr_command_flush_all_floats
   \page_otr_command_next_page_and_inserts
   \doifbothsidesoverruled\donothing\page_reset_marks_and_insert_dummy\donothing}

\installpagebreakmethod \v!right
  {\page_otr_command_flush_all_floats
   \page_otr_command_next_page_and_inserts
   \doifbothsidesoverruled\donothing\donothing\page_reset_marks_and_insert_dummy}

\installpagebreakmethod \v!even
  {\page
   \doifelseoddpage\page_reset_marks_and_insert_dummy\donothing}

\installpagebreakmethod \v!odd
  {\page
   \doifelseoddpage\donothing\page_reset_marks_and_insert_dummy}

\installpagebreakmethod \v!quadruple % not yet ok inside columnsets
  {\ifdoublesided
     \ifcase{\realpageno;\plusfour}\else
       \page_breaks_handle_direct\v!yes
%        \localcontrolledrepeating
       \localcontrolledendless
         {\ifcase{\realpageno;\plusfour}%
            \quitloop
          \else
            \page_breaks_handle_direct\v!empty
          \fi}%
     \fi
   \fi}

\installpagebreakmethod \v!last
  {\page_otr_command_flush_all_floats
   \page_otr_command_next_page_and_inserts
   \relax
   \doifbothsidesoverruled
     \page_facings_flush % hm
     \donothing
     {\noheaderandfooterlines
      \page_otr_insert_dummy_page}%
   \filluparrangedpages}

\installpagebreakmethod \v!lastpage % handy for backpage preceded by empty pages
  {\page_breaks_handle_direct\v!yes
   \ifdoublesided
     \page_breaks_handle_direct\v!left
     \page_breaks_handle_direct\v!empty
     \page_breaks_handle_direct\v!empty
   \fi}

\installpagebreakmethod \v!start {\global\c_otr_shipout_enabled\conditionaltrue}
\installpagebreakmethod \v!stop  {\global\c_otr_shipout_enabled\conditionalfalse}

\installpagebreakmethod{xy}% for Mojca
  {\page_breaks_handle_direct\v!yes
   \scratchcounterone  {(\rootlayouttargetparameter\c!nx)*(\rootlayouttargetparameter\c!ny)}%
  %\scratchcountertwo  \luaexpr{math.mod(\the\realpageno-1,\the\scratchcounterone)}\relax
   \scratchcountertwo  {(\realpageno-1):\scratchcounterone}%
   \scratchcounterthree{\scratchcounterone-\scratchcountertwo}%
   \dorecurse\scratchcounterthree{\page_breaks_handle_direct\v!empty}}

% Column breaks.

\installcorenamespace{columnbreakmethod}
\installcorenamespace{columnbreaks}

\newtoks\everybeforecolumnbreak
\newtoks\everyaftercolumnbreak
\newtoks\everysynchronizecolumn

\lettonothing\page_breaks_columns_current_option
\lettonothing\page_breaks_columns_current_options

\def\page_breaks_columns_handle#1%
  {\edef\page_breaks_columns_current_options{#1}%
   \processcommacommand[#1]\page_breaks_columns_handle_step}

\def\page_breaks_columns_handle_step#1%
  {\edef\page_breaks_columns_current_option{#1}%
   \ifcsname\??columnbreakmethod\currentoutputroutine:\page_breaks_columns_current_option\endcsname
     \lastnamedcs
   \orelse\ifcsname\??columnbreaks\page_breaks_columns_current_option\endcsname
    %\expandafter\csname\page_breaks_columns_handle\??columnbreaks\page_breaks_columns_current_option\endcsname
     \lastnamedcs
   \orelse\ifcsname\??columnbreakmethod\currentoutputroutine:\s!unknown\endcsname
     \lastnamedcs
   \fi}

\def\page_breaks_columns_handle_direct#1%
  {\begincsname\??columnbreakmethod\currentoutputroutine:#1\endcsname}

\permanent\protected\def\installcolumnbreakmethod#1#2#3% #1=otr-id #2=tag #3=action
  {\defcsname\??columnbreakmethod#1:#2\endcsname{#3}}

\aliased\let\installcolumnbreakhandler\installcolumnbreakmethod % will go

\permanent\tolerant\protected\def\definecolumnbreak[#1]#*[#2]%
  {\defcsname\??columnbreaks#1\endcsname{#2}}

%D So, page ornaments are reset after a pagebreak command, unless set!

\permanent\tolerant\protected\def\columnbreak[#1]%
  {\par % else no vertical penalties
   \begingroup
   \expand\everybeforecolumnbreak
   \ifparameter#1\or
     \page_breaks_columns_handle{#1}%
   \else
     \page_breaks_columns_handle_direct\v!yes
   \fi
   \relax
   \expand\everyaftercolumnbreak
   \endgroup
   % outside group e.g. setting hsize
   \expand\everysynchronizecolumn}

\aliased\let\column\columnbreak

\appendtoks
    \page_otr_command_set_hsize
\to \everysynchronizecolumn

%D Test page breaks.

% \newdimension\d_page_tests_test
% \newconstant \c_page_tests_mode

\newconstant\testpagemethod  % old
\newconstant\testpagetrigger % old

\installcorenamespace {pagechecker}
\installcorenamespace {pagecheckermethod}

\installcommandhandler \??pagechecker {pagechecker} \??pagechecker

\setuppagechecker
  [\c!method=1,
   \c!before=,
   \c!after=,
   \c!inbetween=,
   \c!lines=\plusthree,
   \c!offset=\zeropoint]

% \def\page_check_amount
%   {(\pagecheckerparameter\c!lines\lineheight)%
%    +\pagetotal
%     \ifdim\lastskip<\parskip+\parskip\fi
%    +(\pagecheckerparameter\c!offset)}

% \permanent\tolerant\protected\def\checkpage[#1]#*[#2]%
%   {\relax % look ahead prevention
%    \endgraf
%   %\triggerpagebuilder
%    \checkspacingbeforepar
%    \relax
%    \ifconditional\c_page_breaks_enabled
%      \begingroup
%      \cdef\currentpagechecker{#1}%
%      \setupcurrentpagechecker[#2]%
%      \csname\??pagecheckermethod\pagecheckerparameter\c!method\endcsname
%      \endgroup
%    \fi}

\def\page_check_amount
  {(\pagecheckerparameter\c!lines\lineheight)%
   +\d_spac_total
   +(\pagecheckerparameter\c!offset)}

\permanent\tolerant\protected\def\checkpage[#1]#*[#2]%
  {\relax % look ahead prevention
   \endgraf
  %\triggerpagebuilder
  %\checkspacingbeforepar
   \checkspacingavailable
   \relax
   \ifconditional\c_page_breaks_enabled
     \begingroup
     \cdef\currentpagechecker{#1}%
     \setupcurrentpagechecker[#2]%
     \csname\??pagecheckermethod\pagecheckerparameter\c!method\endcsname
     \endgroup
   \fi}

\defcsname\??pagecheckermethod 0\endcsname
  {\ifdim\pagegoal<\maxdimen \relax
     \ifdim\pagetotal<\pagegoal \relax
       \ifdim{\page_check_amount}>.99\pagegoal
         \pagecheckerparameter\c!before
         \penalty-\plustenthousand
         \pagecheckerparameter\c!after
       \else
         \pagecheckerparameter\c!inbetween
       \fi
     \else
       \pagecheckerparameter\c!inbetween
     \fi
   \else
     \pagecheckerparameter\c!inbetween
   \fi}

\defcsname\??pagecheckermethod 1\endcsname
  {\ifdim\pagegoal<\maxdimen \relax
     \ifdim\pagetotal<\pagegoal \relax
       \ifdim{\page_check_amount-\pagegoal}>-\lineheight
         \pagecheckerparameter\c!before
         \penalty-\plustenthousand
         \pagecheckerparameter\c!after
       \else
         \pagecheckerparameter\c!inbetween
       \fi
     \else
%          \penalty-\plustenthousand
       \pagecheckerparameter\c!inbetween
     \fi
   \else
     \goodbreak
     \pagecheckerparameter\c!inbetween
   \fi}

\defcsname\??pagecheckermethod 2\endcsname
  {\ifdim\pagegoal<\maxdimen \relax
     \ifdim\pagetotal<\pagegoal \relax
       \getnoflines\pagegoal
       \ifdim{\page_check_amount-\noflines\lineheight}>-\lineheight
         \pagecheckerparameter\c!before
         \penalty-\plustenthousand
         \pagecheckerparameter\c!after
       \else
         \pagecheckerparameter\c!inbetween
       \fi
     \else
%          \penalty-\plustenthousand
       \pagecheckerparameter\c!inbetween
     \fi
   \else
     \pagecheckerparameter\c!inbetween
   \fi}

\defcsname\??pagecheckermethod 3\endcsname
  {\ifdim\pagegoal<\maxdimen \relax
     \ifdim\pagetotal<\pagegoal \relax
       \ifdim{\page_check_amount-10\scaledpoint}>\pagegoal
         \pagecheckerparameter\c!before
         \penalty-\plustenthousand
         \pagecheckerparameter\c!after
       \else
         \pagecheckerparameter\c!inbetween
       \fi
     \orelse\ifdim\pagetotal>\pagegoal
       \ifdim{\pagetotal-\pageshrink}>\pagegoal
         \goodbreak
         \pagecheckerparameter\c!inbetween
       \else
         \pagecheckerparameter\c!before
         \page
         \pagecheckerparameter\c!after
       \fi
     \else
       \pagecheckerparameter\c!inbetween
     \fi
   \else
     \pagecheckerparameter\c!inbetween
   \fi}

% \defcsname\??pagecheckermethod 4\endcsname % needs testing
%   {\ifdim\pagegoal<\maxdimen \relax
%      \ifdim\pagelastheight<\pagegoal \relax
%        \ifdim{\page_check_amount-\pagegoal}>-\lineheight
%          \pagecheckerparameter\c!before
%          \penalty-\plustenthousand
%          \pagecheckerparameter\c!after
%        \else
%          \pagecheckerparameter\c!inbetween
%        \fi
%      \else
%        \pagecheckerparameter\c!inbetween
%      \fi
%    \else
%      \goodbreak
%      \pagecheckerparameter\c!inbetween
%    \fi}

\definepagechecker[\s!unknown:0]              [\c!method=0,\c!before=,\c!after=,\c!inbetween=]
\definepagechecker[\s!unknown:1][\s!unknown:0][\c!method=1]
\definepagechecker[\s!unknown:2][\s!unknown:0][\c!method=2]
\definepagechecker[\s!unknown:3][\s!unknown:0][\c!method=3]
%definepagechecker[\s!unknown:4][\s!unknown:0][\c!method=4]

% the \relax prevents premature expansion in case of lookahead

\permanent\tolerant\protected\def\testpage    [#1]#*[#2]{\relax\expanded{\checkpage[\s!unknown:1][\c!lines=#1,\c!offset=\ifparameter#2\or#2\else\zeropoint\fi]}} %
\permanent\tolerant\protected\def\testpageonly[#1]#*[#2]{\relax\expanded{\checkpage[\s!unknown:2][\c!lines=#1,\c!offset=\ifparameter#2\or#2\else\zeropoint\fi]}} % no penalties added to the mvl
\permanent\tolerant\protected\def\testpagesync[#1]#*[#2]{\relax\expanded{\checkpage[\s!unknown:3][\c!lines=#1,\c!offset=\ifparameter#2\or#2\else\zeropoint\fi]}} % force sync

%D Test column breaks.

\permanent\tolerant\protected\def\testcolumn[#1]#*[#2]%
  {\relax % look ahead prevention
   \ifdefined\page_otr_command_test_column
     \ifparameter#2\or
        \page_otr_command_test_column[#1][#2]%
     \else
        \page_otr_command_test_column[#1][\zeropoint]%
     \fi
   \fi}

%D Experiment:

\permanent\protected\def\setpagelooseness[#1]%
  {\begingroup
   \ifchkdimension#1\lineheight\or
     \additionalpageskip
       \lastchkdimension
     \relax
   \else
     \letdummyparameter\c!lines  \zerocount
     \letdummyparameter\c!height \zeropoint
     \letdummyparameter\c!stretch\zeropoint
     \letdummyparameter\c!shrink \zeropoint
     \getdummyparameters[#1]%
     \additionalpageskip\dimexpr
        (\dummyparameter\c!height)+\lineheight*(\dummyparameter\c!lines)%
     \relax
        \s!plus \dummyparameter\c!stretch
        \s!minus\dummyparameter\c!shrink
     \relax
   \fi
   \endgroup}

\protect \endinput