td-sequential 1.0.0__tar.gz

td_sequential-1.0.0/.gitignore

@@ -0,0 +1,5 @@
+__pycache__/
+*.egg-info/
+.pytest_cache/
+dist/
+.venv/

td_sequential-1.0.0/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 1.0.0 - 2026-10-28
+
+- First release: TD Setup, TD Countdown, TDST support and resistance levels, 13-versus-8 deferral, and the information-only perfection and price flip flags.
+- `compute(bars)` and `latest(result)`; optional `td_sequential.pandas.add_td_sequential(df)`.
+- Verified bar for bar against shared reference fixtures.

td_sequential-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moolish
+
+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.

td_sequential-1.0.0/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.5
+Name: td-sequential
+Version: 1.0.0
+Summary: TD Sequential indicator for Python: TD9 setup, countdown 13 and TDST levels on OHLC candles. Tested, zero dependencies.
+Project-URL: Homepage, https://moolish.com/tools/td-sequential-counter/
+Project-URL: Documentation, https://moolish.com/learn/td-sequential/
+Project-URL: Source, https://github.com/moolish-com/td-sequential-python
+Project-URL: Issues, https://github.com/moolish-com/td-sequential-python/issues
+Project-URL: Changelog, https://github.com/moolish-com/td-sequential-python/blob/main/CHANGELOG.md
+Author-email: Moolish <support@moolish.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: crypto,forex,indicator,ohlc,pandas,stocks,td-countdown,td-sequential,td-setup,td9,tdsequential,tdst,technical-analysis,tom-demark,trading
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Provides-Extra: pandas
+Requires-Dist: pandas>=1.5; extra == 'pandas'
+Provides-Extra: test
+Requires-Dist: pandas>=1.5; extra == 'test'
+Requires-Dist: pytest>=7; extra == 'test'
+Description-Content-Type: text/markdown
+
+# TD Sequential indicator for Python
+
+[![test](https://github.com/moolish-com/td-sequential-python/actions/workflows/test.yml/badge.svg)](https://github.com/moolish-com/td-sequential-python/actions/workflows/test.yml)
+[![PyPI](https://img.shields.io/pypi/v/td-sequential.svg)](https://pypi.org/project/td-sequential/)
+[![Python](https://img.shields.io/pypi/pyversions/td-sequential.svg)](https://pypi.org/project/td-sequential/)
+[![Downloads](https://img.shields.io/pypi/dm/td-sequential.svg)](https://pypi.org/project/td-sequential/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+`td-sequential` computes the TD Sequential indicator in Python on a list of OHLC candles: the TD Setup (the 1 to 9 count, often called TD9), the TD Countdown (1 to 13), the TDST support and resistance levels left by completed setups, and the information-only perfection and price flip flags. It works on crypto, stocks and forex candles of any timeframe, has no dependencies, supports Python 3.9 and later, and has an optional pandas helper.
+
+It follows the plain-English rules in [SPEC.md](SPEC.md) and matches the reference output bar for bar. The free [TD Sequential counter](https://moolish.com/tools/td-sequential-counter/) on moolish.com shows the current count on a crypto pair without installing anything.
+
+## Install
+
+```bash
+pip install td-sequential
+pip install "td-sequential[pandas]"   # optional DataFrame helper
+```
+
+## Usage
+
+```python
+from td_sequential import compute, latest
+
+# Closed bars only, oldest first. Drop the candle that is still forming.
+bars = [
+    {"t": 1750032000000, "o": 105594.02, "h": 108952.38, "l": 104980.37, "c": 106794.53},
+    # ...
+]
+
+result = compute(bars)   # one TdBar record per input bar
+now = latest(result)     # summary of the last bar
+
+last = result[-1]
+if last.buy_setup == 9:
+    print("TD Setup 9 (buy) on", last.t, "resistance", last.resistance)
+if last.sell_countdown == 13:
+    print("TD Countdown 13 (sell) completed on", last.t)
+```
+
+A bar can be a dict with keys `t, o, h, l, c` (the long names `time, open, high, low, close` also work), a `(t, o, h, l, c)` tuple, or any object with those attributes, for example a named tuple or a dataclass. Missing fields and non-numeric prices raise a clear `ValueError` or `TypeError` that names the bar.
+
+### pandas
+
+```python
+import pandas as pd
+from td_sequential.pandas import add_td_sequential
+
+df = pd.read_csv("btcusdt-1d.csv", index_col="time", parse_dates=True)  # open, high, low, close columns
+out = add_td_sequential(df)   # returns a copy with td_* columns added
+print(out[out["td_buy_setup"] == 9])
+```
+
+Column names are case-insensitive on input. Output columns carry the prefix `td_` (change it with `prefix=`). `td_resistance` and `td_support` are `NaN` when there is no active level.
+
+## Output fields
+
+`compute()` returns a list of frozen `TdBar` dataclasses, one per input bar, in input order.
+
+| Field | Type | Meaning |
+|---|---|---|
+| `t` | any | The bar's timestamp, copied from the input |
+| `buy_setup` | int | Buy TD Setup counter (0 or more; exactly 9 marks a setup 9) |
+| `sell_setup` | int | Sell TD Setup counter, same meaning |
+| `buy_countdown` | int | Signed buy countdown; 13 means just completed; 14 or more means no countdown in progress; negative means paused |
+| `sell_countdown` | int | Signed sell countdown, same meaning |
+| `resistance` | float or None | Price of the active latest TDST resistance level (plain highest high of the 9 setup bars) |
+| `support` | float or None | Price of the active latest TDST support level (plain lowest low of the 9 setup bars) |
+| `buy_deferred` | bool | The 13th buy countdown bar was held back by the 13-versus-8 test |
+| `sell_deferred` | bool | Same for the sell countdown |
+| `buy_perfected` | bool | Buy setup 9 whose bar 8 or 9 low is strictly below the lows of bars 6 and 7 (information only) |
+| `sell_perfected` | bool | Sell setup 9 whose bar 8 or 9 high is strictly above the highs of bars 6 and 7 (information only) |
+| `bullish_flip` | bool | Price flip: close crosses above the close 4 bars earlier after being below it (information only) |
+| `bearish_flip` | bool | The mirror price flip (information only) |
+
+The four information-only fields never change a setup, countdown or level value.
+
+`latest(result)` returns a `Latest` dataclass: the current setup counts, the countdown in progress per side (`CountdownState(count, paused)` or `None`), whether a 13 just completed, the time of the last completed setup 9 and countdown 13 per side, and the active resistance and support. It returns `None` for an empty result.
+
+## Rules in short
+
+- Setup: a bar counts when its close is lower (buy) or higher (sell) than the close 4 bars earlier. Any bar that does not qualify resets the counter to 0. Counting does not stop at 9.
+- Levels: a buy setup 9 records the highest high of its 9 bars as resistance, a sell setup 9 the lowest low as support (the "TDST levels", using the plain 9-bar high and low). A level is dropped when price closes beyond it or a whole bar sits beyond it.
+- Countdown: starts on the setup 9 bar; a bar counts when its close is at or beyond the low (buy) or high (sell) of the bar 2 bars earlier. It needs an active level, is cancelled by the opposite setup 9, and the 13th bar must pass the 13-versus-8 test.
+
+The full, unambiguous version is in [SPEC.md](SPEC.md).
+
+## Verified against reference data
+
+The test suite replays eight real candle histories (crypto pairs on 4-hour, daily and weekly timeframes, about 500 bars each) and requires every counting field to match the stored reference output on every bar. It also compares all twelve fields with the JavaScript implementation of the same rules on the same bars, and has unit cases for setup, levels, countdown, the 13-versus-8 deferral, perfection and price flips. Run it with `pip install -e ".[test]"` then `pytest`.
+
+## What is TD Sequential?
+
+TD Sequential is Tom DeMark's method for spotting a stretched run of closes. A TD Setup counts consecutive bars that close beyond the close four bars earlier, and a completed 9 can start a countdown that needs 13 qualifying bars. A 9 or a 13 describes past prices and gives no direction on its own; the [TD Sequential guide](https://moolish.com/learn/td-sequential/) explains the method, [TDST](https://moolish.com/learn/td-sequential/tdst/) and [perfected setups](https://moolish.com/learn/td-sequential/perfected-setup/).
+
+## Related
+
+- [td-sequential](https://github.com/moolish-com/td-sequential) - JavaScript and TypeScript (npm)
+- [td-sequential-pine-script](https://github.com/moolish-com/td-sequential-pine-script) - TradingView Pine Script v6
+- [td-sequential-screener](https://github.com/moolish-com/td-sequential-screener) - command-line screener
+- [Free TD Sequential counter](https://moolish.com/tools/td-sequential-counter/) - check a crypto pair in the browser
+
+## Attribution and disclaimer
+
+Moolish is not affiliated with, endorsed by or sponsored by Tom DeMark or DeMARK Analytics. TD Sequential is a method created by Tom DeMark, and DeMARK is a trademark of DeMARK Analytics.
+
+This is educational software, not financial advice. A count describes past prices; it is not a prediction.
+
+## Licence
+
+[MIT](LICENSE) - Copyright (c) 2026 Moolish

td_sequential-1.0.0/README.md

@@ -0,0 +1,111 @@
+# TD Sequential indicator for Python
+
+[![test](https://github.com/moolish-com/td-sequential-python/actions/workflows/test.yml/badge.svg)](https://github.com/moolish-com/td-sequential-python/actions/workflows/test.yml)
+[![PyPI](https://img.shields.io/pypi/v/td-sequential.svg)](https://pypi.org/project/td-sequential/)
+[![Python](https://img.shields.io/pypi/pyversions/td-sequential.svg)](https://pypi.org/project/td-sequential/)
+[![Downloads](https://img.shields.io/pypi/dm/td-sequential.svg)](https://pypi.org/project/td-sequential/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+`td-sequential` computes the TD Sequential indicator in Python on a list of OHLC candles: the TD Setup (the 1 to 9 count, often called TD9), the TD Countdown (1 to 13), the TDST support and resistance levels left by completed setups, and the information-only perfection and price flip flags. It works on crypto, stocks and forex candles of any timeframe, has no dependencies, supports Python 3.9 and later, and has an optional pandas helper.
+
+It follows the plain-English rules in [SPEC.md](SPEC.md) and matches the reference output bar for bar. The free [TD Sequential counter](https://moolish.com/tools/td-sequential-counter/) on moolish.com shows the current count on a crypto pair without installing anything.
+
+## Install
+
+```bash
+pip install td-sequential
+pip install "td-sequential[pandas]"   # optional DataFrame helper
+```
+
+## Usage
+
+```python
+from td_sequential import compute, latest
+
+# Closed bars only, oldest first. Drop the candle that is still forming.
+bars = [
+    {"t": 1750032000000, "o": 105594.02, "h": 108952.38, "l": 104980.37, "c": 106794.53},
+    # ...
+]
+
+result = compute(bars)   # one TdBar record per input bar
+now = latest(result)     # summary of the last bar
+
+last = result[-1]
+if last.buy_setup == 9:
+    print("TD Setup 9 (buy) on", last.t, "resistance", last.resistance)
+if last.sell_countdown == 13:
+    print("TD Countdown 13 (sell) completed on", last.t)
+```
+
+A bar can be a dict with keys `t, o, h, l, c` (the long names `time, open, high, low, close` also work), a `(t, o, h, l, c)` tuple, or any object with those attributes, for example a named tuple or a dataclass. Missing fields and non-numeric prices raise a clear `ValueError` or `TypeError` that names the bar.
+
+### pandas
+
+```python
+import pandas as pd
+from td_sequential.pandas import add_td_sequential
+
+df = pd.read_csv("btcusdt-1d.csv", index_col="time", parse_dates=True)  # open, high, low, close columns
+out = add_td_sequential(df)   # returns a copy with td_* columns added
+print(out[out["td_buy_setup"] == 9])
+```
+
+Column names are case-insensitive on input. Output columns carry the prefix `td_` (change it with `prefix=`). `td_resistance` and `td_support` are `NaN` when there is no active level.
+
+## Output fields
+
+`compute()` returns a list of frozen `TdBar` dataclasses, one per input bar, in input order.
+
+| Field | Type | Meaning |
+|---|---|---|
+| `t` | any | The bar's timestamp, copied from the input |
+| `buy_setup` | int | Buy TD Setup counter (0 or more; exactly 9 marks a setup 9) |
+| `sell_setup` | int | Sell TD Setup counter, same meaning |
+| `buy_countdown` | int | Signed buy countdown; 13 means just completed; 14 or more means no countdown in progress; negative means paused |
+| `sell_countdown` | int | Signed sell countdown, same meaning |
+| `resistance` | float or None | Price of the active latest TDST resistance level (plain highest high of the 9 setup bars) |
+| `support` | float or None | Price of the active latest TDST support level (plain lowest low of the 9 setup bars) |
+| `buy_deferred` | bool | The 13th buy countdown bar was held back by the 13-versus-8 test |
+| `sell_deferred` | bool | Same for the sell countdown |
+| `buy_perfected` | bool | Buy setup 9 whose bar 8 or 9 low is strictly below the lows of bars 6 and 7 (information only) |
+| `sell_perfected` | bool | Sell setup 9 whose bar 8 or 9 high is strictly above the highs of bars 6 and 7 (information only) |
+| `bullish_flip` | bool | Price flip: close crosses above the close 4 bars earlier after being below it (information only) |
+| `bearish_flip` | bool | The mirror price flip (information only) |
+
+The four information-only fields never change a setup, countdown or level value.
+
+`latest(result)` returns a `Latest` dataclass: the current setup counts, the countdown in progress per side (`CountdownState(count, paused)` or `None`), whether a 13 just completed, the time of the last completed setup 9 and countdown 13 per side, and the active resistance and support. It returns `None` for an empty result.
+
+## Rules in short
+
+- Setup: a bar counts when its close is lower (buy) or higher (sell) than the close 4 bars earlier. Any bar that does not qualify resets the counter to 0. Counting does not stop at 9.
+- Levels: a buy setup 9 records the highest high of its 9 bars as resistance, a sell setup 9 the lowest low as support (the "TDST levels", using the plain 9-bar high and low). A level is dropped when price closes beyond it or a whole bar sits beyond it.
+- Countdown: starts on the setup 9 bar; a bar counts when its close is at or beyond the low (buy) or high (sell) of the bar 2 bars earlier. It needs an active level, is cancelled by the opposite setup 9, and the 13th bar must pass the 13-versus-8 test.
+
+The full, unambiguous version is in [SPEC.md](SPEC.md).
+
+## Verified against reference data
+
+The test suite replays eight real candle histories (crypto pairs on 4-hour, daily and weekly timeframes, about 500 bars each) and requires every counting field to match the stored reference output on every bar. It also compares all twelve fields with the JavaScript implementation of the same rules on the same bars, and has unit cases for setup, levels, countdown, the 13-versus-8 deferral, perfection and price flips. Run it with `pip install -e ".[test]"` then `pytest`.
+
+## What is TD Sequential?
+
+TD Sequential is Tom DeMark's method for spotting a stretched run of closes. A TD Setup counts consecutive bars that close beyond the close four bars earlier, and a completed 9 can start a countdown that needs 13 qualifying bars. A 9 or a 13 describes past prices and gives no direction on its own; the [TD Sequential guide](https://moolish.com/learn/td-sequential/) explains the method, [TDST](https://moolish.com/learn/td-sequential/tdst/) and [perfected setups](https://moolish.com/learn/td-sequential/perfected-setup/).
+
+## Related
+
+- [td-sequential](https://github.com/moolish-com/td-sequential) - JavaScript and TypeScript (npm)
+- [td-sequential-pine-script](https://github.com/moolish-com/td-sequential-pine-script) - TradingView Pine Script v6
+- [td-sequential-screener](https://github.com/moolish-com/td-sequential-screener) - command-line screener
+- [Free TD Sequential counter](https://moolish.com/tools/td-sequential-counter/) - check a crypto pair in the browser
+
+## Attribution and disclaimer
+
+Moolish is not affiliated with, endorsed by or sponsored by Tom DeMark or DeMARK Analytics. TD Sequential is a method created by Tom DeMark, and DeMARK is a trademark of DeMARK Analytics.
+
+This is educational software, not financial advice. A count describes past prices; it is not a prediction.
+
+## Licence
+
+[MIT](LICENSE) - Copyright (c) 2026 Moolish

td_sequential-1.0.0/SPEC.md

@@ -0,0 +1,198 @@
+# TD Sequential counting rules (plain-English spec)
+
+This document describes, in words, how to count the two TD Sequential phases
+(Setup and Countdown) and the two price levels that go with them. It is detailed
+enough to implement without seeing any other source, and an implementation that
+follows it matches the reference output bar for bar on the shared test cases.
+
+TD Sequential is a method published by Tom DeMark. This is an independent
+description of one concrete, fully specified variant of it, not DeMark's text.
+
+Not included: TD Combo, risk levels, and the "true high / true low"
+variants of the support and resistance levels. Nothing here is trading advice.
+
+## Input
+
+- An ordered list of bars, oldest first, each with open, high, low, close and a
+  timestamp. Only closed bars are used. If the last bar is still forming, drop it
+  before counting.
+- Bars are consecutive on the chosen timeframe. Gaps are not filled and are not
+  special: the rules look at "previous bar", "4 bars earlier" and "2 bars earlier"
+  in list order.
+- Counting starts from the first bar of the list with empty history. Everything
+  below is evaluated once per bar, in list order, and the bar's result depends
+  only on that bar and the state left by earlier bars.
+- Open prices and volume are never used.
+
+## 1. Setup
+
+Two independent counters run side by side: a buy setup and a sell setup.
+
+For each bar, compare its close with the close of the bar 4 bars earlier
+(the bar whose position is current minus 4).
+
+- Buy setup: the bar qualifies if close is strictly lower than that close.
+- Sell setup: the bar qualifies if close is strictly higher than that close.
+- If the list has fewer than 4 earlier bars, the bar does not qualify.
+- A bar with equal closes qualifies for neither counter.
+
+Counter update for each side:
+
+- If the bar qualifies, the counter becomes previous value plus 1.
+- If it does not qualify, the counter becomes 0.
+- No price flip is needed to start a count: a counter simply starts at 1 on the
+  first qualifying bar after a reset.
+
+What happens after 9 (this is the standard configuration; the optional
+"continuation" mode is off):
+
+- The counter is not capped and does not restart. If the run continues the next
+  values are 10, 11, 12, and so on, until a bar fails to qualify and the counter
+  drops to 0.
+- A "setup 9" is the bar on which the counter equals exactly 9. It happens once
+  per run. Values of 10 and above are not a new setup 9.
+- (If continuation mode were on, the bar after 9 would restart at 1 instead of
+  10. It is not part of this spec; implementations use the behaviour above.)
+
+Because the two comparisons are opposite, at most one of the two counters is
+non-zero on a bar.
+
+The earliest possible setup 9 is the 13th bar of the list (4 bars of history,
+then 9 qualifying bars).
+
+## 2. Support and resistance levels
+
+Levels are created by a completed setup 9 and are tracked until price breaks
+them. Buy and sell levels are kept in two separate lists.
+
+Creation, evaluated on every bar before anything else that uses levels:
+
+- On a buy setup 9: add a resistance level at the highest high of the latest 9
+  bars, including the current bar.
+- On a sell setup 9: add a support level at the lowest low of the latest 9 bars,
+  including the current bar.
+- A level is not added if its price is not above zero, or if a still-active
+  level in the same list already has exactly the same price.
+- A new level becomes the "latest" level of its list, and any previous level
+  stops being the latest one.
+- Each list keeps at most 20 levels. When a 21st is added, the oldest is dropped.
+
+Breaking, evaluated on every bar right after creation, for every active level:
+
+- A resistance level is broken when the bar's close is above the price, or the
+  bar's low is above the price (the whole bar sits above it).
+- A support level is broken when the bar's close is below the price, or the
+  bar's high is below the price (the whole bar sits below it).
+- A broken level becomes inactive for good. A level touched without being broken
+  (price pokes through and closes back) stays active; touches are counted by the
+  reference but do not change any output described here, so they are not part of
+  the contract.
+
+Active level reported per bar:
+
+- Resistance: the price of the latest resistance level if it is still active,
+  otherwise null.
+- Support: the price of the latest support level if it is still active,
+  otherwise null.
+- Only the latest level is reported. If the latest level has been broken, the
+  value is null even when an older level in the list is still active.
+- Before any setup 9 has completed, both are null.
+
+## 3. Countdown
+
+Two countdowns run side by side. The buy countdown belongs to buy setup 9 and
+needs an active resistance level. The sell countdown belongs to sell setup 9 and
+needs an active support level.
+
+Each countdown holds a signed integer, starting at 0. Its absolute value is the
+number of qualifying bars counted so far. A negative sign means "this bar did
+not qualify, the count is paused at that value". Zero has no sign.
+
+Qualifying bar:
+
+- Buy countdown: the bar's close is lower than or equal to the low of the bar 2
+  bars earlier.
+- Sell countdown: the bar's close is higher than or equal to the high of the bar
+  2 bars earlier.
+- With fewer than 2 earlier bars, a bar does not qualify.
+- Qualifying bars need not be consecutive. They are not required to be below the
+  previous close or to follow any particular pattern; just this one comparison.
+
+Per-bar update, for one countdown (own = its own setup, other = the opposite
+setup). Check the cases in this order and stop at the first that applies:
+
+1. Own setup 9 completes on this bar: the value becomes 1 if the bar qualifies,
+   otherwise 0. This starts the countdown on the setup-9 bar itself, and also
+   restarts any countdown that was already running.
+2. Otherwise, if the opposite setup completes its 9 on this bar, or the level this
+   countdown needs (resistance for buy, support for sell) is not active: the value
+   becomes 14. This is the cancellation state.
+3. Otherwise, if the previous value has absolute value 12 and the bar qualifies and
+   the 13-versus-8 test fails (see below): the value becomes -12 and the bar is
+   flagged as deferred.
+4. Otherwise, if the bar qualifies: the value becomes the absolute value of the
+   previous value plus 1.
+5. Otherwise: the value becomes the negative of the absolute value of the previous
+   value (zero stays zero).
+
+13-versus-8 test (only used when the previous absolute value is 12):
+
+- The close of the bar on which the countdown reached exactly 8 is remembered.
+  (Only a transition to a positive 8 counts; the remembered close is overwritten
+  each time a countdown reaches 8.)
+- Buy countdown: the 13th qualifying bar is accepted only if its low is lower
+  than or equal to that remembered close. If its low is higher, the bar is
+  deferred.
+- Sell countdown: accepted only if its high is higher than or equal to that
+  remembered close. If its high is lower, the bar is deferred.
+- A deferred bar leaves the value at -12 (rule 3). The following bars repeat the
+  same test, so the countdown completes on the first later qualifying bar that
+  passes the test. While waiting, non-qualifying bars also keep -12.
+
+Completion and what the numbers mean:
+
+- A value of exactly 13 means the countdown has just completed on this bar. It
+  is the only way a 13 appears.
+- The rules do not stop at 13. If the level is still active and no opposite 9
+  occurs, the next qualifying bar produces 14, then 15, and so on, with negative
+  values on non-qualifying bars. Treat any absolute value of 14 or more as "no
+  countdown in progress": it is the cancellation state, or an already finished
+  countdown, and it carries no further meaning.
+- Cancellation (rule 2) therefore comes from two causes: the opposite setup 9, or
+  loss of the needed level (it was broken, or no level was ever created). The
+  value stays at 14 as long as the level is missing, which is why every bar of a
+  fresh list shows 14 until a setup 9 and its level exist.
+- A new own setup 9 (rule 1) always overrides a cancelled or finished state and
+  restarts the countdown.
+
+## 4. Output contract
+
+One record per input bar, in input order:
+
+| field | type | meaning |
+|---|---|---|
+| t | integer | the bar's timestamp, copied from the input |
+| buySetup | integer | buy setup counter (0 or more; exactly 9 marks a setup 9) |
+| sellSetup | integer | sell setup counter, same meaning |
+| buyCountdown | integer | signed buy countdown value; 13 means just completed; 14 or more means no countdown in progress |
+| sellCountdown | integer | signed sell countdown value, same meaning |
+| resistance | number or null | price of the active latest resistance level |
+| support | number or null | price of the active latest support level |
+| buyDeferred | boolean | true on a bar where the buy countdown was held at -12 by the 13-versus-8 test |
+| sellDeferred | boolean | same for the sell countdown |
+| buyPerfected | boolean | true only on a buy setup 9 bar whose bar 8 or bar 9 low is strictly below both the bar 6 low and the bar 7 low (bars numbered 1 to 9 within the setup) |
+| sellPerfected | boolean | true only on a sell setup 9 bar whose bar 8 or bar 9 high is strictly above both the bar 6 high and the bar 7 high |
+| bullishFlip | boolean | true when the previous bar closed below the close 4 bars before it and this bar closes above the close 4 bars earlier (needs 5 earlier bars) |
+| bearishFlip | boolean | the mirror: previous close above its 4-bars-earlier close, this close below its 4-bars-earlier close |
+
+The four fields above are information only. They never change a setup, countdown or level value, and a setup does not need a flip to start.
+
+Notes for implementers:
+
+- Prices are compared as plain floating-point numbers with no rounding.
+- A bar where the countdown is cancelled or restarted is reported with that
+  bar's own result; there is no look-ahead and results never change when later
+  bars arrive.
+- Counting from a different starting bar can change early results (a run that
+  began before the first bar is invisible). Compare implementations only on the
+  same bar list, started from the same first bar.

td_sequential-1.0.0/pyproject.toml

@@ -0,0 +1,54 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "td-sequential"
+version = "1.0.0"
+description = "TD Sequential indicator for Python: TD9 setup, countdown 13 and TDST levels on OHLC candles. Tested, zero dependencies."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Moolish", email = "support@moolish.com" }]
+keywords = [
+  "td-sequential", "tdsequential", "td9", "td-setup", "td-countdown", "tdst", "tom-demark",
+  "technical-analysis", "indicator", "trading", "crypto", "stocks", "forex", "ohlc", "pandas",
+]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Intended Audience :: Financial and Insurance Industry",
+  "Intended Audience :: Developers",
+  "Topic :: Office/Business :: Financial :: Investment",
+  "Topic :: Scientific/Engineering :: Information Analysis",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Operating System :: OS Independent",
+  "Typing :: Typed",
+]
+dependencies = []
+
+[project.optional-dependencies]
+pandas = ["pandas>=1.5"]
+test = ["pytest>=7", "pandas>=1.5"]
+
+[project.urls]
+Homepage = "https://moolish.com/tools/td-sequential-counter/"
+Documentation = "https://moolish.com/learn/td-sequential/"
+Source = "https://github.com/moolish-com/td-sequential-python"
+Issues = "https://github.com/moolish-com/td-sequential-python/issues"
+Changelog = "https://github.com/moolish-com/td-sequential-python/blob/main/CHANGELOG.md"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/td_sequential"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src", "tests", "SPEC.md", "README.md", "CHANGELOG.md", "LICENSE"]
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]

td_sequential-1.0.0/src/td_sequential/__init__.py

@@ -0,0 +1,6 @@
+"""TD Sequential indicator for Python: TD9 setup, countdown 13 and TDST levels."""
+
+from .core import CountdownState, Latest, TdBar, compute, latest
+
+__version__ = "1.0.0"
+__all__ = ["CountdownState", "Latest", "TdBar", "compute", "latest", "__version__"]